View Source

Метод для ініціювання зарахування коштів на картку отримувача. Створює платіж з типом A2C та статусом WAITING_COMPLETE, а також операцію з типом RECEIVE та статусом NEEDS_COMPLETE. Після цього можна викликати A2C Complete - завершення ініціювання зарахування або A2C Cancel - скасування ініціювання зарахування .

Якщо протягом 1 години не один із методів не буде викликаний клієнтом, автоматично буде викликано A2C Cancel - скасування ініціювання зарахування .

Метод запиту - POST

Шлях запиту - /api/p2p/payments/a2c/initiate

Параметри для формування тіла запиту у форматі JSON

Ключ	Тип даних	Обов'язковий?	Опис	Приклад
params.sessionId	string	так	id сесії клієнта	"445fb296-8653-4646-8475-5796c97d16ff"
params.externalId	string	так	унікальний зовнішній id у системі клієнта, який буде присвоєно створеній операції, не більше 255 символів	"116f3329-63b8-4eef-9e88-272bd8f697ac"
params.amount	number	так	сума платежу, в копійках	15000
params.currency	string	так	цифровий код валюти, стандарт ISO 4217, на даний момент доступна лише гривня - "980"	"980"
params.description	string	ні	опис платежу, не більше 255 символів	"Order №54321"
params.callbackUrl	string	ні	URL на який буде здійснюватись відправка callback, не більше 255 символів	"https://client-domain.ua/receive-postback/54321"

Приклад тіла запиту

{
  "params": {
    "sessionId": "445fb296-8653-4646-8475-5796c97d16ff",
    "externalId": "116f3329-63b8-4eef-9e88-272bd8f697ac",
    "amount": 15000,
    "currency": "980",
    "description": "Order №54321",
    "callbackUrl": "https://client-domain.ua/receive-postback/54321"
  }
}

Параметри тіла відповіді у форматі JSON

Ключ	Тип даних	Опис	Приклад
data.paymentId	string	id платежу	"25f2f3d4-0406-499b-bb9c-577596ad9ef6"
data.operationId	string	id операції	"d977281d-c4c5-4c81-b457-791767bb0a02"
data.externalId	string	зовнішній id операції	"116f3329-63b8-4eef-9e88-272bd8f697ac"

Приклад тіла відповіді

{
  "status": 1,
  "data": {
    "paymentId": "25f2f3d4-0406-499b-bb9c-577596ad9ef6",
    "operationId": "d977281d-c4c5-4c81-b457-791767bb0a02",
    "externalId": "116f3329-63b8-4eef-9e88-272bd8f697ac"
  }
}