Sign in

v8

OpenAPI 3.1.02026-08-033623795.0 MB
Fee markups

Create fee markup

Create or update a fee markup for a company. If a markup for the specified fee type already exists, it will be updated with the new values.

Required permissions:

  • company:update_child_fees
post/fee_markups

Request body

company_idstring required

The unique identifier of the company to create or update the fee markup for.

fee_type'crypto_withdrawal_markup' | 'rtp_withdrawal_markup' | 'next_day_bank_withdrawal_markup' | 'bank_wire_withdrawal_markup' | 'digital_wallet_withdrawal_markup' required

The types of fee markups that can be configured

fixed_fee_usdnumber nullable

The fixed fee amount in USD to charge per transaction. Must be between 0 and 50.

metadataobject nullable

Custom key-value metadata to attach to this fee markup.

notesstring nullable

Internal notes about this fee markup for record-keeping purposes.

percentage_feenumber nullable

The percentage fee to charge per transaction. Must be between 0 and 25.

Example request

{
  "company_id": "biz_xxxxxxxxxxxxxx",
  "fixed_fee_usd": 6.9,
  "percentage_fee": 6.9
}

Response

A successful response

created_atstring date-time required

The datetime the fee markup was created.

fee_type'crypto_withdrawal_markup' | 'rtp_withdrawal_markup' | 'next_day_bank_withdrawal_markup' | 'bank_wire_withdrawal_markup' | 'digital_wallet_withdrawal_markup' required

The types of fee markups that can be configured

fixed_fee_usdnumber nullable required

A flat fee charged per transaction, in USD. Ranges from 0 to 50. Null if no fixed fee is configured.

idstring required

The unique identifier for the fee markup.

notesstring nullable required

Internal notes about this fee markup, visible only to administrators. Null if no notes have been added.

percentage_feenumber nullable required

A percentage-based fee charged per transaction. Ranges from 0 to 25. Null if no percentage fee is configured.

updated_atstring date-time required

The datetime the fee markup was last updated.

Example response

{
  "created_at": "2023-12-01T05:00:00.401Z",
  "fixed_fee_usd": 6.9,
  "notes": "Approved by finance team on 2024-01-15",
  "percentage_fee": 6.9,
  "updated_at": "2023-12-01T05:00:00.401Z"
}