Refund Payment

Refund a Direct Debit payment using the SNAP API.

Refund a completed Direct Debit payment.

Endpoint

Environment	Method	URL
Development	POST	https://devo.finnet.co.id/snap/v2.0/debit/refund
Production	POST	TBD

Header Request

No	Name	Type	Mandatory	Description
1	X-SIGNATURE	string	M	Request signature. See Signature. Example: {{signature}}.
2	X-TIMESTAMP	string	M	Request timestamp. Example: {{timestamp}}.
3	X-PARTNER-ID	string	M	Partner identifier. Example: cM8GIPvoEpzLaHQfvL1e9g.
4	X-EXTERNAL-ID	string	M	External reference identifier. Example: {{external-id}}.
5	CHANNEL-ID	string	M	Channel identifier. Example: drbt.
6	test	string	M	Testing flag. Example: true.

Body Request

Content-Type: application/json

No	Name	Type	Mandatory	Description
1	originalPartnerReferenceNo	string	M	Original partner reference number from the original payment.
2	originalReferenceNo	string	M	Original reference number from Finnet for the original payment.
3	partnerRefundNo	string	M	Partner refund reference number.
4	refundAmount	object	M	Refund amount.
5	refundAmount.value	string	M	Refund amount value. Example: 1000.00.
6	refundAmount.currency	string	M	Currency. Example: IDR.
7	reason	string	M	Refund reason.
8	additionalInfo	object	M	Additional info for refund processing.
9	additionalInfo.callbackUrl	string	M	Callback URL for refund notification.
10	additionalInfo.settlementAccount	string	M	Settlement account number.

Sample Request

{
  "originalPartnerReferenceNo": "377547569889",
  "originalReferenceNo": "238885920712",
  "partnerRefundNo": "897981723",
  "refundAmount": {
    "value": "1000.00",
    "currency": "IDR"
  },
  "reason": "Customer complain",
  "additionalInfo": {
    "callbackUrl": "https://5fdc5f1948321c00170119e0.mockapi.io/api/v1/simulation/simulation",
    "settlementAccount": "020601000109305"
  }
}

Body Response

200 OK

Returns application/json.