POST
/
api
/
v1
/
fiatAccounts
/
Create Fiat Account
curl --request POST \
  --url https://skala-sandbox.ripio.com/api/v1/fiatAccounts/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accountType": "<string>",
  "accountFields": {
    "alias_or_cvu_destination": "0100000000000000000001"
  }
}'
{
  "fiatAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fiatAccountFields": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "status": "PROCESSING",
  "accountType": "<string>",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.

Body

application/json

Details for the new fiat account.

​
customerId
string<uuid>
required

The unique identifier of the customer for whom the account is being created.

​
accountType
string
required

An enumerated value specifying the type of fiat account. Valid options depend on supported payment rails. (e.g., CBU_ALIAS_AR, PIX_BR)

​
accountFields
object
required

A dictionary containing additional information required for the specific fiat account type. Fields depend on 'accountType' and are defined by /fiatAccounts/requirements/.

Example:
{
  "alias_or_cvu_destination": "0100000000000000000001"
}

Response

Fiat account created successfully.

​
fiatAccountId
string<uuid>
required

The unique identifier of the fiat account.

​
fiatAccountFields
object
required

A dictionary containing the details provided for the fiat account.

​
createdAt
string<date-time>
required

The date and time the fiat account was created (UTC format).

​
status
enum<string>
required

An enumerated value specifying the fiat account status.

Available options:
PROCESSING,
ENABLED,
DISABLED
Example:

"PROCESSING"

​
accountType
string
required

Type of the fiat account.

​
customerId
string<uuid>
required

The unique identifier of the customer owning this account.