Skip to main content
How connected account wallets work, what currencies are supported, and how to retrieve and manage balances.
Every connected account has a multi-currency wallet. Funds received into the account are held in the wallet under the currency in which they were received. Your platform can read balances, move funds between the platform wallet and connected account wallets, and trigger conversions.

​
How wallets work

A wallet is a logical container for funds within a connected account. Each connected account has a single wallet, but that wallet can hold balances in multiple currencies simultaneously.
  • Inbound AUD payments credit the AUD balance.
  • Inbound USDT credits the USDT balance.
  • FX conversions move value between currency balances within the same wallet.
  • Payouts debit the relevant currency balance.
Funds never leave PIK custody until a payout is executed to an external bank account.

​
Supported currencies

AUD (Australian Dollar) — supports inbound, hold, convert, and payout. USD (US Dollar) — supports inbound, hold, convert, and payout. USDT (Tether) — supports inbound, hold, convert, and payout. HKD (Hong Kong Dollar) — supports inbound, hold, convert, and payout. SGD (Singapore Dollar) — supports inbound, hold, convert, and payout. PIK is a non-China market platform. CNY is not supported. Contact your PIK account manager for the full up-to-date list of supported currencies and corridors.

​
Retrieve wallet balances

Call GET /api/v1/accounts//wallet/balances with your platform token and the x-on-behalf-of header set to the connected account ID. The response returns a list of currency balances. Each entry includes:
  • currency — The currency code, for example AUD or USDT.
  • available — Funds available for conversion or payout right now.
  • pending — Inbound funds that have been received but not yet settled.

​
Move funds from your platform wallet to a connected account

Platforms can top up a connected account wallet directly from the platform wallet by calling POST /api/v1/transfers. Specify the destination connected account ID, the currency, the amount, and an optional reference string for your own records.

​
Collect fees from a connected account

To deduct a platform fee from a connected account back into your platform wallet, call POST /api/v1/transfers with the source set to the connected account ID and the destination set to your platform wallet. You can only collect fees up to the connected account’s available balance. Transfers that exceed the available balance will return a 402 insufficient funds error.