Выплаты на банковскую карту
Для инициации выплаты на карту нужно передать запрос https://api.1payment.com/init_payout
со следующими параметрами:
payout_type
- card (см типы выплат)partner_id
- 1234 (ID партнера)project_id
- 5678 (ID проекта)amount
- 50 (сумма в валюте проекта)destination
- (номер карты)first_name
- имя получателя (необходимость передачи данного параметра уточняйте у менеджера)last_name
- фамилия получателя (необходимость передачи данного параметра уточняйте у менеджера)- card_holder - Cardholder на карте получателя (необходимость передачи данного параметра уточняйте у менеджера)
user_data
- (уникальное значение, например, идентификатор выплаты на стороне партнера)year
- год окончания действия банковской карты, две последние цифры (опционально, пример: 21)month
- месяц окончания срока действия банковской карты (опционально, пример: 01)sign
- (подпись)
Пример:
https://api.1payment.com/init_payout?payout_type=card&partner_id=1234&project_id=5678&amount=50&destination=1234123412341234&user_data=1&sign=d724e1e6453a43397bb2aa6d6be9cc06
Подпись (sign) рассчитывается так: md5 от строки init_payout + конкатенация всех параметров = значение в алфавитном порядке по возрастанию с разделителем & + API Key (кроме параметра sign)
Для запроса выше строка, от которой будет браться md5, имеет вид:
init_payoutamount=50&destination=123412341234&partner_id=1234&payout_type=card&project_id=5678&user_data=1[API_Key]
В ответ система выдаст в JSON order_id, пример:
{"order_id":"8p3brmb19gfg0sg8gcwhws8kgc748s87","status":2,"status_description":"PENDING","status_code":0}
Где:
order_id
- Это id этой выплаты, по нему можно будет узнать статусstatus
- состояние выплатыstatus_description
- текстовое описание статусаstatus_code
- поле будет содержать код ошибки (если это возможно) в случае отказа в выплате
После получения финального статуса по выплате на ваш notify_url, указанный в настройках выплат, будет отправлено уведомление о статусе выплаты. Формат уведомления POST JSON со следующими параметрам:
payout_type
- тип выплаты (см типы выплат)project_id
- ID проектаorder_id
- ID платежа из запросаstatus
- состояние платежа (2 - ожидание, 3 - успешная выплата, 4 - отказ в выплате)status_description
- текстовое описание статуса (PENDING, SUCCESS, FAILURE, соответственно)init_time
- время создания платежаstatus_time
- время получения статусаamount
- сумма выплатыbalance_amount
- сумма списания с балансаdestination
- получатель (в случае с выплатами на банковские карты это поле будет содержать маску номера карты)status_code
- поле будет содержать код ошибки (если это возможно) в случае отказа в платежеpaid_amount
- этот параметр будет присутствовать только для выплат в статусе 2 PENDING для которых произведена частичная выплата. В нем будет содержаться сумма этих частичных выплат на текущий моментinit_amount
- этот параметр будет присутствовать только для выплат в статусе 3 SUCCESS для которых сумма инициации отличается от суммы выплаты. В нем будет содержаться сумма инициации, а в параметрахamount
иbalance_amount
будут содержаться реальная сумма и сумма списания с баланса, на которые прошла выплата