Списание средств
Данная транзакция списывает средства, ранее зарезервированные транзакцией авторизации, и деньги поступают на расчётный счёт торговца в сроки, оговоренные в договоре на приём платежа по банковским картам.
Запрос
Для списания средств отправьте POST запрос на https://gateway.overpay.io/transactions/captures с параметрами из таблиц ниже.
Параметры заголовка запроса
|
Параметры тела запроса
|
|||||||||||||||||
Warning
Если интеграция поддерживает несколько частичных списаний для одной транзакции авторизации, каждый запрос на списание рассматривается как отдельная транзакция.
Если после отправки запроса получен ответ 5xx или произошла сетевая ошибка, рекомендуется проверить статус транзакции по tracking_id. Если транзакция не найдена, повторите исходный запрос с тем же ключом идемпотентности.
Повторный запрос без ключа идемпотентности или с новым ключом идемпотентноти может привести к созданию дополнительного списания.
Пример запроса
{
"request": {
"parent_uid": "1-310b0da80b",
"amount": 50,
"tracking_id": "tracking_id_2",
"additional_data": {
"referer": "https://example.com/server/cs_post/post.php?order_id=5304380&security=949247¤cy=USD"
}
}
}
Ответ
|
|||||||||||||||||||||||||||||||||||||||||||||||||
Пример ответа
{
"transaction": {
"uid": "52bfc29a-2c2f-408a-a7d5-bd8e84a320a9",
"status": "successful",
"amount": 460,
"currency": "EUR",
"type": "capture",
"message": "Successfully processed",
"test": true,
"created_at": "2024-04-02T12:07:14.881Z",
"updated_at": "2024-04-02T12:07:20.028Z",
"paid_at": "2024-04-02T12:07:19.955Z",
"closed_at": null,
"settled_at": null,
"manually_corrected_at": null,
"parent_uid": "4298aabd-9547-46fa-a151-66c29489c157",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/52bfc29a-2c2f-408a-a7d5-bd8e84a320a9/580262bb7b11a467fd85aa1c22f3c4afb4150511533c086b55eb7e53f81f4727?language=en",
"status_code": null,
"mute_notifications": null,
"tracking_id": "tracking_id_2",
"id": "52bfc29a-2c2f-408a-a7d5-bd8e84a320a9",
"code": "S.0000",
"friendly_message": "The operation is successful.",
"smart_routing_verification": {
"status": "successful"
},
"capture": {
"message": "Capture was approved",
"ref_id": "8889912",
"rrn": null,
"auth_code": null,
"bank_code": "05",
"gateway_id": 3483,
"status": "successful"
},
"additional_data": {
"referer": "https://example.com/server/cs_post/post.php?order_id=5304380&security=949247¤cy=USD"
}
}
}
Вариант интеграции YA
В этом варианте интеграции невозможно получить финальный статус транзакции в синхронном ответе на запрос списания средств: в ответе вернется промежуточный статус транзакции incomplete, а затем торговец получит автоматическое уведомление с финальным статусом транзакции.
Info
Пример синхронного ответа
{
"transaction": {
"uid": "acd0f07e-5509-4081-82ff-28a2b0c77271",
"status": "incomplete",
"amount": 200,
"currency": "RUB",
"type": "capture",
"message": "Unknown transaction status. Contact the payment service provider for details.",
"test": false,
"created_at": "2025-10-10T08:28:23.059Z",
"updated_at": "2025-10-10T08:28:24.755Z",
"paid_at": null,
"closed_at": null,
"settled_at": null,
"manually_corrected_at": null,
"parent_uid": "595cbea6-9463-4dd1-a508-a3e1cc5a25ee",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/acd0f07e-5509-4081-82ff-28a2b0c77271/260ee21c4f3100d9d247f21603afd723d8a1129698e9a6d4f183806acd79dbd0?language=en",
"status_code": null,
"mute_notifications": null,
"version": 3,
"psp_settled_at": null,
"registry_id": null,
"tracking_id": "ebc6fae9-70f5-47f6-a9d8-2b685dba3551",
"credit_card": {
"holder": "John Doe",
"stamp": "c891ed42d05a6a9e33dd15914f04b33ee8e80c5695ea9e9f05070b6017fed87c",
"brand": "visa",
"last_4": "0178",
"first_1": "4",
"bin": "405106",
"bin_8": "40510600",
"issuer_country": null,
"issuer_name": null,
"product": null,
"exp_month": 12,
"exp_year": 2026,
"token_provider": null,
"token": "fdcc6f93-cd35-4dba-af8e-8d2a185d770f"
},
"id": "acd0f07e-5509-4081-82ff-28a2b0c77271",
"code": "P.9999",
"friendly_message": "Unknown transaction status. Contact the merchant for details.",
"capture": {
"message": "Confirmed",
"ref_id": "3091820",
"rrn": null,
"auth_code": null,
"bank_code": "200",
"gateway_id": 5782,
"status": "incomplete"
}
}
}
Пример автоматического уведомления с финальным статусом
{
"transaction": {
"uid": "acd0f07e-5509-4081-82ff-28a2b0c77271",
"status": "successful",
"amount": 200,
"currency": "RUB",
"type": "capture",
"message": "Successfully processed",
"test": false,
"created_at": "2025-10-10T08:28:23.059Z",
"updated_at": "2025-10-10T08:28:28.244Z",
"paid_at": "2025-10-10T08:28:28.155Z",
"closed_at": null,
"settled_at": null,
"manually_corrected_at": null,
"parent_uid": "595cbea6-9463-4dd1-a508-a3e1cc5a25ee",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/acd0f07e-5509-4081-82ff-28a2b0c77271/260ee21c4f3100d9d247f21603afd723d8a1129698e9a6d4f183806acd79dbd0?language=en",
"status_code": null,
"mute_notifications": null,
"version": 6,
"psp_settled_at": null,
"registry_id": null,
"tracking_id": "ebc6fae9-70f5-47f6-a9d8-2b685dba3551",
"credit_card": {
"holder": "John Doe",
"stamp": "c891ed42d05a6a9e33dd15914f04b33ee8e80c5695ea9e9f05070b6017fed87c",
"brand": "visa",
"last_4": "0178",
"first_1": "4",
"bin": "405106",
"bin_8": "40510600",
"issuer_country": null,
"issuer_name": null,
"product": null,
"exp_month": 12,
"exp_year": 2026,
"token_provider": null,
"token": "fdcc6f93-cd35-4dba-af8e-8d2a185d770f"
},
"id": "acd0f07e-5509-4081-82ff-28a2b0c77271",
"code": "S.0000",
"friendly_message": "The transaction is successfully processed.",
"capture": {
"message": "Transaction was successfully processed.",
"ref_id": "3091820",
"rrn": null,
"auth_code": null,
"bank_code": "200",
"gateway_id": 5782,
"status": "successful"
}
}
}