Уведомление о выдаче перевода
В случае успешной выдачи денег за границей Банк пришлет платежному партнеру вебхук transaction_registration
, на который платежный партнер должен будет дать ответ.
В вебхуке будет передана следующая основная информация:
- родительская сессия, в рамках которой средства были приняты (
session_payment_id
), - текущая сессия, в рамках которой деньги были выданы (
session_id
), - сумма выдачи.
Платежный партнер может отключить передачу данного вебхука. Для этого надо обратиться к менеджеру Банка 131.
Параметры вебхука transaction_registration
Название | Обязательность | Тип данных | Описание |
---|---|---|---|
session_payment_id | + | string | ID сессии payment |
session | + | object | Данные сессии |
id | + | string | ID сессии 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 | + | string | ID платежа |
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"
}