Skip to main content
POST
/
api
/
v1
/
fiatAccounts
/
curl --request POST \
  --url https://skala-sandbox.ripio.com/api/v1/fiatAccounts/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customerId": "964c8c8c-573d-4f8f-bd2e-8645c3124e74",
  "paymentMethodType": "bank_transfer",
  "accountFields": {
    "alias_or_cvu_destination": "0100000000000000000001"
  }
}'
{
  "fiatAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fiatAccountFields": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "status": "PROCESSING",
  "paymentMethodType": "<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.

​
paymentMethodType
string
required

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

​
accountFields
object
required

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

Examples:
{
  "alias_or_cvu_destination": "0100000000000000000001"
}
{ "clabe_destination": "706180196550550550" }

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"

​
paymentMethodType
string
required

Type of the fiat account.

​
customerId
string<uuid>
required

The unique identifier of the customer owning this account.