Skip to main content
POST
Create fee

Authorizations

Authorization
string
header
required

JWT obtained from /v2/auth/login

Body

application/json

Fee data to configure.

pair
enum<string>
required

Currency pair for the fee.

Available options:
USDC/BOB,
BOB/USDC,
USDT/BOB,
BOB/USDT,
USDT/PEN,
USDT/BRL,
USDT/CLP,
USDT/COP,
USDC/PEN,
USDC/BRL,
USDC/CLP,
USDC/COP,
USDT/USD,
USDC/USD,
USDT/EUR,
USDC/EUR,
EURC/EUR
Example:

"USDC/BOB"

transactionType
enum<string>
required

Transaction type to which the fee applies.

Available options:
deposit_express,
deposit_cash,
withdrawal_express,
withdrawal_ach,
withdrawal_pix,
deposit_crypto,
withdrawal_crypto,
prefunding,
deposit_card,
withdrawal_ach_us,
withdrawal_wire,
withdrawal_swift,
withdrawal_sepa
Example:

"withdrawal_express"

amount
number
required

Fee amount. Must be greater than zero.

Required range: x >= 0
Example:

0.5

type
enum<string>
required

PERCENTAGE applies to the exchange rate; FIXED applies to the total amount.

Available options:
FIXED,
PERCENTAGE
Example:

"PERCENTAGE"

Response

Fee created successfully.

pair
enum<string>
required

Currency pair configured for the fee.

Available options:
USDC/BOB,
BOB/USDC,
USDT/BOB,
BOB/USDT,
USDT/PEN,
USDT/BRL,
USDT/CLP,
USDT/COP,
USDC/PEN,
USDC/BRL,
USDC/CLP,
USDC/COP,
USDT/USD,
USDC/USD,
USDT/EUR,
USDC/EUR,
EURC/EUR
Example:

"USDC/BOB"

transactionType
enum<string>
required

Transaction type to which the fee applies.

Available options:
deposit_express,
deposit_cash,
withdrawal_express,
withdrawal_ach,
withdrawal_pix,
deposit_crypto,
withdrawal_crypto,
prefunding,
deposit_card,
withdrawal_ach_us,
withdrawal_wire,
withdrawal_swift,
withdrawal_sepa
Example:

"withdrawal_express"

amount
number
required

Fee amount.

Example:

0.5

feeType
enum<string>
required

Configured fee type.

Available options:
FIXED,
PERCENTAGE
Example:

"PERCENTAGE"

status
enum<string>
required

Fee validity status.

Available options:
CURRENT,
OLD
Example:

"CURRENT"

createdBy
object | null

User who created the fee.

Example:

"Partner User"

validUntil
object | null

Date until which the fee was valid, if it has been replaced.

Example:

"2026-05-12T12:00:00.000Z"

supersededBy
object | null

Fee that replaced this record, if present.

predecessor
object | null

Previous fee replaced by this record, if present.