---
title: "Create a billing profile"
method: POST
path: "/v1/billing_profiles"
tags: ["Billing Profiles"]
---

# Create a billing profile

`POST /v1/billing_profiles`

Create a billing profile

The first billing profile created will be assigned as the platform's default billing profile for new merchants.

## Parameters

- `#/paths/~1v1~1merchants/get/parameters/0` — unresolved $ref

## Request body

- Data — unresolved $ref

## Response `200`

OK

- object
  - `status` Status — unresolved $ref
  - `data` object
    - `billing_profile_id` BillingProfileId — unresolved $ref
    - `platform_id` string — The unique platform identifier. Prefix is "plt" in production and "sbx_plt" in sandbox.
    - `name` string — Name of the billing profile
    - `card_rate_type` string — Card rate type
    - `card_rate` integer — Card rate, in per cent mille (1 PCM = 0.001%). For example, 3000 is 3%.
    - `card_amex_rate_surcharge` integer — Amex card rate surcharge, in per cent mille (1 PCM = 0.001%). This rate will be charged in addition to the card rate. If a card is also Business or International, then the higher rate will be charged. For example, 3000 is 3%.
    - `card_business_rate_surcharge` integer — Business card rate surcharge, in per cent mille (1 PCM = 0.001%). This rate will be charged in addition to the card rate. If a card is also Amex or International, then the higher rate will be charged. For example, 3000 is 3%.
    - `card_international_rate_surcharge` integer — International (non-US) card rate surcharge, in per cent mille (1 PCM = 0.001%). This rate will be charged in addition to the card rate. If a card is also Amex or Business, then the higher rate will be charged. For example, 3000 is 3%.
    - `card_fee` integer — Card fee, in minor units. For example, 1000 is 10.00 USD.
    - `card_refund_rate` integer — Card refund rate, in per cent mille (1 PCM = 0.001%). For example, 3000 is 3%.
    - `card_refund_fee` integer — Card refund fee, in minor units. For example, 1000 is 10.00 USD.
    - `card_auth_fee` integer — Fee per card authorization, in minor units. For example, 1000 is 10.00 USD.
    - `card_auth_void_fee` integer — Fee per card authorization void, in minor units. For example, 1000 is 10.00 USD.
    - `card_dispute_fee` integer — Card dispute fee, in minor units. For example, 1000 is 10.00 USD.
    - `card_device_rate` integer — Card device rate, in per cent mille (1 PCM = 0.001%). For example, 3000 is 3%.
    - `card_device_amex_rate_surcharge` integer — Amex card device rate surcharge, in per cent mille (1 PCM = 0.001%). This rate will be charged in addition to the card device rate. If a card is also Business or International, then the higher rate will be charged. For example, 3000 is 3%.
    - `card_device_business_rate_surcharge` integer — Business card device rate surcharge, in per cent mille (1 PCM = 0.001%). This rate will be charged in addition to the card device rate. If a card is also Amex or International, then the higher rate will be charged. For example, 3000 is 3%.
    - `card_device_international_rate_surcharge` integer — International (non-US) card device rate surcharge, in per cent mille (1 PCM = 0.001%). This rate will be charged in addition to the card device rate. If a card is also Amex or Business, then the higher rate will be charged. For example, 3000 is 3%.
    - `card_device_fee` integer — Card device fee, in minor units. For example, 1000 is 10.00 USD.
    - `card_device_refund_rate` integer — Card device refund rate, in per cent mille (1 PCM = 0.001%). For example, 3000 is 3%.
    - `card_device_refund_fee` integer — Card device refund fee, in minor units. For example, 1000 is 10.00 USD.
    - `card_device_auth_fee` integer — Fee per card device authorization, in minor units. For example, 1000 is 10.00 USD.
    - `card_device_auth_void_fee` integer — Fee per card device authorization void, in minor units. For example, 1000 is 10.00 USD.
    - `ach_rate` integer — ACH rate, in per cent mille (1 PCM = 0.001%). For example, 3000 is 3%.
    - `ach_rate_cap` integer — ACH rate cap, in minor units. For example, 1000 is 10.00 USD.
    - `ach_fee` integer — ACH fee, in minor units. For example, 1000 is 10.00 USD.
    - `ach_balance_check_fee` integer — ACH balance check fee, in minor units. For example, 1000 is 10.00 USD.
    - `ach_refund_rate` integer — ACH refund rate, in per cent mille (1 PCM = 0.001%). For example, 3000 is 3%.
    - `ach_refund_fee` integer — ACH refund fee, in minor units. For example, 1000 is 10.00 USD.
    - `ach_return_fee` integer — ACH return fee, in minor units. For example, 1000 is 10.00 USD.
    - `ach_dispute_fee` integer — ACH dispute fee, in minor units. For example, 1000 is 10.00 USD.
    - `ach_validation_fee` integer — ACH validation fee, in minor units. For example, 1000 is 10.00 USD.
    - `accelerated_ach_rate` integer — Accelerated ACH rate, in per cent mille (1 PCM = 0.001%). For example, 3000 is 3%.
    - `accelerated_ach_rate_cap` integer — Accelerated ACH rate cap, in minor units. For example, 1000 is 10.00 USD.
    - `accelerated_ach_fee` integer — Accelerated ACH fee, in minor units. For example, 1000 is 10.00 USD.
    - `ach_frictionless_validation_fee` integer — ACH frictionless validation fee, in minor units. For example, 1000 is 10.00 USD.
    - `standard_deposit_fee` integer — Deposit fee, in minor units. For example, 1000 is 10.00 USD.
    - `threeds_attempt_fee` integer — Fee per 3DS attempt, in minor units. For example, 1000 is 10.00 USD.
    - `card_account_updater_fee` integer — Card account update attempt, in minor units. For example, 1000 is 10.00 USD.
    - `bin_lookup_fee` integer — Fee per BIN lookup, in minor units. For example, 1000 is 10.00 USD.
    - `tap_to_phone_fee` integer — Fee per Tap to Phone attempt, in minor units. For example, 1000 is 10.00 USD.
    - `paypal_wallet_rate` integer — PayPal Wallet rate, in per cent mille (1 PCM = 0.001%).
    - `paypal_wallet_fee` integer — PayPal Wallet fee, in minor units.
    - `paypal_wallet_refund_rate` integer — PayPal Wallet refund rate, in per cent mille (1 PCM = 0.001%).
    - `paypal_wallet_refund_fee` integer — PayPal Wallet refund fee, in minor units.
    - `paypal_wallet_dispute_fee` integer — PayPal Wallet dispute fee, in minor units.
    - `paypal_wallet_auth_fee` integer — Fee per PayPal Wallet authorization, in minor units.
    - `paypal_wallet_auth_void_fee` integer — Fee per PayPal Wallet authorization void, in minor units.
    - `venmo_rate` integer — Venmo rate, in per cent mille (1 PCM = 0.001%).
    - `venmo_fee` integer — Venmo fee, in minor units.
    - `venmo_refund_rate` integer — Venmo refund rate, in per cent mille (1 PCM = 0.001%).
    - `venmo_refund_fee` integer — Venmo refund fee, in minor units.
    - `venmo_dispute_fee` integer — Venmo dispute fee, in minor units.
    - `venmo_auth_fee` integer — Fee per Venmo authorization, in minor units.
    - `venmo_auth_void_fee` integer — Fee per Venmo authorization void, in minor units.
    - `paypal_paylater_rate` integer — PayPal Pay Later rate, in per cent mille (1 PCM = 0.001%).
    - `paypal_paylater_fee` integer — PayPal Pay Later fee, in minor units.
    - `paypal_paylater_refund_rate` integer — PayPal Pay Later refund rate, in per cent mille (1 PCM = 0.001%).
    - `paypal_paylater_refund_fee` integer — PayPal Pay Later refund fee, in minor units.
    - `paypal_paylater_dispute_fee` integer — PayPal Pay Later dispute fee, in minor units.
    - `paypal_paylater_auth_fee` integer — Fee per PayPal Pay Later authorization, in minor units.
    - `paypal_paylater_auth_void_fee` integer — Fee per PayPal Pay Later authorization void, in minor units.
    - `interchange_plus` boolean — When enabled, Interchange Plus fees (Interchange, Dues, Fees, and Assessments) are passed through to the merchant in addition to the card volume rate. This option is only available for merchants using Monthly Gross billing.
    - `currency_code` 'USD' — Three-letter ISO currency code, in uppercase. Currently, only USD is supported.
    - `num_active_merchants` string — Number of active merchants with billing profile assigned
    - `is_platform_default` boolean — Is platform's default billing profile
    - `created_at` string, date-time — Date and time billing_profile was created at in UTC RFC 3339 format.
    - `deactivated_at` CreatedAt — unresolved $ref
  - `errors` Errors — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `5XX` — unresolved $ref

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)