...DuitNow PayIntegrationRefund Status

Enquire Refund Status

Use this to retrieve the status of a refund if the webhook update refund status fails to deliver the update. This inquiry should only be performed once and at least one hour after the initial refund requested.

Process Flow

Step	Sender	Receiver	Process
1	Acquirer	API Gateway	Initiate a refund enquiry request to API Gateway.
2	API Gateway	Acquirer	API Gateway will respond with latest refund status.

Request

GET /v1/bw/refund?refundId=f36b4c31-44b2-40f2-820a-7fbd081cae9b

refundId	String	Max length: 36		Required
The unique external identifier (uuid v4) provided by the acquirer to PayNet when initiating a refund request.

Response

Data Object
checkoutId	String	Max length: 36		Required
The similar checkoutId parsed during the first payment initiated.
endToEndId	String	Max length: 35		Required
Unique message identification from RPP. This can be used to reconcile with RPP BackOffice or Reports.
code	String	Max length: 4		Required
Plese refer to the list of status codes in the appendix.
refundStatus	String	Max length: 35		Required
The refund status are as below: REFUND_PENDING - Refund is in progress REFUND_ACCEPTED - Refund sent to issuing bank for processing REFUND_REJECTED - Refund unable to process, refer to message field for the reasons REFUND_TIMEOUT - Refund timeout due to processing delay. Please verify the refund status in the next day report.
issuer	String	Max length: 100		Required
Name of payer’s issuing bank
paymentMethod	String	Max length: 2		Required
The paymentMethod selected during the first payment initiated.
amount	String	Max length: 18		Required
The amount requested for the refund.
End Data Object
message	String	Max length: 1024		Required
Please refer to the list of reason codes in the appendix.

Sample Response:

{
    "data": {
        "checkoutId": "b4e6c575-5393-4a1e-a231-269e9a3f8af3",
        "endToEndId": "20240927M0000201861OBW00000001",
        "refundStatus": "REFUND_PENDING",
        "issuer": "Ambank",
        "paymentMethod": "01",
        "amount": "10.00"
    },
    "message": "OK"
}