Skip to main content

​
What can I do with the Fiat Transfers API?

The Fiat Transfers API moves USD onto and off the Paxos platform. The public API documentation describes Wire (Fedwire or SWIFT) and CUBIX workflows. For eligible clients on enabled bank integrations, fiat movement may also use RTP, FedNow, or same-bank book (intrabank) transfers. Rail availability depends on the bank, transfer direction, account setup, and client integration; not every rail is available for every customer or for both deposits and withdrawals. Use the deposit instructions endpoints to receive funds, and create a Fiat Account plus a withdrawal request to send funds to an external bank account where supported. You can fund a corporate account or, in supported end-user integrations, move funds for users. The required identity and account information depends on your integration type. Third-party bank-account ownership is not a blanket guarantee. Name-matching controls, approved exceptions, and applicable compliance requirements may apply. Confirm that your use case and account arrangement are supported before initiating a transfer.

​
How do I get the Identity ID required in requests?

You do not need to provide an identity_id in every Fiat Transfers request. It is required for third-party integrations initiating transfers on behalf of end users. For those flows, use the Identity API to create or manage an end-user identity, and provide the required identity_id and account_id for the relevant endpoint. Whether your integration needs end-user identities depends on its setup. For corporate-account identity details, contact Paxos. See the Identity API, Create Fiat Account, and Create Fiat Withdrawal.

​
How do I input the routing number (ABA) for US wires (Fedwire)?

When creating a Fiat Account for a US wire, use the wire object under fiat_network_instructions and set routing_details.routing_number_type to ABA:
See Create Fiat Account.

​
How do I input the SWIFT/BIC code for SWIFT wires?

When creating a Fiat Account for an international (SWIFT) wire, use the wire object under fiat_network_instructions and set routing_details.routing_number_type to SWIFT. Provide the bank’s SWIFT/BIC in the routing_number field:
See Create Fiat Account.

​
Do I need JWS request signing?

JWS request signing is recommended as an additional security control for fiat withdrawals, but it is not enabled automatically: Paxos must activate it for your API credential. Once enabled, Paxos rejects unsigned requests to authenticated endpoints using that credential. You sign requests with a client-controlled private key whose public key is registered with Paxos. Request signing can help protect your account if your API credentials are compromised; it is not a guarantee that unauthorized activity is impossible. See Request Signing.

​
How do I retrieve fiat account information?

Use Get Fiat Account to retrieve the full Fiat Account details, including the full account number and beneficiary name and address. List Fiat Accounts returns abbreviated account details: it omits beneficiary name and address and includes only the last four digits of the account number.

​
Are there fees associated with fiat transfers?

Refer to Agreements on the Dashboard for current fee details.