Переводы с карты на карту
Перевод с карты на карту — тип платежа, в рамках которого на основании одного исходного запроса осуществляются списание денежных средств с платёжной карты отправителя и последующее зачисление этих средств на платёжную карту получателя.
Ограничения и особенности:
Перевод с карты на карту — тип платежа, в рамках которого на основании одного исходного запроса осуществляются списание денежных средств с платёжной карты отправителя и последующее зачисление этих средств на платёжную карту получателя.
Ограничения и особенности:
- В случае неудачной выплаты возврат происходит автоматически
- Для осуществления перевода можно использовать ранее сохраненные карты
Проведение перевода
URL запроса
POST https://api.greenleavespay.kz/g2g/p2p/transfer
Поля запроса
URL запроса
POST https://api.greenleavespay.kz/g2g/p2p/transfer
Поля запроса
Название;Описание;Тип;
pg_merchant_id <p style="color:#d63384">required</p>;ID магазина;integer
pg_order_id <p style="color:#d63384">required</p>;ID заказа в системе мерчанта. Рекомендуется уникальное, монотонно возрастающее значение. <br><span style="font-size:14px">Пример: 123</span>;string
pg_amount <p style="color:#d63384">required</p>;Сумма перевода в валюте списания.<br> Минимум 0.01<br><span style="font-size:14px">Пример: 10</span>;number
pg_amount_to <p style="color:#d63384">required if no pg_amount</p>;Сумма перевода в валюте зачисления.<br> Минимум 0.01<br><span style="font-size:14px">Пример: 10</span>;number
pg_currency_from <p style="color:#d63384">required</p>;<p style="color:#00112c">Валюта списания, в которой указана сумма перевода. KZT, USD, EUR.</p> см в разделе Справочник валют Справочник валют link=https://customer.greenleavespay.kz/dev/currencystring;
pg_currency_to <p style="color:#d63384">required</p>;<span style="color:#00112c">Валюта зачисления перевода. В случае когда валюта списания и зачисления разные, производится пересчет. Актуальный курс можно получить</span> методом link=https://docs.greenleavespay.kz/#/g2g/p2p#content-%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BA%D1%83%D1%80%D1%81%D0%BE%D0%B2;string
pg_commission_amount;Комиссия взимаемая с плательщика в валюте списания;number
pg_description <p style="color:#d63384">required</p>;Описание товара или услуги. Отображается покупателю в процессе платежа. Передается в кодировке pg_encoding<br><span style="font-size:14px">Пример: Описание платежа</span>;string
pg_user_id <p style="color:#d63384">required if pg_save_sender_card or</p><p style="color:#d63384">pg_save_recipient_card</p>;ID пользователя в системе мерчанта.<br><span style="font-size:14px">Пример: 1234</span>;integer
pg_user_phone;Телефон отправителя.<br><span style="font-size:14px">Пример: 7077777777777</span>;string
pg_user_email;Email отправителя.<br><span style="font-size:14px">mail@customer.kz</span>;string
pg_card_token <p style="color:#d63384">required if no pg_card_pan</p>;Токен сохраненной карты отправителя;string
pg_card_pan <p style="color:#d63384">required if no pg_card_token</p>;Номер карты отправителя.<br><span style="font-size:14px">Пример: 4405645000006150</span>; integer
pg_card_cvc <p style="color:#d63384">required if no pg_card_token</p>;Трёхзначный код проверки подлинности карты. <br><span style="font-size:14px">Пример: 653</span>;integer
pg_card_year <p style="color:#d63384">required if no pg_card_token</p>;Срок действия карты (год) yy. <br><span style="font-size:14px">Пример: 25</span>; integer
pg_card_month <p style="color:#d63384">required if no pg_card_token</p>;Срок действия карты (месяц) mm. <br><span style="font-size:14px">Пример: 09</span>;integer
pg_card_name <p style="color:#d63384">required if no pg_card_token</p>;Имя владельца карты отправителя. <br><span style="font-size:14px">Пример: IVAN IVANOV</span>;string
pg_card_recipient <p style="color:#d63384">required if no pg_card_recipient_token</p>;Номер карты получателя. <br><span style="font-size:14px">Пример: 4405645000006150</span>;integer
pg_card_recipient_token <p style="color:#d63384">required if no pg_card_recipient</p>;Токен сохраненной карты получателя; string
pg_card_recipient_name;Имя владельца карты получателя. Если не передано, то в качестве имени получателя используется Имя отправителя из параметра pg_card_name <br><span style="font-size:14px">Пример: IVAN IVANOV</span>;string
pg_save_sender_card;Признак необходимости сохранить карту отправления денежных средств. <br><span style="font-size:14px">Пример: 1</span>;string
pg_save_recipient_card;Признак необходимости сохранить карту получения денежных средств. <br><span style="font-size:14px">Пример: 1</span>;string
pg_language;Язык текста ошибки. Доступные языки: ru, en, kz, kg, uz, de.;string
pg_salt <p style="color:#d63384">required</p>;Случайная строка, состоящая из произвольных цифр и латинских букв. <br><span style="font-size:14px">Пример: some random string</span>;string
pg_sig <p style="color:#d63384">required</p>;Подпись запроса;string
Параметры ответа
Название;Описание;Валидация;
pg_payment_id;ID транзакции;integer
pg_status;Статус запроса;string
pg_payment_status;Статус платежа. <br>Enum:<span style="color:#d63384">success, error, incomplete, process</span>;string
pg_3ds;Флаг обозначающий необходимость запроса 3DS. 1 – 3DS установлен, 0 - нет;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 сервер банка эмитента:
На этой странице клиент вводит свой 3ds пароль.
URL сервера можно получить из параметра pg_3d_acsurl.
Параметры запроса в ACS сервер банка эмитента:
Название;Описание
TermUrl;URL на который придет ответ в случае успеха
Проведение перевода с 3DSecure
Проведение перевода с 3DSecure после получения данных с ACS сервера
URL запроса
POST https://api.greenleavespay.kz/g2g/p2p/transfer_acs
Поля запроса
Проведение перевода с 3DSecure после получения данных с ACS сервера
URL запроса
POST https://api.greenleavespay.kz/g2g/p2p/transfer_acs
Поля запроса
Название;Описание;Тип;
pg_merchant_id <p style="color:#d63384">required</p>;ID магазина. Цифры;integer
pg_payment_id <p style="color:#d63384">required</p>;ID транзакции. Цифры;integer
pg_salt <p style="color:#d63384">required</p>;Случайная строка, состоящая из произвольных цифр и латинских букв. <br><span style="font-size:14px">Пример: some random string</span>;string
pg_sig <p style="color:#d63384">required</p>;Подпись запроса;string
Параметры ответа
Параметры ответа на успешный запрос:
Параметры ответа на успешный запрос:
Название;Описание;Тип;
pg_payment_id;ID транзакции;integer
pg_status;Статус запроса;string
pg_payment_status;Статус платежа. <br>Enum:<span style="color:#d63384">success, error, incomplete, process</span>;string
pg_order_id;Идентификатор заказа в системе мерчанта;string
pg_card_token;Токен сохраненной карты;string
pg_card_recipient_token;Токен сохраненной карты получателя;string
pg_card_mask;Маскированный номер карты отправителя (часть цифр номера карты скрыты);string
pg_card_recipient_mask;Маскированный номер карты получателя (часть цифр номера карты скрыты);string
pg_salt;Случайная строка;string
pg_sig;Цифровая подпись запроса;string
pg_datetime;Дата и время запроса;datetime
В случае ошибок, будут дополнительные параметры ответа:
Название;Описание;Валидация;
pg_error_code;ID кода ошибки;Цифры
pg_error_description;Текстовое описание ошибки;Строка
Получение статуса перевода
URL запроса
POST https://api.greenleavespay.kz/g2g/p2p/status
Поля запроса
URL запроса
POST https://api.greenleavespay.kz/g2g/p2p/status
Поля запроса
Название;Описание;Тип;
pg_merchant_id <p style="color:#d63384">required</p>;ID магазина. Цифры;integer
pg_payment_id <p style="color:#d63384">required</p>;ID транзакции. Цифры;integer
pg_salt <p style="color:#d63384">required</p>;Случайная строка, состоящая из произвольных цифр и латинских букв. <br><span style="font-size:14px">Пример: some random string</span>;string
pg_sig <p style="color:#d63384">required</p>;Подпись запроса;string
Параметры ответа
Название;Описание;Тип;
pg_payment_id;ID транзакции;integer
pg_status;Статус запроса;string
pg_payment_status;Статус платежа. <br>Enum:<span style="color:#d63384">success, error, incomplete, process</span>;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
Получение курсов
URL запроса
POST https://api.greenleavespay.kz/g2g/p2p/rates
Поля запроса
URL запроса
POST https://api.greenleavespay.kz/g2g/p2p/rates
Поля запроса
Название;Описание;Тип;
pg_merchant_id <p style="color:#d63384">required</p>;ID магазина. Цифры;integer
pg_currency_from;Валюта списания;string
pg_currency_to;Валюта зачисления перевода;string
pg_salt <p style="color:#d63384">required</p>;Случайная строка, состоящая из произвольных цифр и латинских букв. <br><span style="font-size:14px">Пример: some random string</span>;string
pg_sig <p style="color:#d63384">required</p>;Подпись запроса;string
Параметры ответа
Название объекта;Название параметра;Описание;Тип;
pg_status;;Статус выполнения запроса;string
rate;pg_currency_from;Валюта списания;string
;pg_currency_to;Валюта зачисления перевода;string
;pg_rate;Курс конвертации;number
pg_salt;;Случайная строка;string
pg_sig;;Цифровая подпись запроса;string
pg_datetime;;Дата и время запроса;datetime
В случае ошибок, будут дополнительные параметры ответа:
Название;Описание;Тип
pg_error_code;ID кода ошибки;string
pg_error_description;Текстовое описание ошибки;string
Тестовые карты
Тестовые карты для списания перевода
Тестовые карты для списания перевода
Номер карты;CVV;Срок действия;Результат по карте
4400444400004440;123;2024/12;Успех без 3DS
4400444400004441;123;2024/12;Операция неуспешна, ошибка на стороне Международной Платежной системы. Повторите оплату позже
4400444400004442;123;2024/12;Ограничения на карте. Свяжитесь с банком выпустившим карту
4400444400004443;123;2024/12;Недостаточно средств. Просим пополнить счет или оплатить с другой карты
4400444400004444;123;2024/12;Успех с 3DS, Frictionless Flow
4400444400004445;123;2024/12;Ошибка оплаты. Сервис недоступен. Повторите попытку позже
Тестовые карты для зачисления перевода
Номер карты;Результат по карте
4400444444444440;Успех
4400444444444441;Ошибка оплаты. Сервис недоступен. Повторите попытку позже
4400444444444442;Ошибка оплаты. Обратитесь в банк выпустивший карту
4400444444444443;Недостаточно средств! Пополните выплатной баланс
4400444444444444;Process переходящий в успех
4400444444444445;Process переходящий в ошибку