Skip to main content

Refund Transaction

To make refund you can use Refund request. Use payment public ID from Payment Platform in the request.

API Endpoint

Request URL:      {{CHECKOUT_HOST}}/api/v1/payment/refund
Request Method: POST
Request Body: JSON

Request Parameters

ParameterTypeMandatory, LimitationsDescription
merchant_keyStringRequiredKey for Merchant identification
Example: xxxxx-xxxxx-xxxxx
payment_idStringRequired Up to 255 charactersTransaction ID (public)
Example: dc66cdd8-d702-11ea-9a2f-0242c0a87002
amountStringOptional Format: XX.XX, without leading zeroesAmount to refund. It is required for particular refund. If amount is not specified the full order amount is settled by default.
Example: 0.19
hashStringRequiredSpecial signature to validate your request to Payment Platform.
For details, click here

Response Parameters

ParameterTypeMandatory, LimitationsDescription
payment_idStringRequired Up to 255 charactersTransaction ID (public)
Example: dc66cdd8-d702-11ea-9a2f-0242c0a87002
resultStringRequiredRefund request result Example: accepted

Examples

Request
curl --location -g --request POST '{{CHECKOUT_HOST}}/api/v1/payment/refund' \
--data-raw \
'{
"merchant_key": "xxxxx-xxxxx-xxxxx",
"payment_id": "63c781cc-de3d-11eb-a1f1-0242ac130006",
"amount": "0.10",
"hash": "{{operation_hash}}"
}'
Response - Refund request accepted
Body
{
"payment_id": "63c781cc-de3d-11eb-a1f1-0242ac130006",
"result": "accepted"
}