# Create a Fee Profile

Create a .

Endpoint: POST /fee_profiles
Version: 2022-02-01
Security: BasicAuth

## Response 201 fields (application/json):

  - `id` (string)
    The ID of the  resource.
    Example: "FPxxxxxxxxxxxxxxxxxx"

  - `created_at` (string)
    Timestamp of when the object was created.

  - `updated_at` (string)
    Timestamp of when the object was last updated.

  - `ach_basis_points` (integer)
    Percentage-based fee incurred against the full amount of an eCheck (also called ACH payments). Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `ach_basis_points_fee_limit` (integer,null)
    Maximum ACH basis points fee (in cents) incurred for each individual .

  - `ach_credit_return_fixed_fee` (integer,null)
    A fixed amount (in cents) that will be charged to the seller for receiving an ACH Credit Return.

  - `ach_debit_return_fixed_fee` (integer,null)
    A fixed amount (in cents) that will be charged to the seller for receiving an ACH Debit Return.

  - `ach_fixed_fee` (integer)
    Fee in cents incurred for each individual .

  - `ach_notice_of_change_credit_fixed_fee` (integer,null)
    The amount in cents charged as a fixed fee for processing ACH credit transactions that result in a Notice of Change (NOC).

  - `ach_notice_of_change_debit_fixed_fee` (integer,null)
    Represents the fixed fee in cents for processing ACH debit transactions that generate a Notice of Change (NOC).

  - `american_express_assessment_basis_points` (integer,null)
    Applies to gross American Express card volume.

  - `american_express_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of each American Express Transfer. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `american_express_charge_dues_assessments` (integer,null)
    A fee associated with American Express's assessment of dues or ongoing charges for services provided through the American Express payment network.

  - `american_express_charge_interchange` (integer,null)
    Set to  to incur interchange fees for American Express .

  - `american_express_externally_funded_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of each American Express externally funded . Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `american_express_externally_funded_fixed_fee` (integer,null)
    Fee in cents incurred for each individual American Express externally funded .

  - `american_express_fixed_fee` (integer,null)
    Fee in cents incurred for each individual American Express .

  - `ancillary_fixed_fee_primary` (integer,null)
    An additional fixed fee that can be charged per .

  - `ancillary_fixed_fee_secondary` (integer,null)
    An additional fixed fee that can be charged per  if  is included.

  - `application` (string)
    The ID of the  associated with the  .

  - `basis_points` (integer)
    Percentage-based fee incurred against the full amount of each card-based . Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `charge_dues_assessments` (integer,null)
    A fee associated with payment network's assessment of dues or ongoing charges for services provided.

  - `charge_interchange` (boolean)
    Set to  to incur interchange fees for card-based .

  - `diners_club_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of each Diners . Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `diners_club_charge_interchange` (boolean,null)
    Set to  to incur interchange fees for Diners .

  - `diners_club_fixed_fee` (integer,null)
    Fee in cents incurred for each individual Diners .

  - `discover_assessments_basis_points` (integer,null)
    An assessment that applies to gross Discover card transaction volume.

  - `discover_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of each Discover Transfer. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `discover_charge_dues_assessments` (integer,null)
    A fee associated with Discover's assessment of dues or ongoing charges for services provided through the Discover payment network.

  - `discover_charge_interchange` (integer,null)
    Set to  to incur interchange fees for Discover .

  - `discover_data_usage_fixed_fee` (integer,null)
    Applies to all U.S.-based authorization transactions.

  - `discover_externally_funded_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of each Discover externally funded . Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `discover_externally_funded_fixed_fee` (integer,null)
    Fee in cents incurred for each individual Discover externally funded .

  - `discover_fixed_fee` (integer,null)
    Fee in cents incurred for each individual Discover .

  - `discover_network_authorization_fixed_fee` (integer,null)
    This fee will apply to all Discover network authorizations and will replace the previously assessed Data Transmission.

  - `dispute_fixed_fee` (integer,null)
    Fee applied when a  is created or updated to a  state.

  - `dispute_inquiry_fixed_fee` (integer,null)
    Fee applied when a  is created or updated to an  state.

  - `eft_basis_points` (integer,null)
    The percentage-based fee applied to the total amount of an EFT sale. Measured in basis points, where 1 basis point equals 0.01% (e.g., 100 basis points = 1%).

  - `eft_basis_points_fee_limit` (integer,null)
    The maximum percentage-based fee (in cents) incurred for each individual .

  - `eft_credit_return_fixed_fee` (integer,null)
    A fixed fee (in cents) charged to the merchant for processing an EFT credit return.

  - `eft_debit_return_fixed_fee` (integer,null)
    A fixed fee (in cents) charged to the seller for processing an EFT debit return.

  - `eft_fixed_fee` (integer,null)
    A flat fee (in cents) incurred for each individual  made from an EFT sale.

  - `externally_funded_basis_points` (integer,null)
    The percentage-based fee applied to the total amount of each externally funded . Measured in basis points, where 1 basis point equals 0.01%.

  - `externally_funded_fixed_fee` (integer,null)
    A fixed fee (in cents) incurred for each individual externally funded .

  - `fixed_fee` (integer)
    Fee in cents incurred for each individual card-based .

  - `jcb_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of each JCB Transfer. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `jcb_charge_interchange` (integer,null)
    Set to  to incur interchange fees for JCB .

  - `jcb_fixed_fee` (integer,null)
    Fee in cents incurred for each individual JCB .

  - `mastercard_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of each MasterCard . Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `mastercard_charge_dues_assessments` (integer,null)
    A fee associated with MasterCard's assessment of dues or ongoing charges for services provided through the MasterCard payment network.

  - `mastercard_charge_interchange` (boolean,null)
    Set to  to incur interchange fees for MasterCard .

  - `mastercard_fixed_fee` (integer,null)
    Fee in cents incurred for each individual MasterCard .

  - `qualified_tiers` (object,null)
    The top of the qualified tier tree.

  - `settlement_funding_transfer_ach_basis_points` (integer,null)
    A percentage-based fee applied to ACH transfers related to settlement funding. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `settlement_funding_transfer_ach_basis_points_fee_limit` (integer,null)
    The maximum percentage-based fee (in cents) incurred for each individual Settlement Funding Transfer (ACH).

  - `settlement_funding_transfer_ach_credit_return_fixed_fee` (integer,null)
    A fixed fee (in cents) charged to the platform or seller when receiving a credit return related to a Settlement Funding Transfer (ACH).

  - `settlement_funding_transfer_ach_debit_return_fixed_fee` (integer,null)
    A fixed fee (in cents) charged to the platform or seller when receiving a Debit Return related to a Settlement Funding Transfer (ACH).

  - `settlement_funding_transfer_ach_fixed_fee` (integer,null)
    A flat fee (in cents) incurred for each individual Settlement Funding Transfer (ACH).

  - `settlement_funding_transfer_eft_basis_points` (integer,null)
    The percentage-based fee applied to the total amount of a settlement funding  made via an EFT from a Canadian-based bank account. Measured in basis points, where 1 basis point equals 0.01% (e.g., 100 basis points = 1%).

  - `settlement_funding_transfer_eft_basis_points_fee_limit` (integer,null)
    The maximum percentage-based fee (in cents) incurred for each individual settlement funding  made via an EFT.

  - `settlement_funding_transfer_eft_credit_return_fixed_fee` (integer,null)
    A fixed fee (in cents) charged for processing a Credit Return related to a settlement funding . This occurs when funds are returned from a Canadian-based bank account back to the seller's account via EFT.

  - `settlement_funding_transfer_eft_debit_return_fixed_fee` (integer,null)
    A fixed fee (in cents) charged for processing a Debit Return related to a settlement funding . This occurs when funds are returned from the seller's account to a Canadian-based bank account via EFT due to a payment failure or reversal.

  - `settlement_funding_transfer_eft_fixed_fee` (integer,null)
    A flat fee (in cents) incurred for each settlement funding  made via an EFT from a Canadian-based bank account. This fee is independent of the payment amount.

  - `settlement_funding_transfer_instant_payout_card_basis_points` (integer,null)
    The percentage-based fee applied to the total amount of a settlement funding  made as an instant payout to a card. Measured in basis points, where 1 basis point equals 0.01% (e.g., 100 basis points = 1%).

  - `settlement_funding_transfer_instant_payout_card_basis_points_fee_limit` (integer,null)
    The maximum percentage-based fee (in cents) incurred for each individual settlement funding  made as an instant payout to a card.

  - `settlement_funding_transfer_instant_payout_card_fixed_fee` (integer,null)
    A flat fee (in cents) incurred for each settlement funding  made as an instant payout to a card.

  - `settlement_funding_transfer_noc_credit_fixed_fee` (integer,null)
    A fixed fee (in cents) charged for processing a Notification of Change (NOC) related to a credit transaction in settlement funding transfers.

  - `settlement_funding_transfer_noc_debit_fixed_fee` (integer,null)
    A fixed fee (in cents) charged for processing a Notification of Change (NOC) related to a debit transaction in settlement funding transfers.

  - `settlement_funding_transfer_same_day_ach_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of a settlement funding  made via same-day ACH. Calculated as one hundredth of one percent (1 basis point = .0001 or .01%).

  - `settlement_funding_transfer_same_day_ach_basis_points_fee_limit` (integer,null)
    The maximum percentage-based fee (in cents) incurred for each individual settlement funding  made via same-day ACH.

  - `settlement_funding_transfer_same_day_ach_fixed_fee` (integer,null)
    A flat fee (in cents) incurred for each settlement funding  made via same-day ACH.

  - `tags` (object,null)
    Include up to 50  pairs to annotate requests with custom metadata.
