Skip to main content
How connected accounts receive inbound funds via local account numbers and crypto wallet addresses, and how incoming transfers are matched and settled.
Once a connected account has been verified and the inbound_payments capability is activated, PIK assigns it receiving details it can use to collect funds. The receiving details depend on the currency — USDT payments use a Solana wallet address, AUD payments use a local BSB and account number.

​
How inbound payments work

Inbound payments to a connected account follow this flow: Step 1 — PIK assigns receiving details. After activating the inbound_payments capability, PIK generates a unique receiving address or account number for the connected account. Retrieve these via GET /api/v1/accounts//receiving-details. Step 2 — The payer sends funds. The payer transfers funds to the assigned address or account number. For USDT, they send to the Solana wallet address. For AUD, they transfer to the BSB and account number using their bank’s transfer system. Step 3 — PIK detects the transfer. For USDT, PIK monitors the Solana blockchain for incoming transactions to the assigned address. For AUD, PIK monitors the assigned bank account for incoming transfers. Step 4 — Funds are settled to the connected account wallet. Once the incoming transfer is confirmed, PIK credits the funds to the connected account’s wallet balance in the received currency. The payment.settled webhook fires.

​
Retrieving receiving details

Call GET /api/v1/accounts//receiving-details with the x-on-behalf-of header set to the connected account ID. The response returns the receiving details for all currencies the account is enabled to receive. Each entry includes the currency, the receiving type (crypto_address or bank_account), and the relevant details. For USDT — the response includes the Solana wallet address assigned to this account. Every connected account gets a unique address. Do not share addresses between accounts. For AUD — the response includes the BSB number and account number assigned to this account. Every connected account gets a unique account number under PIK’s BSB.

​
Settlement timing

USDT (Solana) — Funds are detected and settled within minutes of the on-chain transaction being confirmed. Solana finality is typically under 30 seconds. PIK credits the balance once the transaction reaches finality. AUD (bank transfer) — Funds are typically settled within one business day of the transfer being received. Timing depends on the sending bank and the time of day the transfer was initiated.

​
Unmatched and partial transfers

PIK settles all incoming transfers to the connected account wallet for the currency received. Unlike payment links (which require an exact amount and reference match), receiving via a dedicated account number or wallet address does not require a reference. All funds sent to the assigned address are credited to that connected account. If you need to reconcile which customer or invoice a transfer relates to, instruct payers to include a reference in their transfer description. The reference appears in the transaction record and can be used for your own reconciliation.

​
Minimum inbound amounts

USDT — Minimum inbound amount is 1 USDT. Transfers below this amount are received but flagged for review. AUD — Minimum inbound amount is 1 AUD. Transfers below this amount are received but flagged for review. Contact PIK support to resolve any flagged low-value inbound transfers.