Create Beneficiary

Save a bank account or e-wallet for future disbursements.

Endpoint

POST /v1/beneficiaries

Request Body

Field	Type	Required	Description
channel	string	Yes	BANK or EWALLET
label	string	No	Friendly name (e.g., "Main Supplier")
bank_short_code	string	If channel=BANK	Bank code (e.g., BCA)
account_number	string	If channel=BANK	Bank account number
account_name	string	No	Account holder name
ewallet_provider	string	If channel=EWALLET	E-wallet code (e.g., GOPAY)
ewallet_phone	string	If channel=EWALLET	E-wallet phone number
is_default	boolean	No	Set as default beneficiary (unsets the previous default)

Example — Bank Account

cURL

curl -X POST https://api.nusio-saka.com/v1/beneficiaries \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "BANK",
    "label": "Main Supplier",
    "bank_short_code": "BCA",
    "account_number": "1234567890",
    "account_name": "PT Supplier Indonesia",
    "is_default": true
  }'

Example — E-wallet

cURL

curl -X POST https://api.nusio-saka.com/v1/beneficiaries \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "EWALLET",
    "label": "Driver Account",
    "ewallet_provider": "GOPAY",
    "ewallet_phone": "08123456789"
  }'

Response

HTTP 201 Created

{
  "success": true,
  "data": {
    "id": "uuid",
    "organization_id": "uuid",
    "merchant_id": "uuid",
    "label": "Main Supplier",
    "channel": "BANK",
    "bank_id": "uuid",
    "account_number": "1234567890",
    "account_name": "PT Supplier Indonesia",
    "ewallet_provider": null,
    "ewallet_phone": null,
    "verification_status": "PENDING",
    "verified_name": null,
    "is_default": true,
    "is_enabled": true,
    "created_at": "2026-06-01T10:00:00Z",
    "updated_at": "2026-06-01T10:00:00Z"
  }
}

Once created, pass the beneficiary id as beneficiary_id when creating a disbursement to skip re-entering account details.