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
/.00
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 or by the approver | 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. | 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 |
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 |
Note
- There might be a possibility that:
- Notification sent is not in the correct order
- Same notification sent more that once
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 |