UAPAY - національний платіжний сервіс

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

Метод для ініціювання зарахування коштів на картку отримувача. Створює платіж з типом 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"
  }
}

  • No labels