BillingCostBasis

object

Describes currency basis supported by billing system.

idstringrequiredread-only

ULID (Universally Unique Lexicographically Sortable Identifier).

Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Example:01G65Z755AFWAKHE12NY0CQ9FH

fiat_codestringrequired

The fiat currency code for the cost basis.

Match pattern:^[A-Z]{3}$

>= 3 characters<= 3 characters

Example:USD

ratestringrequired

The cost rate for the currency.

Match pattern:^\-?[0-9]+(\.[0-9]+)?$

effective_fromstring(date-time)

An ISO-8601 timestamp representation of the date from which the cost basis is effective.
If not provided, it will be effective immediately and will set to now by the system.

Example:2023-01-01T01:01:01.001Z

created_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity creation date.

Example:2023-01-01T01:01:01.001Z

Example

BillingCurrency

object

Fiat or custom currency.

One Of
idstringrequiredread-only

ULID (Universally Unique Lexicographically Sortable Identifier).

Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Example:01G65Z755AFWAKHE12NY0CQ9FH

typestringrequiredread-only

The type of the currency.

Allowed values:fiat

namestringrequired

The name of the currency. It should be a human-readable string that represents the name of the currency, such as “US Dollar” or “Euro”.

>= 1 characters<= 256 characters

descriptionstring

Description of the currency.

>= 1 characters<= 256 characters

symbolstring

The symbol of the currency. It should be a string that represents the symbol of the currency, such as “$” for US Dollar or “€” for Euro.

>= 1 characters

codestringrequiredread-only

Three-letter ISO4217 currency code.
Custom three-letter currency codes are also supported for convenience.

Match pattern:^[A-Z]{3}$

>= 3 characters<= 3 characters

Example:USD

Example

BillingCurrencyCodeCustom

string

Custom currency code.
It should be a unique code but not conflicting with any existing fiat currency codes.

>= 3 characters<= 24 characters

BillingCurrencyCustom

object

Describes custom currency.

idstringrequiredread-only

ULID (Universally Unique Lexicographically Sortable Identifier).

Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Example:01G65Z755AFWAKHE12NY0CQ9FH

typestringrequiredread-only

The type of the currency.

Allowed values:custom

namestringrequired

The name of the currency. It should be a human-readable string that represents the name of the currency, such as “US Dollar” or “Euro”.

>= 1 characters<= 256 characters

descriptionstring

Description of the currency.

>= 1 characters<= 256 characters

symbolstring

The symbol of the currency. It should be a string that represents the symbol of the currency, such as “$” for US Dollar or “€” for Euro.

>= 1 characters

codestringrequired

Custom currency code.
It should be a unique code but not conflicting with any existing fiat currency codes.

>= 3 characters<= 24 characters

created_atstring(date-time)read-only

An ISO-8601 timestamp representation of the custom currency creation date.

Example:2023-01-01T01:01:01.001Z

Example

BillingCurrencyFiat

object

Currency describes a currency supported by the billing system.

idstringrequiredread-only

ULID (Universally Unique Lexicographically Sortable Identifier).

Match pattern:^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Example:01G65Z755AFWAKHE12NY0CQ9FH

typestringrequiredread-only

The type of the currency.

Allowed values:fiat

namestringrequired

The name of the currency. It should be a human-readable string that represents the name of the currency, such as “US Dollar” or “Euro”.

>= 1 characters<= 256 characters

descriptionstring

Description of the currency.

>= 1 characters<= 256 characters

symbolstring

The symbol of the currency. It should be a string that represents the symbol of the currency, such as “$” for US Dollar or “€” for Euro.

>= 1 characters

codestringrequiredread-only

Three-letter ISO4217 currency code.
Custom three-letter currency codes are also supported for convenience.

Match pattern:^[A-Z]{3}$

>= 3 characters<= 3 characters

Example:USD

Example