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

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

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

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

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

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

URL запроса
POST https://api.freedompay.kg/g2g/p2p/transfer

Тестовый URL запроса
POST https://test-api.freedompay.kg/g2g/p2p/transfer

Поля запроса

pg_merchant_id required;ID магазина;integer pg_order_id required;ID заказа в системе мерчанта. Рекомендуется уникальное, монотонно возрастающее значение. Максимальная длина 50 символов Пример: 123;string pg_amount required;Сумма перевода в валюте списания. Пример: 10;number pg_amount_to required if no pg_amount;Сумма перевода в валюте зачисления. Пример: 10;number pg_currency_from required;Валюта списания, в которой указана сумма перевода. KZT, USD, EUR. см в разделе Справочник валют;string; Справочник валют link=https://customer.freedompay.kg/dev/currency pg_currency_to required;Валюта зачисления перевода. В случае когда валюта списания и зачисления разные, производится пересчет. Актуальный курс можно получить методом link=https://freedompay.kg/docs/gateway-api/transfer;string pg_commission_amount;Комиссия взимаемая с плательщика в валюте списания;number pg_description required;Описание товара или услуги. Отображается покупателю в процессе платежа. Передается в кодировке pg_encoding Пример: Описание платежа;string pg_user_id required if pg_save_sender_card orpg_save_recipient_card;ID пользователя в системе мерчанта. Пример: 1234;integer pg_user_phone;Телефон отправителя. Пример: 7077777777777;string pg_user_email;Email отправителя. mail@customer.kz;string 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_card_recipient_name;Имя владельца карты получателя. Если не передано, то в качестве имени получателя используется Имя отправителя из параметра pg_card_name Пример: IVAN IVANOV;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_language;Язык текста ошибки. Доступные языки: ru, en, kz, kg, uz, de.;string

Параметры для эффективной работы антифрод-сервиса SecureBox

(Данные параметры могут в себя включать параметры из других разделов. Для эффективной работы Securebox рекомендуется придерживаться рекомендаций по валидации и примерам полей из этого раздела)

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

Дополнительно.

Специальный токен: 2d0b504c-b95d-4cf6-b782-5a7d13ab2c85, используется для указания какую часть перевода не проводить.

Если специальный токен передан в параметре pg_card_token и передан pg_card_recipient то будет проведена только выплата. В этом случае один из параметров pg_card_name или pg_card_recipient_name является обязательным.
Если специальный токен передан в параметре pg_card_token и передан pg_card_recipient_token то будет проведена только выплата.
Если специальный токен передан в параметре pg_card_recipient_token, то будет проведен только прием.

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

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

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

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

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

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

URL запроса
POST https://api.freedompay.kg/g2g/p2p/transfer_acs

Тестовый URL запроса
POST https://test-api.freedompay.kg/g2g/p2p/transfer_acs

Поля запроса

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

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

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

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

URL запроса
POST https://api.freedompay.kg/g2g/p2p/status

Тестовый URL запроса
POST https://test-api.freedompay.kg/g2g/p2p/status

Поля запроса

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

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

URL запроса
POST https://api.freedompay.kg/g2g/p2p/rates

Тестовый URL запроса
POST https://test-api.freedompay.kg/g2g/p2p/rates

Поля запроса

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

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

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

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

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