Skip to main content
PUT
/
transfer
/
fiat-accounts
/
{id}
curl --request PUT \
  --url https://api.paxos.com/v2/transfer/fiat-accounts/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fiat_account_owner": {
    "person_details": {
      "first_name": "John",
      "last_name": "Smith"
    }
  }
}'
{
  "id": "dde1b3c5-d02a-48f6-8d11-16b4f532ea49",
  "ref_id": "test_ref_id_1",
  "identity_id": "c6ea91da-8f33-4545-9bdf-3cf29b4041d7",
  "account_id": "91f91384-30d4-46c2-9118-7f3cec676a2c",
  "fiat_account_owner": {
    "person_details": {
      "first_name": "John",
      "last_name": "Smith"
    },
    "fiat_network_instructions": {
      "wire": {
        "account_number": "12345678",
        "fiat_account_owner_address": {
          "country": "USA",
          "address1": "456 Main Street, NY",
          "city": "New York",
          "province": "NY",
          "address2": "",
          "zip_code": "10101"
        },
        "routing_details": {
          "routing_number_type": "ABA",
          "routing_number": "123456789",
          "bank_name": "Customers Bank",
          "bank_address": {
            "country": "USA",
            "address1": "123 Bank Street",
            "city": "New York",
            "province": "NY",
            "address2": "",
            "zip_code": "10101"
          }
        }
      },
      "status": "PENDING",
      "metadata": {
        "test_ref_id": "47aa7538-e2d2-47b3-8600-44a7965dd357",
        "transaction_attempt": 1
      }
    }
  },
  "created_at": "2023-09-24T14:15:22Z",
  "updated_at": "2023-09-24T14:15:22Z"
}
OAuth Scope
transfer:write_fiat_account

Authorizations

​
Authorization
string
header
required

Paxos APIs use OAuth 2 with the client credentials grant flow.

Token URLs:

Learn more in the API credentials guide →

Path Parameters

​
id
string
required

The Paxos fiat account ID (UUID). The Fiat Account ID (id) is provided in the response of the Create Fiat Account. Use this ID to retrieve the instructions using Get Fiat Account & List Fiat Accounts.

Body

application/json
​
fiat_account_owner
object
​
fiat_network_instructions
object
​
metadata
object

Optional client-specified metadata. Up to 6 key/value pairs may be provided. Each key and value must be less than or equal to 100 characters.

Response

A successful response.

​
id
string
required

The Paxos FiatAccount ID (UUID).

​
fiat_network_instructions
object
required
​
status
enum<string>
required
Available options:
PENDING,
APPROVED,
REJECTED
​
created_at
string<date-time>
required

The time at which this FiatAccount was created.

​
ref_id
string

The optional client-specified ID (for idempotence).

​
identity_id
string

The Paxos Identity (identity_id) of the user's FiatAccount.

​
account_id
string

The Paxos Account (account_id) of the user's FiatAccount. Required only for customers with 3rd-Party integrations initiating transfers on behalf of their end users.

​
fiat_account_owner
object
​
metadata
object

Optional client-specified metadata. Up to 6 key/value pairs may be returned. Each key and value must be less than or equal to 100 characters.

​
updated_at
string<date-time>

The time at which this FiatAccount record was most recently updated.