Skip to main content

Create Refund API

Create an Refund#

The following endpoint creates an Refund:

/refunds

Request parameters#

Following are the parameters to be sent in the request body:

Fieldis required?DescriptionExample
ref_idmandatorystring The refund reference id"ref_reference_123"
customer_idmandatorystring The customer id"cust_0912jas123"
payment_idmandatorystring The payment it that what to make a refund"pay_ttqs62k99s"
amountmandatorystring The refund amount requested"10000" or "10000.23" for amount with decimal value
notesoptionalstring The refund note"rejected product"

Example#

curl -u <YOUR_SECRET_KEY> \
-X POST https://api.durianpay.id/v1/refunds \
-H "content-type: application/json" \
-d '{
"ref_id": "reference_1",
"customer_id": "cus_9eGU1Iwxeb8004",
"payment_id": "pay_Y6U7NOWLCP5173",
"amount": "20000",
"notes": "rejected product"
}'

Response#

{
"data": {
"id": "rfn_qfrsL0tlnT0308",
"ref_id": "reference_1",
"amount": "20000.00",
"refund_type": "partial",
"status": "approved",
"created_at": "2021-07-20T10:43:42.201587Z",
"updated_at": "2021-07-20T10:43:42.401256Z",
"approved_at": "2021-07-20T10:43:42.401256Z",
"source": "api",
"customer_id": "cus_9eGU1Iwxeb8004",
"customer_name": "joe",
"customer_email": "jade@sfs.com",
"customer_phone": ""
}
}