Handling Payment Notification
Before process any further step, make sure you have been configure Notification URL in our merchant portal.
After initiate payment, our system will be triggering Webhook that will send payment result your Notification URL.
Endpoint
https://callback.example.com/your-notification-url
Headers
- Name
X-Signature- Type
- string
- Description
Read Signature Generation for more information.
- Name
X-Request-Time- Type
- YYYY-MM-DDTHH:mm:ssZ
- Description
Request Time should be ISO 8601 and will be used to generate Signature.
- Name
Content-Type- Type
- application/json
- Description
Content type application/json
Body
- Name
paymentCode- Type
- string
- Description
Payment that is available API Endpoint.
- Name
referenceNumber- Type
- string
- Description
Your own reference number, can be uuid, or some id generator.
- Name
status- Type
- string
- Description
Payment status.
- Name
customerName- Type
- string
- Description
Customer name.
- Name
customerEmail- Type
- string
- Description
Customer email.
- Name
customerPhoneNumber- Type
- string
- Description
Customer phone number.
- Name
finishNotifyUrl- Type
- string
- Description
Your Backend notify endpoint.
- Name
finishReturnUrl- Type
- string
- Description
Your Backend callback endpoint.
- Name
paymentDest- Type
- string
- Description
Payment destination. Can be VA Number, QR Text and Redirect URL.
- Name
paymentDestName- Type
- string
- Description
Payment destination name.
- Name
paymentDestType- Type
- string
- Description
Payment destination type. Can be "DIRECT", "REDIRECT" and "DEEPLINK"
- Name
expiredAt- Type
- string
- Description
Expired payment in format RFC 3339.
- Name
totalAmount- Type
- number
- Description
Total amount.
- Name
fee- Type
- number
- Description
Fee of service payment.
Request
Example
{
"fee": 3500,
"status": "PAID",
"expiredAt": "2024-09-20T20:32:36+07:00",
"paymentCode": "VA-BNI",
"paymentDest": "3597080155666076",
"paymentName": "BNI Virtual Account",
"totalAmount": 15000,
"customerName": "Joey Jacobi",
"customerEmail": "[email protected]",
"totalReceived": 11500,
"finishNotifyUrl": "https://maribel.net",
"finishReturnUrl": "https://mattie.info",
"paymentDestType": "DIRECT",
"referenceNumber": "a3c5b0b0-2b3d-4444-9fe6-f1b662d1090d",
"transactionNumber": "BJP-XE087-1C7F43A174C98208249214",
"customerPhoneNumber": "62892312233445"
}
Response
Example
// Merchant should provide below response
{
"code": "OK", // Check Response Code List
"message": "Success", // Check Response Message List
}