# Перенос информации о повторяемых оплатах и токенах платёжных карт {#ru_gate_data_migration} статья о возможности переносить в платформу Ecommpay информацию о повторяемых оплатах и токенах платёжных карт от других эквайеров **На уровень выше:**[Дополнительные возможности](ru_Gate_Additional_capabilities.md) ## Общая информация {#ru_gate_data_migration_overview} В некоторых случаях для мерчанта может быть актуальным проводить через Ecommpay платежи с использованием платёжных данных, сохранённых ранее в сервисах других эквайеров. Для таких ситуаций в платёжной платформе Ecommpay поддерживаются различные возможности: - Переносить и использовать информацию о повторяемых оплатах \(как регулярных, так и нерегулярных\) и о токенах платёжных карт. Эта возможность описана в данной статье. - Проводить повторяемые оплаты, зарегистрированные в сервисах других провайдеров, без переноса информации о них в платформу. Для подключения и использования этой возможности необходимо обращаться к курирующему менеджеру Ecommpay. Перенос информации о повторяемых оплатах и токенах карт может быть предпочтителен в случаях, когда планируется использовать токены платёжных карт, совмещать использование платёжной платформы Ecommpay и сервисов других эквайеров, а также в случаях, когда требуется обеспечить автоматические списания в рамках повторяемых оплат. Такой перенос сведений не облагается комиссиями со стороны Ecommpay, но может облагаться комиссиями со стороны эквайера, передающего целевую информацию, и возможен только при поддержке с его стороны и при соблюдении ряда условий \(подробнее — далее\).С вопросами об организации такого переноса, как и с вопросами о возможности переноса информации в обратном направлении, от Ecommpay к другим эквайерам, можно обращаться к курирующему менеджеру Ecommpay. В целях обеспечения конфиденциальности информации её следует переносить в зашифрованном виде. Как правило, при переносе данных в платформу Ecommpay используется алгоритм шифрования PGP \(Pretty Good Privacy\), но в некоторых случаях по согласованию со специалистами Ecommpay могут применяться и другие способы \(например, если на стороне эквайера, передающего информацию, не поддерживается PGP-шифрование\). Для переноса информации файл с ней должен быть зашифрован на стороне текущего эквайера, от которого выполняется перенос, с использованием открытого ключа от Ecommpay \(в случае PGP-шифрования\), а затем передан специалистам Ecommpay. Контактную информацию ответственных специалистов можно получить у курирующего менеджера Ecommpay. После того, как вся необходимая информация перенесена в платёжную платформу Ecommpay и её корректность подтверждена со стороны мерчанта, с целевыми повторяемыми оплатами и токенами можно выполнять любые действия, доступные в платформе: списания в рамках повторяемых оплат \([подробнее](ru_Gate__cof_merchant_side.md)\) и управление этими списаниями \([подробнее](ru_gate_payment_recurring_manage.md)\), оплаты и выплаты по токенам \([подробнее](ru_Gate_Token.md)\), проверку действительности карт \([подробнее](ru_gate_account_verification.md)\) и так далее. При этом всю информацию об операциях, выполненных через платёжную платформу Ecommpay с использованием перенесённых сведений, можно получать через интерфейс Dashboard\(в разделе **Платежи**, с информацией обо всех платежах, и в разделе **Подписки**, с информацией о регулярных оплатах\), а также [Data API](ru_dbl_api_protocol.md) и Gate API. **Прим.:** Стоит учитывать, что для выполнения каких-либо действий с перенесённой информацией должны использоваться новые идентификаторы, зафиксированные в платформе Ecommpay: - токены карт, указываемые в параметре `token`, - идентификаторы платежей, указываемые в параметре `payment_id`, - идентификаторы серий списаний, указываемые в параметре `id` объекта `recurring`. Эти идентификаторы включаются в сверочный файл, отправляемый специалистам мерчанта для проверки и согласования корректности перенесённой информации, и все они применимы только в паре с идентификатором проекта \(`project_id`\), к которому изначально отнесены. ## Условия и ограничения {#ru_gate_data_migration_restrictions} При переносе информации необходимо учитывать условия и ограничения, которые выдвигаются с двух сторон: эквайером, предоставляющим информацию, и Ecommpay, принимающим её в платформу. Со стороны Ecommpay это следующие условия и ограничения: - Переносимая информация может относиться только к картам платёжных систем American Express,Mastercard и Visa. Для работы по картам других платёжных систем следует формировать токены и регистрировать повторяемые оплаты непосредственно в платформе, используя поддерживаемые для этого способы. - Перенос допускается только напрямую от других эквайеров. При работе через посредников следует оговаривать с ними возможности взаимодействия непосредственно с эквайерами. - Перенос возможен только в рамках рабочих проектов взаимодействия с платёжной платформой Ecommpay. Если мерчант ещё не является клиентом Ecommpay, то с его стороны следует отправить [заявку](https://ecommpay.com/sign-up/) на подключение к платформе и решить последующие вопросы. - Ответственность за актуальность и корректность перенесённой информации возлагается на мерчанта. После переноса специалистам мерчанта направляется сверочный файл, и если специалисты мерчанта подтверждают корректность информации в этом файле, то эта информация признаётся рабочей и ответственность за любые негативные последствия \(например, оформление опротестования из-за списания средств не с того пользователя\) возлагается на мерчанта. - Ответственность за отсутствие двойных списаний возлагается на мерчанта. Перед началом переноса специалисты Ecommpay согласовывают со специалистами мерчанта дату начала проведения платежей с использованием полученной информации. Чтобы избежать двойных списаний \(через двух эквайеров\), со стороны мерчанта следует обеспечить к указанной дате завершение всех операций с использованием переносимой информации через прежнего эквайера. ## Порядок переноса {#ru_gate_data_migration_workflow} Перенос информации о повторяемых оплатах и токенах осуществляется по зашифрованному каналу связи, который настраивается в рамках взаимодействия специалистов Ecommpay и текущего эквайера, передающего информацию. Сроки такого переноса, как правило, составляют не более недели для токенов и не более двух недель для повторяемых оплат. Эти сроки зависят от различных факторов, в том числе от того, требуется ли вместе с основными параметрами переносить дополнительные, и согласовываются непосредственно в процессе взаимодействия всех сторон. В случаях, когда информация о токенах переносится раньше и необходима для проведения платежей уже до переноса информации о повторяемых оплатах, можно согласовывать её более раннее применение со специалистами Ecommpay. В общем случае со стороны мерчанта следует: 1. Согласовать возможность и условия переноса с эквайером, от которого актуально перенести целевую информацию. 2. Сообщить курирующему менеджеру Ecommpay о желании перенести информацию и согласовать с ним сроки переноса и дату начала проведения платежей с использованием перенесённой информации. В случае, если мерчант ещё не входит в число клиентов Ecommpay, предварительно следует отправить [заявку](https://ecommpay.com/sign-up/) на подключение и решить последующие вопросы. 3. Согласовать со специалистами Ecommpay следующее: - Проекты, для которых актуален перенос информации. Если необходимо перенести информацию для нескольких проектов в платформе Ecommpay, то перенос осуществляется для каждого проекта отдельно. - Состав параметров, которые следует перенести в платёжную платформу Ecommpay. Это могут быть только основные параметры, описанные [далее](ru_gate_data_migration.md#) и переносимые в обязательном порядке, или, если актуально, основные вместе с выбранными дополнительными \(из числа поддерживаемых в платформе\). - Если необходимо перенести информацию о повторяемых оплатах — идентификаторы, которые следует присвоить этим оплатам\(в качестве значений параметра `scheduled_payment_id`\), а также записям о сериях списаний в рамках этих оплат\(в качестве значений параметра `register_payment_id`\). Это могут быть значения в формате, используемом по умолчанию \(`Ecommpay–yyyymmddnnn`\), или в форматах, заданных мерчантом \(с ограничением в 255 символов\). - Состав параметров, которые следует использовать для проверки специалистами мерчанта того, что целевая информация перенесена в платформу корректно и может использоваться при проведении платежей. В число этих параметров обязательно включаются новые идентификаторы \(`token` и `recurring_id`\), параметры из числа основных, отмеченные далее как required for verification, и, если актуально, дополнительные параметры из числа перенесённых. - Контактную информацию ответственных специалистов мерчанта, эквайера, от которого необходимо получить информацию, и Ecommpay— для организации взаимодействия и решения актуальных вопросов, в том числе по согласованию корректности перенесённой информации. 4. В случае, если не обеспечивается прямое взаимодействие между специалистами текущего эквайера и Ecommpay, получить от эквайера зашифрованный файл и направить его ответственным специалистам, чью контактную информацию можно получить у курирующего менеджера Ecommpay. Как правило, перенос данных в платформу Ecommpay выполняется с помощью алгоритма шифрования PGP \(Pretty Good Privacy\) и открытого ключа от Ecommpay, но в некоторых случаях по согласованию со специалистами Ecommpay могут применяться и другие способы. ``` -----BEGIN PGP PUBLIC KEY BLOCK----- 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 =jMHf -----END PGP PUBLIC KEY BLOCK----- ``` 5. При получении от специалистов Ecommpay по указанному адресу электронной почты сверочного файла проверить полноту и корректность информации в нём. **Прим.:** В сверочный файл включается информация по всем согласованным параметрам, при этом сам файл передаётся в формате CSV, а пароль для доступа к нему отправляется отдельно. Кроме того, если это было согласовано на шаге 2, могут составляться и отправляться отдельные сверочные файлы для токенов и повторяемых оплат. 6. Сообщить \(ответным письмом\) специалистам Ecommpay о корректности информации или о выявленных несоответствиях. В первом случае \(если сведения в файле актуальны и корректны\) после этого можно приступать к использованию перенесённой информации. Во втором случае \(если обнаружены несоответствия или ошибки\) специалисты Ecommpay сверяют информацию из файла с информацией, полученной от прежнего эквайера, и \(если информация не совпадает\) исправляют её по согласованию с мерчантом или \(если информация совпадает\) рекомендуют обратиться к прежнему эквайеру для её актуализации, а затем сообщить специалистам Ecommpay актуальные сведения. **Прим.:** Проведение платежей через платформу Ecommpay с использованием перенесённой информации возможно только после получения от мерчанта подтверждения корректности всех сведений. 7. Настроить на стороне веб-сервиса использование актуальной информации. Так, для работы с токенами целесообразно обновить их значения \(на сформированные в платёжной платформе\), а для работы с повторяемыми оплатами — настроить использование новых идентификаторов платежей и списаний. После этого можно полноценно работать с перенесённой информацией. В следующих разделах представлена информация об основных параметрах, которые используются при переносе информации.Для настройки дополнительных параметров следует обращаться к курирующему менеджеру Ecommpay. ## Состав параметров для повторяемых оплат {#ru_gate_data_migration_cof_parameters} При переносе информации о повторяемых оплатах используются следующие основные параметры. ### Идентификаторы проекта и пользователя {#section_n5v_cdl_2xb .section} |Параметр|Описание| |--------|--------| |`project_id`|Идентификатор проектав платёжной платформе Ecommpay, к которому относится переносимая информация. Пример: `42` | |`customer_id` [required for verification](ru_default_for_verification.md) |Идентификатор пользователя в веб-сервисе.Должен представлять собой строку длиной не более 255 символов. Пример: `customer_17008` | ### Сведения о платёжной карте {#section_nbw_hdl_2xb .section} |Параметр|Описание| |--------|--------| |`pan` [required for verification](ru_default_for_verification.md) |Номер платёжной карты.Переносится между эквайерами в явном виде, но в сверочном файле указывается в маскированном виде в параметре `card_number`. Пример: `4314220000000056` | |`card_holder`|Имя держателя карты, в соответствии с указанным на карте и с учётом используемых [ограничений](ru_faq_payment_processing.md). Пример: `SONYA KOVALEVSKY` | |`card_expiration_month`|Порядковый номер месяца, в котором истекает срок действия карты, в виде числа от 1 до 12. Пример: `5` | |`card_expiration_year`|Порядковый номер года, в котором истекает срок действия карты, в формате `ГГГГ`. Пример: `2025` | |`card_type`|Указатель бренда платёжной карты со следующими вариантами значений: - `amex` — American Express - `maestro` — Maestro - `mastercard` — Mastercard - `visa` — Visa | ### Основные сведения о повторяемой оплате {#section_ydp_ldl_2xb .section} |Параметр|Описание| |--------|--------| |`description`|Описание повторяемой оплаты, в виде строки длиной не более 255 символов. Пример: `Subscription for Cosmoshop mini games pack` | |`scheme_id`|Идентификатор операции, в рамках которой была зарегистрирована повторяемая оплата, на стороне международной платёжной системы \(Mastercard или Visa\). Может использоваться при регистрации повторяемой оплаты для карты, выпущенной в Европейской экономической зоне. Примеры: `MDS60JXCH0209` \(для Mastercard\) и `482269429345022` \(для Visa\) | |`register_payment_id`|Идентификатор записи о серии списаний в веб-сервисе мерчанта, в виде строки длиной не более 255 символов. Если этот идентификатор не предоставлен мерчантом, он автоматически задаётся в платёжной платформе в формате `Ecommpay–yyyymmddnnn` и передаётся мерчанту в сверочном файле. Пример: `Ecommpay-20230515001` | |`status`|Статус записи о серии списаний\([подробнее](ru_gate_payment_recurring_registration.md)\): - `active` — ожидаются дальнейшие списания - `canceled` — дальнейшие списания отменены Если этот параметр не указан, серии присваивается статус `active` | |`recurring_type`|Указатель типа повторяемой оплаты\([подробнее](ru_Gate__saved_cards_payments_type.md)\): - `U` — автооплата - `R` — регулярная оплата | ### Параметры регулярных списаний {#section_kym_ydl_2xb .section} |Параметр| | |--------|--| |`amount` [required for verification](ru_default_for_verification.md) |Сумма однократного списания. В дробных единицах валюты, если они применимы.В сверочном файле указывается в параметре `recurring_amount`. Пример: `999` | |`currency` [required for verification](ru_default_for_verification.md) |Код валюты списаний в формате ISO 4217 alpha-3.В сверочном файле указывается в параметре `recurring_currency`. Пример: `USD` | |`start_date` [required for verification](ru_default_for_verification.md) |Дата, с которой необходимо начать списания после переноса информации в платформу, в формате `dd-mm-yyyy`. Пример: `01-06-2023` | |`start_time` [required for verification](ru_default_for_verification.md) |Время, в которое следует выполнять списания, в формате `hh–mm–ss`. Пример: `15-00-00` | |`period` [required for verification](ru_default_for_verification.md) |Период, используемый как единица расчёта при определении интервала списаний\(чтобы задавать списания по регулярной оплате каждые *n* дней, недель или иных периодов\), со следующими вариантами значений: - `D` — день - `W` — неделя - `M` — месяц - `Q` — квартал - `Y` — год В случае, если вместе с параметром `period` не указан параметр `period_interval`, списания выполняются ежедневно, еженедельно, ежемесячно, ежеквартально и ежегодно соответственно. | |`period_interval`|Множитель, используемый по отношению к параметру `period` для определения интервала регулярных списаний \(чтобы задавать списания по регулярной оплате каждые *n* дней, недель или иных периодов, где *n* задаётся как интервал\) с допустимыми целочисленными значениями от 1 до 100. Например, значение `3` параметра `period_interval` и значение `W` параметра `period` определяют списания каждые 3 недели | |`scheduled_payment_id`|Идентификатор платежа, в рамках которого следует выполнять списания, в виде строки длиной не более 255 символов. Если этот идентификатор не предоставлен мерчантом, он автоматически задаётся в платёжной платформе в формате `Ecommpay–yyyymmddnnn` и передаётся мерчанту в сверочном файле. Пример: `Ecommpay-20230515001` | ## Состав параметров для токенов {#ru_gate_data_migration_token_parameters} При переносе информации о токенах используются следующие основные параметры. |Параметр|Описание| |--------|--------| |`project_id`|Идентификатор проектав платёжной платформе Ecommpay, к которому относится переносимая информация. Пример: `42` | |`customer_id` [required for verification](ru_default_for_verification.md) |Идентификатор пользователя в веб-сервисе.Должен представлять собой строку длиной не более 255 символов. Пример: `customer_17008` | |`pan`|Номер платёжной карты.Переносится между эквайерами в явном виде. Пример: `4314220000000056` | |`card_holder`|Имя держателя карты, в соответствии с указанным на карте и с учётом используемых [ограничений](ru_faq_payment_processing.md). Пример: `SONYA KOVALEVSKY` | |`card_expiration_month`|Порядковый номер месяца, в котором истекает срок действия карты, в виде числа от 1 до 12. Пример: `5` | |`card_expiration_year`|Порядковый номер года, в котором истекает срок действия карты, в формате `ГГГГ`. Пример: `2025` | |`card_type`|Указатель бренда платёжной карты со следующими вариантами значений: - `amex` — American Express - `maestro` — Maestro - `mastercard` — Mastercard - `visa` — Visa | ## Дополнительные материалы {#ru_gate_data_migration_links} При использовании возможности переноса информации о повторяемых оплатах и токенах платёжных карт могут быть полезны следующие материалы: - [Организация взаимодействия](ru_gate_interaction_organisation.md#)— статья с общей информацией о взаимодействии с платёжной платформой через Gate. - [Повторяемые оплаты](ru_Gate__payments_on_saved_data.md)— группа статей о работе с повторяемыми оплатами. - [Использование токенов](ru_Gate_Token.md)— статья с информацией о работе с токенами платёжных карт. - [Контроль и проведение платежей](ru_dbl_payments.md#)— статья с информацией о проведении и контроле проведения платежей и операций через Dashboard. - [Спецификация Gate API](https://api-developers.ecommpay.com/)— спецификация интерфейса Gate API.