Regular Disbursement

Server

Create standard Brick Send Money payouts to bank accounts or supported Ewallet destinations. Use Regular Disbursement when real-time BI-FAST routing is not required or unavailable.

Regular Disbursement

POST

https://sandbox.onebrick.io

/v2/payments/gs/disbursements

publicAccessToken (header)

Create a regular disbursement to a bank account or supported Ewallet destination. Use this endpoint for standard payout workflows where BI-FAST is not required, not available, or not selected by your routing rules. Submit a unique reference ID and recipient details, then reconcile completion through callbacks, ledger records, or the disbursement status endpoints.

Testing in Sandbox Environment (Testing Mode)

To simulate various transaction statuses, use the sample inputs below when calling the Disbursement API in the sandbox environment:

Regular Disbursement

Bank Short Code	Bank Account Number	Bank Account Holder Name	Amount	Expected Status
MANDIRI	112233445	PROD ONLY	Rp29.999	Completed
BRI	112233445	PROD ONLY	Rp10.000 - Rp500.000.000	Processing
MANDIRI	112233445	PROD ONLY	Rp39.999	Failed
SINARMAS	112233445	PROD ONLY	Rp10.000 - Rp500.000.000	Failed with error 503 (Bank Under Maintenance)

Important Notes for Sandbox Testing:

Bank Account Number: Any number with more than 8 digits is acceptable.
Account Holder Name: Must always be exactly "PROD ONLY".
Amount: Must fall within the range of Rp10.000 to Rp500.000.000.
These values are hardcoded in our sandbox environment to help simulate specific response statuses.

Regular Disbursement › Request Body

referenceId

string · required

A unique reference ID as a unique identifier

Default: test-1

description

string · required

An arbitrary string attached to the object. Often useful for displaying to users what the transaction was for. Description length limit is 1000 chars.

Default: test-disbursement-1

amount

integer · int32 · required

Amount that you would like to send

Default: 29999

object · required

recipientEmail

string

POST/v2/payments/gs/disbursements

curl https://sandbox.onebrick.io/v2/payments/gs/disbursements \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'publicAccessToken: <api-key>' \
  --data '{
  "referenceId": "test-1",
  "description": "test-disbursement-1",
  "amount": 29999,
  "disbursementMethod": {
    "type": "bank_transfer",
    "bankAccountNo": "000123456789",
    "bankShortCode": "MANDIRI",
    "bankAccountHolderName": "Example Customer"
  },
  "recipientEmail": "recipientEmail"
}'

Example Request Body

{
  "referenceId": "test-1",
  "description": "test-disbursement-1",
  "amount": 29999,
  "disbursementMethod": {
    "type": "bank_transfer",
    "bankAccountNo": "000123456789",
    "bankShortCode": "MANDIRI",
    "bankAccountHolderName": "Example Customer"
  },
  "recipientEmail": "recipientEmail"
}

json

Regular Disbursement › Responses

200

No data returned

Example Responses

{
  "status": 200,
  "data": {
    "message": "We have received your request and are processing it, please check your callback URL for transaction status",
    "id": "example-disbursement-id",
    "type": "disbursement",
    "attributes": {
      "referenceId": "reference-id-from-your-system",
      "description": "reference-id-from-your-system",
      "amount": "100000",
      "feeAmount": "2000",
      "status": "processing",
      "settlementStatus": "null",
      "createdAt": "2022-07-21T13:49:39.752+07:00",
      "disbursementMethod": {
        "type": "bank_transfer",
        "bankAccountNo": "000123456789",
        "bankShortCode": "BCA",
        "bankAccountHolderName": "Example Customer"
      }
    }
  },
  "metaData": {
    "source": "API",
    "entity": "Payment"
  },
  "error": null
}

json

application/json