C2A Reverse Initiate -initiating a refund

This is a method for initiating a refund to the payer's card. As part of a successful debiting for a payment with a C2A status of FINISHED and a debit operation with a SEND type of a FINISHED status, a return operation with a RETURN type and a NEEDS_COMPLETE status is created, and the C2A payment status changes to WAITING_COMPLETE. After that, you can perform the action C2A Reverse Complete - completion of refund initiation or C2A Reverse Cancel - cancellation of return initiation .

If not one of the methods is called by the client within 1 hour, it will be called automaticallyC2A Reverse Cancel - cancellation of return initiation .

Request method - POST

Request path - /api/p2p/payments/c2a/reverse/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.paymentId	string	yes, one of these parameters: params.paymentId, params.operationId, or params.externalId	payment id	"a85ee391-46ca-4766-b376-292bd7efbeea"
params.operationId	string		debit operation id	"bc3c95f1-bf2a-4e61-8c88-8444b1b4e014"
params.externalId	string		the external id of the write-off operation	"ad6cee7f-88ff-4090-ae38-8e6a0f260cd8"
params.reverseExternalId	string	yes	unique external refund id in the client's system, which will be assigned to the created operation, no more than 255 characters	"3b604870-7361-4125-9a41-03c12e8bc31b"

Request body examples

{
  "params": {
    "sessionId": "445fb296-8653-4646-8475-5796c97d16ff",
    "paymentId": "a85ee391-46ca-4766-b376-292bd7efbeea",
    "reverseExternalId": "3b604870-7361-4125-9a41-03c12e8bc31b"
  }
}

or

{
  "params": {
    "sessionId": "445fb296-8653-4646-8475-5796c97d16ff",
    "externalId": "ad6cee7f-88ff-4090-ae38-8e6a0f260cd8",
    "reverseExternalId": "3b604870-7361-4125-9a41-03c12e8bc31b"
  }
}

Response body parameters in JSON format

Key	Data type	Description	Example

Key	Data type	Description	Example
data.paymentId	string	payment id	"a85ee391-46ca-4766-b376-292bd7efbeea"
data.reverseOperationId	string	return operation id	"2a01fd7c-f9ca-444e-a800-d6ce59b87e96"
data.reverseExternalId	string	the external id of the return operation	"3b604870-7361-4125-9a41-03c12e8bc31b"

Example of a response body

{
  "status": 1,
  "data": {
    "paymentId": "a85ee391-46ca-4766-b376-292bd7efbeea",
    "reverseOperationId": "2a01fd7c-f9ca-444e-a800-d6ce59b87e96",
    "reverseExternalId": "3b604870-7361-4125-9a41-03c12e8bc31b"
  }
}

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

C2A Reverse Initiate -initiating a refund

Related pages