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

A2C Initiate - initiation of enrollment operation

A method for initiating the transfer of funds to the recipient's card. Creates a payment with type A2C and status WAITING_COMPLETE, and a transaction with type RECEIVE and status NEEDS_COMPLETE. After that, you can perform the action A2C Complete - completion of enrollment initiation or A2C Cancel - cancellation of enrollment initiation .

If not one of the methods is called by the client within 1 hour, it will be called automatically A2C Cancel - cancellation of enrollment initiation .

Request method - POST

Request path - /api/p2p/payments/a2c/initiate

Parameters for forming the request body in JSON format

Key

Data type

Required?

Description

Example

Key

Data type

Required?

Description

Example

params.sessionId

string

yes

client session id

"445fb296-8653-4646-8475-5796c97d16ff"

params.externalId

string

yes

unique external id in the client's system that will be assigned to the created operation, no more than 255 characters

"116f3329-63b8-4eef-9e88-272bd8f697ac"

params.amount

number

yes

payment amount, in kopecks

15000

params.currency

string

yes

digital currency code, ISO 4217 standard, currently only hryvnia is available - "980"

"980"

params.description

string

no

description of the payment, no more than 255 characters

"Order №54321"

params.callbackUrl

string

no

The URL to which the callback will be sent, no more than 255 characters

"https://client-domain.ua/receive-postback/54321"

An example of a request body

{ "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" } }

Response body parameters in JSON format

Key

Data type

Description

Expample

Key

Data type

Description

Expample

data.paymentId

string

payment id

"25f2f3d4-0406-499b-bb9c-577596ad9ef6"

data.operationId

string

operation id

"d977281d-c4c5-4c81-b457-791767bb0a02"

data.externalId

string

external id of the operation

"116f3329-63b8-4eef-9e88-272bd8f697ac"

Example of a response body

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

 

UAPAY - національний платіжний сервіс
pay@uapay.ua