Перейти к основному содержимому

Уведомление о выдаче перевода

В случае успешной выдачи денег за границей Банк пришлет платежному партнеру вебхук transaction_registration, на который платежный партнер должен будет дать ответ.
В вебхуке будет передана следующая основная информация:

  • родительская сессия, в рамках которой средства были приняты (session_payment_id),
  • текущая сессия, в рамках которой деньги были выданы (session_id),
  • сумма выдачи.

Платежный партнер может отключить передачу данного вебхука. Для этого надо обратиться к менеджеру Банка 131.

Параметры вебхука transaction_registration

НазваниеОбязательностьТип данныхОписание
session_payment_id+stringID сессии payment
session+objectДанные сессии
  id+stringID сессии payout
  status+stringТекущий статус сессии. Возможные значения
  created_at+stringДата и время создания сессии в формате RFC 3339. Пример: 2022-11-15T15:38:50.255803Z
  updated_at+stringДата и время обновления сессии в формате RFC 3339. Пример: 2022-11-15T15:38:50.255803Z
  error-objectОшибка. Возвращается только если была ошибка по сессии
    description-stringОписание ошибки
    code-stringКод ошибки
  payments+arrayДанные платежа
    id+stringID платежа
    status+stringТекущий статус платежа. Возможные значения
    created_at+stringДата и время создания платежа в формате RFC 3339. Пример: 2022-11-15T15:38:50.255803Z
    finished_at-stringДата и время финализации платежа в формате RFC 3339. Пример: 2022-11-15T15:38:50.255803Z
    payment_method+objectСпособ платежа
      type+stringНазвание способа платежа. Возможное значение: moneysend
    amount_details+objectОбъект amount_details, переданный в запросе
      amount+floatСумма в минорных значениях
      currency+stringВалюта
    paymentMetadata-objectДополнительные метаданные
      parentSessionId-stringНомер сессии payment
    participant_details+objectИнформация об отправителе и получателе. Объект гарантирован. Все ключи и вложенные объекты не гарантируются
      sender-objectДанные отправителя. Объект гарантирован. Все ключи и вложенные объекты не гарантируются
      recipient-objectДанные получателя. Объект гарантирован. Все ключи и вложенные объекты не гарантируются
    error-objectПричина ошибки транзакции. Возвращается только если была ошибка по сессии
      description-stringОписание ошибки
      code-stringКод ошибки
Пример вебхука
{
"session_payment_id": "ps_949108",
"session": {
"id": "ps_949139",
"status": "accepted",
"created_at": "2023-03-03T15:00:05.864870Z",
"updated_at": "2023-03-03T15:00:06.307414Z",
"payments": [
{
"id": "po_231420",
"status": "succeeded",
"created_at": "2023-03-03T15:00:05.948271Z",
"finished_at": "2023-03-03T15:00:06.136321Z",
"payment_method": {
"type": "moneysend",
"moneysend": {}
},
"amount_details": {
"amount": 143000,
"currency": "USD"
},
"paymentMetadata": {
"parentSessionId": "ps_949108"
},
"participant_details": {
"sender": {
"full_name": "Анастасия Медынич Олеговна",
"first_name": "Анастасия",
"last_name": "Медынич",
"middle_name": "Олеговна",
"country_iso3": "RUS",
"city": "Стерлитамак",
"postal_code": "",
"building": "1",
"date_of_birth": "1994-01-06",
"street": "Конаковская",
"state": "Республика Башкортостан",
"description": "описание описания",
"identity_document": {
"id_type": "Паспорт гражданина Российской Федерации",
"id_number": "6916 706690",
"issue_date": "2020-01-01",
"division_code": "",
"issued_by": "ОВД ПО Кировскому району"
},
"citizenship_country_iso3": "RUS",
"service_point": {
"id": "1",
"name": "точка на Ленина",
"country_iso3": "RUS",
"state": "Москва",
"city": "Москва",
"street": "Ленина",
"house": "1",
"oktmo": "36634436111",
"terminal_id": "345"
},
"source_of_money": "зарплата",
"contacts": {
"phone": {
"full_number": "+79376151530",
"country_iso3": "RUS",
"operator_code": "937",
"short_number": "6151530"
}
}
},
"recipient": {
"full_name": "Ivan Olegov Sergeevich",
"first_name": "Ivan",
"last_name": "Olegov",
"middle_name": "Sergeevich",
"date_of_birth": "1987-11-08",
"currency": "USD",
"contacts": {
"phone": {
"full_number": "+43523452345",
"country_iso3": "TUR",
"operator_code": "352",
"short_number": "3452345"
}
}
}
}
}
]
}
}

Параметры ответа

НазваниеОбязательностьТип данныхОписание
status+stringСтатус регистрации. Возможные значения:
succeeded — успешно зарегистрирован
failed — ошибка регистрации
already — запись уже существует
status_details+stringДетальная информация о статусе регистрации
Пример ответа
{
"status": "failed",
"status_details": "No such session_payment_id: ps_948536"
}