Appearance
Payment Notify SNAP
Payment Notify feature allows merchants to receive final status (Success (00) or Failed (06)).
Name | API Direct Debit Payment Notify |
---|---|
Service Code | 56 |
Path | /{version}/debit/notify |
Version | 1.0 |
HTTP Method | POST |
Type Format | JSON |
Transaction status later will be sent as payment notification to your provided callback URL. The callback will be sent after the transaction status gets final status. The provided URL must return a HTTP Status Code 200 to iFortepay. Our Notification Callback will retry 3 times if the provided URL did not return HTTP Status Code 200 to iFortepay. We will hit your URL using HTTP Method POST request. The detail of the request header will be in a separate document.
Request Body
Field | Type | Mandatory | Length | Description |
---|---|---|---|---|
originalPartnerReferenceNo | String | O | 64 | Original transaction identifier on service consumer system |
originalReferenceNo | String | M | 64 | Original transaction identifier on service provider system |
merchantId | String | O | 64 | Merchant identifier that is unique per each merchant |
amount | Object | O | ||
amount.value | String (ISO4217) | M | 16,2 | Net amount of the transaction. If it's IDR then value includes 2 decimal digits. e.g. IDR 10.000,- will be placed with 10000.00 |
amount.currency | String | M | 3 | Currency |
latestTransactionStatus | String | M | 2 | 00 - Success 01 - Initiated 03 - Pending 04 - Refunded 06 - Failed 07 - Not Found |
transactionStatusDesc | String | O | 50 | Description status transaction |
createdTime | string | O | 25 | Transaction created time. |
finishedTime | string | O | 25 | Transaction finished time. |
additionalInfo | Object | O | Additional information |
Sample request:
sh
"originalPartnerReferenceNo": "QA-20240913-004",
"originalReferenceNo": "0191e99a-c403-7cb2-b653-48a54b3a45d7",
"merchantId": "IFP2024078302",
"amount": {
"value": "10000.00",
"currency": "IDR"
},
"latestTransactionStatus": "00",
"transactionStatusDesc": "Success",
"createdTime": "2024-09-13T11:18:40+07:00",
"finishedTime": "2024-09-13T11:18:40+07:00"
}