Skip to content

Payment Notify SNAP

Payment Notify feature allows merchants to receive final status (Success (00) or Failed (06)).

NameAPI Direct Debit Payment Notify
Service Code56
Path/{version}/debit/notify
Version1.0
HTTP MethodPOST
Type FormatJSON

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

FieldTypeMandatoryLengthDescription
originalPartnerReferenceNoStringO64Original transaction identifier on service consumer system
originalReferenceNoStringM64Original transaction identifier on service provider system
merchantIdStringO64Merchant identifier that is unique per each merchant
amountObjectO
amount.valueString (ISO4217)M16,2Net 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.currencyStringM3Currency
latestTransactionStatusStringM200 - Success 01 - Initiated 03 - Pending 04 - Refunded 06 - Failed 07 - Not Found
transactionStatusDescStringO50Description status transaction
createdTimestringO25Transaction created time.
finishedTimestringO25Transaction finished time.
additionalInfoObjectOAdditional 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"
}

iFortepay API Documentation