Notification

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	`processed` `completed` `failed`
`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: 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. 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.	`completed` `failed`
`completed`	Payout request is sent to the bank and received by beneficiary account	`failed` This 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