Notification on BI-SNAP disbursement will remain the similar with the previous (non BI-SNAP) specification. There will be an additional parameter that we sent for BI-SNAP disbursement which is partner_reference_no that contain unique ID that is sent from Merchant. The way to validate our notification will also remain the same, please refer to this docs.
Monetary Value
All monetary is serialized as JSON string, with some restrictions:
- Only contains numeric characters and a
.character as a decimal-fraction separator. - Has at most 2 decimal-fraction digits.
Example of valid monetary values:
"10000""10000.0""10000.00"
Note
Decimal rounding might take place if the decimal fraction value is not equal to
.0
Status
| Status Name | Description | Possible Change(s) |
|---|---|---|
approved | Payout request is approved by approver user | processedcompletedfailed |
rejected | Payout rejected due to error on validation | Terminal state |
processed | Payout request is sent to the bank and currently being processed by the bank. There are 2 kind of processed status:1. If it's a payout using SKN/RTGS, processed means we have sent the request to the respected bank, and it's currently being processed on bank side and will be updated to be either completed or failed on the same working day before midnight.2. If the disbursement request got issues on the bank side, merchant will also received processed status, whereby we need to do reconciliation and the status will be updated to either completed or failed on D+1 working day. | completedfailed |
completed | Payout request is sent to the bank and received by beneficiary account | failedThis can happened if there's refund from bank. |
failed | Payout didn't go through | Terminal State |
Payout Notification Payload
| Parameter | Description |
|---|---|
| reference_no | Unique reference_no of a payout |
| amount | Amount of the processed payout |
| status | Status of the payout, please refer to here as reference. |
| updated_at | Payout status update time in ISO8601 format |
| partner_reference_no | Contain unique ID that is sent by merchant on the disbursement request for partnerReferenceNo field. |
| error_code | In case payout is failed we will send an error code, related to the failed payout failed payout error code and messages |
| error_message | In case payout is failed we will send an error message, related to the failed payout failed payout error code and messages |
Top up Notification Payload
| Parameter | Description |
|---|---|
| transaction_id | Unique id generated by Midtrans for top up to Bank |
| order_id | Unique id generated by Payouts |
| gross_amount | Amount topped up |
| status | topup |
| transaction_time | Transaction time in ISO8601 format |