Метод для ініціювання зарахування коштів на картку отримувача. Створює платіж з типом A2C та статусом WAITING_COMPLETE, а також операцію з типом RECEIVE та статусом NEEDS_COMPLETE. Після цього можна викликати C2A A2C Complete - завершення ініціювання списання, C2A СompleteWithoutAcceptance - завершення ініціювання безакцептного списання або C2A зарахування або A2C Cancel - скасування ініціювання списаннязарахування .
Info |
---|
Якщо протягом 1 години не один із методів не буде викликаний клієнтом, автоматично буде викликано C2A A2C Cancel - скасування ініціювання списаннязарахування . |
Метод запиту - POST
Шлях запиту - /api/p2p/payments/c2aa2c/initiate
Параметри для формування тіла запиту у форматі JSON
Ключ | Тип даних | Обов'язковий? | Опис | Приклад |
---|---|---|---|---|
params.sessionId | string | так | "445fb296-8653-4646-8475-5796c97d16ff" | |
params.externalId | string | так | унікальний зовнішній id у системі клієнта, який буде присвоєно створеній операції, не більше 255 символів | "ad6cee7f116f3329-88ff63b8-40904eef-ae389e88-8e6a0f260cd8272bd8f697ac" |
params.amount | number | так | сума платежу, в копійках | 1000015000 |
params.currency | string | так | цифровий код валюти, стандарт ISO 4217, на даний момент доступна лише гривня - "980" | "980" |
params.description | string | ні | опис платежу, не більше 255 символів | "Order №12345№54321" |
params.callbackUrl | string | ні | URL на який буде здійснюватись відправка callback, не більше 255 символів |
Приклад тіла запиту
Code Block | ||
---|---|---|
| ||
{ "params": { "sessionId": "445fb296-8653-4646-8475-5796c97d16ff", "externalId": "ad6cee7f116f3329-88ff63b8-40904eef-ae389e88-8e6a0f260cd8272bd8f697ac", "amount": 1000015000, "currency": "980", "description": "Order №12345№54321", "callbackUrl": "https://client-domain.ua/receive-postback/1234554321" } } |
Параметри тіла відповіді у форматі JSON
Ключ | Тип даних | Опис | Приклад |
---|---|---|---|
data.paymentId | string | id платежу | "a85ee39125f2f3d4-46ca0406-4766499b-b376bb9c-292bd7efbeea577596ad9ef6" |
data.operationId | string | id операції | "bc3c95f1d977281d-bf2ac4c5-4e614c81-8c88b457-8444b1b4e014791767bb0a02" |
data.externalId | string | зовнішній id операції | "ad6cee7f116f3329-88ff63b8-40904eef-ae389e88-8e6a0f260cd8272bd8f697ac" |
Приклад тіла відповіді
Code Block | ||
---|---|---|
| ||
{ "status": 1, "data": { "paymentId": "a85ee39125f2f3d4-46ca0406-4766499b-b376bb9c-292bd7efbeea577596ad9ef6", "operationId": "bc3c95f1d977281d-bf2ac4c5-4e614c81-8c88b457-8444b1b4e014791767bb0a02", "externalId": "ad6cee7f116f3329-88ff63b8-40904eef-ae389e88-8e6a0f260cd8272bd8f697ac" } } |