Refund Notification

Refund Notification

For Sandbox Environment, beneficiaryAccountNumber parameter must be 7746555134

post

This API is used to notify partners when a refund occurs in the KIRIMDOKU system. KIRIMDOKU will notify partners with the URL that has been registered, and the notification will be done maximum 3 times or until the notification callback response is correct. If partners don't want to implement Refund Notification API, they may opt to call the Transaction Info API to fetch the status of a transaction. To receive refund notifications, partners are required to prepare Callback URLs for sandbox and production environments. In the sandbox environment, the notification will be sent in 5 minutes after the partner hits the remit API.

Path parameters
merchantUrlRefundNotificationstringRequired

Merchant url path for receiving Refund notification by KIRIMDOKU provided by partner

Header parameters
requestIdstringRequired

Unique reference identification sent by the API partner.

Example: fd53b1e3-9c35-4dfa-a95ca8dbc5695485
agentKeystringRequired

Hash key of authorization agent

Example: A41418
signaturestringRequired

Unique authorization code generated by partner validated by KIRIMDOKU

Example: ieNOENDdN4MnectGytx5UvmOfASZ2oGWMCJ8gVqkw3tB98ofgY9cbxSeY4IYoYeoKs+0QP4h8BTBhemlfeXp1w==
Content-TypestringRequired

The Content-Type field indicates that JSON type is acceptable to send to the recipient

Example: application/json
Body
transactionIdstring · max: 16RequiredExample: DK0018353
activityCodestringRequired

Specific notification code

Example: 200
messagestringRequired

Notification message “Transaction is Success” or “Transaction is Failed”

Example: Transaction is Refunded
processDatestringRequired

Update time in yyyy-MM-ddTHH:mm:ss format

Example: 2024-01-12'T'07:30:12
Responses
200

Notification processed Successfully

application/json
post
POST /{merchantUrlRefundNotification} HTTP/1.1
Host: {merchant-domain}
requestId: text
agentKey: text
signature: text
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "transactionId": "DK0018353",
  "activityCode": "200",
  "message": "Transaction is Refunded",
  "processDate": "2024-01-12'T'07:30:12"
}
200

Notification processed Successfully

{
  "status": true,
  "transactionId": "DK0018353",
  "responseCode": "00",
  "responseMessage": "Successfully processed"
}

Last updated

Was this helpful?