AUD-only Customers
AUD-only Customers documentation for Compose Finance APIs and integrations.
Organizations with AUD collections enabled can create AUD-only customers: individuals who pay in Australian dollars to their own Australian bank details. Each payment converts to USDC on Base and is sent to your organization's embedded wallet.
- Create the customer with
"product": "aud_only"and"accountType": "individual", and theiremail(required;400without it). - Call
POST /customers/{customerId}/kycand send the customer thekycFlowLink. AUD-only customers verify on thecustomers-id-liveness-calevel, except those who get a new link on every call: call the endpoint again whenever you send them one. They send the samecustomer.kyc.*webhooks as other customers, withcustomer.kyc.submittedwhen their first KYC link is generated, and again when they continue after being asked for more information. - After approval, poll
GET /customers/{customerId}/deposit?currency=auduntil it stops returning409. The response gives the BSB and account number (paymentRail: "AU_BANK_TRANSFER"). - Read payments with
GET /customers/{customerId}/transactions. Each AUD payment is aDEPOSITwithpaymentRail: "AU_BANK_TRANSFER"and the payer's name inpayerName. AUD payments senddeposit.createdanddeposit.status_changedwebhooks like other deposits.
One set of details accepts NPP/Osko and BECS transfers. The scheme is not reported per transaction. AUD-only customers cannot use EUR/USD deposit details, virtual accounts, deposit wallets, withdrawal banks, withdrawals, developer fees, rate quotes or manual KYC upload; those endpoints return 400 with Not available for AUD-only customers, except that listing their virtual accounts, deposit wallets or withdrawal banks returns an empty list and looking one up returns 404.

