Collection & disbursements

Collection and disbursement APIs move fiat from your Pretium wallet balance — without an on-chain transaction_hash. They share the same body shape as offramp / onramp, except transaction_hash and chain are omitted. Top up that balance with crypto via POST /account/fund then POST /account/fund/confirm.

Core endpoints

Action	Method	Path
Disburse	`POST`	`/{currency_code}/disburse`
Collect	`POST`	`/{currency_code}/collect`
Banks	`POST`	`/{currency_code}/banks`
Bank info	`POST`	`/{currency_code}/bank-infor`
Bank transfer	`POST`	`/{currency_code}/bank-transfer`
Status	`POST`	`/{currency_code}/status`

Full request and response examples: Collection & disbursement.

Auth

x-api-key = partner consumer key.

Currency prefixes

Prefix	Market
`/kes`	Kenya
`/ugx`	Uganda
`/ngn`	Nigeria
`/ghs`	Ghana
`/mwk`	Malawi
`/cdf`	DR Congo
`/etb`	Ethiopia
`/tzs`	Tanzania
`/zmw`	Zambia
`/rwf`	Rwanda (utilities)

When to use `/v1` instead

Use `/v1` pay / onramp	Use `/{currency_code}` collection & disbursement
Settling with on-chain hashes	Wallet-funded local rails
Crypto → fiat or fiat → crypto	Fiat in / out only
Single cross-market product surface	Market-specific collect / disburse

Payment locks

Collections and disbursements can be temporarily locked per country (400 with a maintenance-style message). Check POST /v2/exchange-rate for ramp flags on the unified API.

Get started

Guides

Collection & disbursements

Core endpoints

Auth

Currency prefixes

When to use `/v1` instead

Payment locks

​Core endpoints

​Auth

​Currency prefixes

​When to use /v1 instead

​Payment locks

Core endpoints

Auth

Currency prefixes

When to use `/v1` instead

Payment locks