Выплаты на банковскую карту

Для инициации выплаты на карту нужно передать запрос https://api.1payment.com/init_payout
со следующими параметрами:

см. формат запросов к API

  • 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"}

Это id этой выплаты, по нему можно будет узнать статус.

После получения финального статуса по выплате на ваш 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 будут содержаться реальная сумма и сумма списания с баланса, на которые прошла выплата