Skip to content

[fund disbursement] add amount decimal points, fix callback parameter table, receipt_url param #333

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fahrezahafiz merged 6 commits into from
Jan 15, 2026
Merged

[fund disbursement] add amount decimal points, fix callback parameter table, receipt_url param #333

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
9de8e0d
fix callback parameter table
fahrezahafiz Jan 14, 2026
9e094ab
add decimal points in get status and callback responses
fahrezahafiz Jan 14, 2026
117f6fc
format json
fahrezahafiz Jan 14, 2026
9ae2ac2
add note for amount
fahrezahafiz Jan 14, 2026
a1d7b74
add receipt_url param in callback and get status
fahrezahafiz Jan 15, 2026
09466b6
fix receipt base url
fahrezahafiz Jan 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 26 additions & 24 deletions source/includes/_fund_disbursement.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -353,35 +353,36 @@ Below is the list of Explanation for column state details that show on response

```json
{
"status":{
"code":"000",
"message":"Success"
"status": {
"code": "000",
"message": "Success"
},
"amount":10000,
"recipient_name":"John Doe",
"recipient_bank":"014",
"recipient_account":"12341234",
"amount": 10000.0000,
"recipient_name": "John Doe",
"recipient_bank": "014",
"recipient_account": "12341234",
"trx_id": "d23ed68a-2a31-43a8-ac6f-15c0b45565c9",
"partner_trx_id": "TRX-20231211-007",
"timestamp": "11-12-2023 05:07:20",
"created_date": "11-12-2023 05:06:20",
"last_updated_date": "11-12-2023 05:07:00"
"last_updated_date": "11-12-2023 05:07:00",
"receipt_url": "https://api.oyindonesia.com/api/receipt?partner_trx_id=TRX-20231211-007&trx_id=d23ed68a-2a31-43a8-ac6f-15c0b45565c9"
}
```

> Response for failed callback:

```json
{
"status":{
"code":"300",
"message":"Failed"
"status": {
"code": "300",
"message": "Failed"
},
"tx_status_description":"Your transaction amount exceeds maximum routing limit. Please adjust the routing and try again",
"amount":10000,
"recipient_name":"John Doe",
"recipient_bank":"014",
"recipient_account":"12341234",
"tx_status_description": "Your transaction amount exceeds maximum routing limit. Please adjust the routing and try again",
"amount": 10000.0000,
"recipient_name": "John Doe",
"recipient_bank": "014",
"recipient_account": "12341234",
"trx_id": "d23ed68a-2a31-43a8-ac6f-15c0b45565c9",
"partner_trx_id": "TRX-20231211-007",
"timestamp": "11-12-2023 05:07:20",
Expand All @@ -401,10 +402,8 @@ We also have a resend callback feature which you can read about [here](https://d
Parameter | Type | Description
--------- | ---- | -----------
status | Object | Status of Disbursement in Object `{code: <status_code>, message: <status_message>}`
tx_status_description | String(255) | Additional information regarding status code, especially for Failed transactions, Force Credit transactions, and Queued transactions.
For example: “Account is blocked. Please create a new transaction with a different recipient account number.”
Note: This parameter will not appear in the response body for transactions with a Success status.
amount | BigInteger | Amount to disburse.
tx_status_description | String(255) | Additional information regarding status code, especially for Failed transactions, Force Credit transactions, and Queued transactions.<br><br>For example: “Account is blocked. Please create a new transaction with a different recipient account number.”<br><br>Note: This parameter will not appear in the response body for transactions with a Success status.
amount | BigDecimal | Amount to disburse.<br><br>Note: The amount field uses BigDecimal to maintain financial precision.<br>Decimal values (e.g. `10000.0000`) may appear in Get Disbursement Status and Callback responses due to standardized internal processing.
recipient_name | String(255) | Account holder name of recipient bank account.
recipient_bank | String(255) | Bank or Ewallet code of the recipient’s account, please refer to [Disbursement Bank Codes](#disbursement-bank-codes-)
recipient_account | String(255) | Recipient bank account number.
Expand All @@ -413,6 +412,7 @@ partner_trx_id | String(255) | Unique disbursement ID which partner put on the r
timestamp | String(19) | Time of API get disbursement status called by partner ("dd-MM-yyyy HH:mm:ss in UTC time zone").
created_date | String(19) | Execution time of disbursement in OY! system ("dd-MM-yyyy HH:mm:ss in UTC time zone").
last_updated_date | String(19) | Latest status change of a disbursement. Example from 'Pending' to 'Success' ("dd-MM-yyyy HH:mm:ss in UTC Time zone")
receipt_url | String(255) | URL to download the transaction receipt. Contact our business representative to activate this parameter.

### Transaction Status: API Disbursement
Below is the list of response codes that show the transaction status for Disbursement Callback:
Expand Down Expand Up @@ -608,15 +608,16 @@ print(data.decode("utf-8"))
"message":"Success"
},
"tx_status_description":"",
"amount":10000,
"amount":10000.0000,
"recipient_name":"John Doe",
"recipient_bank":"014",
"recipient_account":"12341234",
"trx_id": "d23ed68a-2a31-43a8-ac6f-15c0b45565c9",
"partner_trx_id": "TRX-20231211-007",
"timestamp": "11-12-2023 05:07:20",
"created_date": "11-12-2023 05:06:20",
"last_updated_date": "11-12-2023 05:07:00"
"last_updated_date": "11-12-2023 05:07:00",
"receipt_url": "https://api.oyindonesia.com/api/receipt?partner_trx_id=TRX-20231211-007&trx_id=d23ed68a-2a31-43a8-ac6f-15c0b45565c9"
}
```

Expand All @@ -629,7 +630,7 @@ print(data.decode("utf-8"))
"message":"Failed"
},
"tx_status_description":"Your transaction amount exceeds maximum routing limit. Please adjust the routing and try again",
"amount":10000,
"amount":10000.0000,
"recipient_name":"John Doe",
"recipient_bank":"014",
"recipient_account":"12341234",
Expand Down Expand Up @@ -663,7 +664,7 @@ Parameter | Type | Description
--------- | ---- | -----------
status | Object | Status of Disbursement in Object `{code: <status_code>, message: <status_message>}`
tx_status_description | String(255) | Additional information of status code, especially for failed status. E.g. Account is blocked. Please create a new transaction with a different recipient account number.
amount | BigInteger | Amount to disburse.
amount | BigDecimal | Amount to disburse.<br><br>Note: The amount field uses BigDecimal to maintain financial precision.<br>Decimal values (e.g. `10000.0000`) may appear in Get Disbursement Status and Callback responses due to standardized internal processing.
recipient_name | String(255) | Account holder name of recipient bank account.
recipient_bank | String(255) | Bank or Ewallet code of the recipient’s account, please refer to [Disbursement Bank Codes](#disbursement-bank-codes-)
recipient_account | String(255) | Recipient bank account number.
Expand All @@ -672,6 +673,7 @@ partner_trx_id | String(255) | Unique disbursement ID which partner put on the r
timestamp | String(19) | Time of API get disbursement status called by partner ("dd-MM-yyyy HH:mm:ss in UTC time zone").
created_date | String(19) | Execution time of disbursement in OY! system ("dd-MM-yyyy HH:mm:ss in UTC time zone").
last_updated_date | String(19) | Latest status change of a disbursement. Example from 'Pending' to 'Success' ("dd-MM-yyyy HH:mm:ss in UTC Time zone")
receipt_url | String(255) | URL to download the transaction receipt. Contact our business representative to activate this parameter.

### Response Code: API Get Disbursement Status

Expand Down