Выплаты на банковскую карту
Для инициации выплаты на карту нужно передать запрос 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будут содержаться реальная сумма и сумма списания с баланса, на которые прошла выплата