Выплаты
В этом разделе описана механика, когда Firstpay выплачивает деньги на банковскую карту пользователя

Внимание!
Выплаты будут доступны для магазина только после разрешения личного менеджера и применения соответствующих настроек на стороне Firstpay
Выплаты не могут быть тестовыми. Тестирование производится только выплатой определенной суммы на боевую карту
Выплатная страница
Выплаты будут доступны для магазина только после разрешения личного менеджера и применения соответствующих настроек на стороне Firstpay. При отправке запроса на выплату через страницу по адресу «POST https://api.firstpay.kz/reg2nonreg» будет получен ответ, в котором содержится поле с адресом сгенерированной выплатной страницы.

URL запроса
POST https://api.firstpay.kz/reg2nonreg

Поля запроса:
Параметры ответа:
Пример ответа:
<?xml version="1.0" encoding="UTF-8"?>
<root>
  <pg_status>string</pg_status>
  <pg_payment_id>0</pg_payment_id>
  <pg_merchant_id>0</pg_merchant_id>
  <pg_redirect_url>string</pg_redirect_url>
  <pg_salt>string</pg_salt>
  <pg_sig>string</pg_sig>
</root>
Выплата на сохраненную карту
Данный метод позволяет осуществлет выплату на карту предварительно сохранив ее. Для этого необходимо сохранить карту используя метод для сохранения карты «POST https://api.firstpaypay.kz/v1/merchant/(merchant_id)/cardstorage/add2 ». После отправки данных клиентом в ответ на данный запрос в ответе придет токен карты клиента в системе firstpay. После получения токена карты клиента необходимо произвести инициализацию выплаты с использованием соответствующих данных токена карты и его владельца отправив запрос «POST https://api.firstpay.kz/api/reg2reg». После инициализации платежа использовать полученый ID платежа в следующем методе «POST https://api.firstpaypay.kz/v1/merchant/(merchant_id)/card/pay» .



Сохранение карты
URL запроса
POST https://api.firstpay.kz /v1/merchant/”pg_merchant_id”/cardstorage/add2

Поля запроса:
Выплата на сохраненную карту по токену
В этом разделе описана механика, когда Firstpay выплачивает деньги на банковскую карту пользователя по средствам использования системы сохранения токена карты в системе firstpay.


URL запроса
POST https://api.firstpay.kz/api/reg2reg

Поля запроса:
Выплата по номеру карты
В этом разделе описана механика, когда Firstpay выплачивает деньги на мобильный баланс пользователя.

URL запроса
POST https://api.firstpay.kz/api/p2p2nonreg

Поля запроса:
Параметры ответа:
Post link запрос для мерчанта
После выплаты, будет вызван URL, указанный в pg_post_link
Сервер мерчанта должен ответить статусом 200
Post link на стороне мерчанта должен быть общедоступным, без авторизации.

URL запроса
POST {{post_link}}

Headers:
Поля запроса:
Статус платежа
Метод для получения статуса платежа по его ID. В ответ на данный запрос возвращается информация статуса платежа. В ответе транзакции указывается статус платеж, по типу выполнено: success, ok, done; Ошибка: error, failed; в процессе: process, new.

URL запроса
POST https://api.firstpay.kz/get_status2.php

Поля запроса:
Параметры ответа:
Пример успешного ответа:
 <?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_status>ok</pg_status>
    <pg_payment_id>511194</pg_payment_id>
    <pg_transaction_status>ok</pg_transaction_status>
    <pg_can_reject>0</pg_can_reject>
    <pg_captured>1</pg_captured>
    <pg_create_date>2021-08-26 11:52:25</pg_create_date>
    <pg_salt>41F5ZyqcOabTG5u7</pg_salt>
    <pg_sig>34484775bd62986753429d6af57e94eb</pg_sig>
</response>
Пример не успешного ответа (В ошибке ):
<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_status>ok</pg_status>
    <pg_payment_id>511180</pg_payment_id>
    <pg_transaction_status>failed</pg_transaction_status>
    <pg_can_reject>0</pg_can_reject>
    <pg_captured>0</pg_captured>
    <pg_create_date>2021-08-26 11:53:12</pg_create_date>
    <pg_failure_code>5</pg_failure_code>
    <pg_failure_description>Transaction declined</pg_failure_description>
    <pg_salt>VeJEycvwsTn74VEA</pg_salt>
    <pg_sig>aa65c7786f5cba0cd9e6a452bfbcc7a2</pg_sig>
</response>
Пример ответа (платеж не найден):
<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_status>error</pg_status>
    <pg_error_code>340</pg_error_code>
    <pg_error_description>Транзакция не найдена</pg_error_description>
</response>
API - Выплата на IBAN
В этом разделе описана механика, когда Firstpay выплачивает деньги на банковский счет по IBAN

Внимание!
Выплаты будут доступны для магазина только после разрешения личного менеджера и применения соответствующих настроек на стороне Firstpay
Выплаты не могут быть тестовыми. Тестирование производится только выплатой определенной суммы на боевую карту

Выплата по номеру карты
Выплата по IBAN — это перевод денег на международный номер банковского счета (International Bank Account Number). Такой стандарт помогает банкам по всему миру безошибочно распознавать счета.

URL запроса
POST https://api.firstpay.kz/api/to_iban

Параметры запроса:
Параметры ответа
На баланс мобильного
Firstpay предлагает возможность провести выплату на баланс мобильного, если мобильный оператор плательщика поддерживает данную возможность. Доступные мобильные операторы:
Tele2
Altel
Beeline
Activ
Kcell


Инициализация платежа
Если в ответе pg_status равен ok, мерчанту необходимо отправить запрос для продолжения выплаты.

URL запроса
POST https://api.firstpay.kz/mfs/payout

Поля запроса:
Параметры ответа:
Пример Ответа:
<?xml version="1.0" encoding="utf-8"?>
<response>
    <pg_status>ok</pg_status>
    <pg_payment_id>4567788</pg_payment_id>
    <pg_merchant>{{Firstpay_merchant_id}}</pg_merchant>
    <pg_order_id>23</pg_order_id>
    <pg_salt>bdwLavL9lg6It91b</pg_salt>
    <pg_sig>709633e91387c56ac6fb7cb33d1e07d8</pg_sig>
</response>
Выплата по номеру карты G2G
URL запроса
POST https://api.firstpay.kz/g2g/p2p2nonreg

Поля запроса:
Параметры ответа: