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

Платіжна документація

A2C Initiate - initiation of enrollment operation

Related pages