- Maximum character length for individual  is 40.
- Maximum character length for individual  is 500.
(For example, , , )

  - `visa_acquirer_processing_fixed_fee` (integer,null)
    Applies to all U.S.-based credit card authorizations acquired in the U.S., regardless of where the issuer/cardholder is located. If your business is based in the U.S., the acquirer processing fee will apply to all Visa credit card authorizations.

  - `visa_assessments_basis_points` (integer,null)
    Applies to all Visa credit transactions.

  - `visa_basis_points` (integer,null)
    Percentage-based fee incurred against the full amount of each Visa . Calculated as one hundredth of one percent (1 basis point = .0001 or .01%)

  - `visa_charge_dues_assessments` (integer,null)
    A fee associated with Visa's assessment of dues or ongoing charges for services provided through the Visa payment network.

  - `visa_charge_interchange` (boolean,null)
    Set to  to incur interchange fees for Visa .

  - `visa_credit_voucher_fixed_fee` (integer,null)
    Applies to Visa refunds.

  - `visa_fixed_fee` (integer,null)
    Fee in cents incurred for each individual Visa .

  - `visa_kilobyte_access_fixed_fee` (integer,null)
    Charged on each authorization transaction submitted to Visa’s network for settlement.

  - `_links` (object)
    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these  to make your follow-up requests and quickly access relevant IDs.

  - `_links.self` (object)
    Link to the resource that was used in the request.

  - `_links.self.href` (string)

  - `_links.application` (object)
    Link to the  the request was made under.

## Response 401 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "UNKNOWN"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.self` (object)

  - `_embedded.errors._links.self.href` (string)

  - `_embedded.errors._links.source` (object)

## Response 403 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "FORBIDDEN"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)

## Response 406 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "NOT_FOUND"

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)

## Response 422 fields (application/json):

  - `total` (integer)

  - `_embedded` (object)

  - `_embedded.errors` (array)

  - `_embedded.errors.code` (string)
    Enum: "INVALID_FIELD"

  - `_embedded.errors.field` (string)

  - `_embedded.errors.logref` (object)

  - `_embedded.errors.message` (string)

  - `_embedded.errors._links` (object)

  - `_embedded.errors._links.source` (object)

  - `_embedded.errors._links.source.href` (string)