Перевод с карты на карты Gateway API| Документация Paybox Россия

Перевод с карты на карту — тип платежа, в рамках которого на основании одного исходного запроса осуществляются списание денежных средств с платёжной карты отправителя и последующее зачисление этих средств на платёжную карту получателя.

Перевод с карты на карту

Проведение перевода

URL запроса

Поля запроса

POST https://api.paybox.ru/g2g/p2p/transfer

Ограничения и особенности:

В случае неудачной выплаты возврат происходит автоматически
Для осуществления перевода можно использовать ранее сохраненные карты

pg_merchant_id required;ID магазина;integer pg_order_id required;ID заказа в системе мерчанта. Рекомендуется уникальное, монотонно возрастающее значение. Пример: 123;string pg_amount required;Сумма перевода в валюте списания.Пример: 10;number pg_currency_from required;Валюта списания, в которой указана сумма перевода. KZT, USD, EUR. Справочник валют;string;Справочник валют link=https://customer.freedompay.money/dev/currency pg_currency_to required;Валюта зачисления перевода. В случае когда валюта списания и зачисления разные, производится пересчет. Актуальный курс можно получить методом;string pg_commission_amount;Комиссия взимаемая с плательщика в валюте списания;number pg_description required;Описание товара или услуги. Отображается покупателю в процессе платежа. Передается в кодировке pg_encoding.Пример: Описание платежа;string pg_user_id required if pg_save_sender_card or pg_save_recipient_card;ID пользователя в системе мерчанта.Пример: 1234;integer pg_card_token required if no pg_card_pan;Токен сохраненной карты отправителя;string pg_card_pan required if no pg_card_token;Номер карты отправителя.Пример: 4405645000006150; integer pg_card_cvc required if no pg_card_token;Трёхзначный код проверки подлинности карты. Пример: 653;integer pg_card_year required if no pg_card_token;Срок действия карты (год) yy. Пример: 25; integer pg_card_month required if no pg_card_token;Срок действия карты (месяц) mm. Пример: 09;integer pg_card_name required if no pg_card_token;Имя держателя карты. Пример: IVAN IVANOV;string pg_card_recipient required if no pg_card_recipient_token;Номер карты получателя. Пример: 4405645000006150;integer pg_card_recipient_token required if no pg_card_recipient;Токен сохраненной карты получателя; string pg_save_sender_card;Признак необходимости сохранить карту отправления денежных средств. Пример: 1;string pg_save_recipient_card;Признак необходимости сохранить карту получения денежных средств. Пример: 1;string pg_salt required;Случайная строка, состоящая из произвольных цифр и латинских букв. Пример: some random string;string pg_sig required;Подпись запроса;string

Параметры ответа

pg_payment_id;ID транзакции;integer pg_status;Статус запроса;string pg_payment_status;Статус платежа. New - только что сформированный платеж. В этом статусе он возвращается после инициализации. Partial - платеж принимает этот статус, когда пользователь зашел на страницу ввода карточных данных. Pending - платеж принимает этот статус, когда пользователь нажал кнопку “оплатить”. Process - этот статус принимает платеж находящийся в обработки в текущий момент. Success - платеж успешно завершен. Failed - платеж завершен неуспешно, с ошибкой. Incomplete - пользователь перешел на страницу оплаты, но кнопка “оплатить” не нажата.;number pg_3d_acsurl;URL Банка эмитента карты для проверки 3DS;string pg_order_id;Идентификатор заказа в системе мерчанта;string pg_payment_amount;Сумма перевода валюте списания;number pg_payout_amount;Сумма перевода валюте зачисления;number pg_currency_from;Валюта списания;string pg_currency_to;Валюта зачисления перевода;string pg_card_token;Токен сохраненной карты отправителя;string pg_card_recipient_token;Токен сохраненной карты получателя;string pg_card_mask;Маскированный номер карты отправителя (часть цифр номера карты скрыты);string pg_card_recipient_mask;Маскированный номер карты получателя (часть цифр номера карты скрыты);string pg_payment_date;Дата и время проведения платежа;datetime pg_salt;Случайная строка, состоящая из произвольных цифр и латинских букв;string pg_sig;Цифровая подпись запроса;string pg_datetime;Дата и время запроса;datetime

Примечание. В случае, если на карте установлен 3ds, необходимо сделать запрос в ACS сервер банка эмитента карты.

На этой странице клиент вводит свой 3ds пароль.

URL сервера можно получить из параметра pg_3d_acsurl.

Параметры запроса в ACS сервер банка эмитента:

Проведение перевода с 3DSecure после получения данных с ACS сервера

Проведение перевода с 3DSecure

Поля запроса

URL запроса

POST https://api.paybox.ru/g2g/p2p/transfer_acs

Параметры ответа
Параметры ответа на успешный запрос:

В случае ошибок, будут дополнительные параметры ответа:

Получение статуса перевода

Поля запроса

URL запроса

POST https://api.paybox.ru/g2g/p2p/status

Параметры ответа

pg_payment_id;ID транзакции;integer pg_status;Статус запроса;string pg_payment_status;Статус платежа. New - только что сформированный платеж. В этом статусе он возвращается после инициализации. Partial - платеж принимает этот статус, когда пользователь зашел на страницу ввода карточных данных. Pending - платеж принимает этот статус, когда пользователь нажал кнопку “оплатить”. Process - этот статус принимает платеж находящийся в обработки в текущий момент. Success - платеж успешно завершен. Failed - платеж завершен неуспешно, с ошибкой. Incomplete - пользователь перешел на страницу оплаты, но кнопка “оплатить” не нажата.;string pg_payment_amount;Сумма перевода валюте списания;number pg_payout_amount;Сумма перевода валюте зачисления;number pg_currency_from;Валюта списания;string pg_currency_to;Валюта зачисления перевода;string pg_card_token;Токен сохраненной карты отправителя;string pg_card_recipient_token;Токен сохраненной карты получателя;string pg_card_mask;Маскированный номер карты отправителя (часть цифр номера карты скрыты);string pg_card_recipient_mask;Маскированный номер карты получателя (часть цифр номера карты скрыты);string pg_payment_date;Дата и время проведения платежа;datetime pg_salt;Случайная строка, состоящая из произвольных цифр и латинских букв;string pg_sig;Цифровая подпись запроса;string pg_datetime;Дата и время запроса;datetime

Получение курсов

Поля запроса

URL запроса

POST https://api.paybox.ru/g2g/p2p/rates

Параметры ответа

В случае ошибок, будут дополнительные параметры ответа:

Тестовые карты

Тестовые карты для списания перевода

Тестовые карты для зачисления перевода