Settlements

Settlements are periodic payouts from the platform to your bank account. For WALLET merchants, funds accumulate in your wallet and are disbursed on demand. For MANUAL merchants, the platform creates settlements on a scheduled basis.

Settlement Object

{
  "id": "uuid",
  "ref_code": "STL-260601-00023",
  "settlement_date": "2026-06-01",
  "period_start": "2026-05-25T00:00:00Z",
  "period_end": "2026-05-31T23:59:59Z",
  "gross_amount": 500000,
  "mdr_total": 3500,
  "platform_fee": 1000,
  "aggregator_fee": 1500,
  "refund_total": 0,
  "disbursement_fee": 250,
  "net_payout": 496250,
  "order_count": 12,
  "bank_id": "uuid",
  "account_number": "1234567890",
  "account_name": "PT Example Merchant",
  "status": "PAID",
  "created_at": "2026-06-01T08:00:00Z",
  "updated_at": "2026-06-01T09:15:00Z"
}

Key Fields

Field	Description
gross_amount	Total order amounts in the settlement period, in Rupiah
mdr_total	Total MDR charged to you, in Rupiah (deducted from gross)
refund_total	Total refunds processed, in Rupiah (deducted from gross)
disbursement_fee	Bank transfer fee for the settlement payout, in Rupiah
net_payout	Rupiah amount that lands in your bank account

Formula: net_payout = gross_amount - mdr_total - refund_total - disbursement_fee

Settlement Status

Status	Description
PENDING	Scheduled, awaiting processing
PROCESSING	Being transferred
PAID	Successfully transferred to your bank
FAILED	Transfer failed — contact support
CANCELLED	Cancelled by platform

List Settlements

GET /v1/settlements

Query Parameters: page, limit (see Pagination)

Response:

{
  "success": true,
  "data": [ ... ],
  "meta": { "page": 1, "limit": 10, "total": 3, "total_pages": 1 }
}

Get Settlement

GET /v1/settlements/:id

Returns a single settlement. :id must be the settlement UUID.

Error: INVALID_ID (400) if not a valid UUID; NOT_FOUND (404) if not found or belongs to another merchant.