Fee markups

Create fee markup

Changed on

Creates or updates an account's markup for one fee type. If the account already has a markup for that fee_type, it is updated with the new values.

Required permissions:

  • company:update_child_fees
post/fee_markups

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/fee_markups
  • Auth: HTTP bearer

Request body

account_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' | 'transfer_markup' | 'crypto_deposit_markup' | 'bank_deposit_markup' | 'crypto_swap_markup' | 'payment_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

{
  "account_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' | 'transfer_markup' | 'crypto_deposit_markup' | 'bank_deposit_markup' | 'crypto_swap_markup' | 'payment_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"
}

Changes

  • 14e4732f295dRevision changes
    • warning

      added the new payment_markup enum value to the response property for the response status

    • info

      added the new payment_markup enum value to the request property

  • 918ff9d965e1Revision changes
    • warning

      added the new crypto_swap_markup enum value to the response property for the response status

    • warning

      added the new transfer_markup enum value to the response property for the response status

    This list may be incomplete.