Skip to main content
POST
Create fee override

Authorizations

Authorization
string
header
required

API key as Bearer token

Headers

Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14
Example:

"2025-02-14"

Idempotency-Key
string

Unique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).

Required string length: 1 - 255

Body

Create an account-level fee override. The value unit must match the fee type.

type
enum<string>
required

Which cardholder fee to override.

Available options:
FX_MARKUP,
ATM_DOMESTIC_VARIABLE,
ATM_DOMESTIC_FIXED,
ATM_CROSS_BORDER_VARIABLE,
ATM_CROSS_BORDER_FIXED
Example:

"FX_MARKUP"

scope
object
required

The account the override attaches to.

value
FeeBpsValueInput · object
required

The fee value. unit must match the fee type: BPS for a rate-based type, AMOUNT for a fixed one.

Response

A cardholder fee row.

id
string<uuid>
required

Fee ID.

type
enum<string>
required

Which cardholder fee this row sets.

Available options:
FX_MARKUP,
ATM_DOMESTIC_VARIABLE,
ATM_DOMESTIC_FIXED,
ATM_CROSS_BORDER_VARIABLE,
ATM_CROSS_BORDER_FIXED
Example:

"FX_MARKUP"

value
FeeBpsValue · object
required

The fee value, denominated as unit says.

scope
Project · object
required

Where the fee attaches. PROJECT rows are the default rate card for your program; an ACCOUNT row overrides one fee type for one account.

version
integer
required

Incremented on every change. Transaction events record the version that priced them.

Required range: -9007199254740991 <= x <= 9007199254740991
createdAt
string
required

ISO 8601 creation timestamp.

updatedAt
string
required

ISO 8601 last-update timestamp.