v1

latestOpenAPI 3.1.0Proprietary2026-07-2464170247.4 KB

Pricing

Create Partner Fee

Create a partner fee charged to your customers, under the given account.

Scope:

Create on the main account to set a default fee that applies to all sub-accounts.
Create on a sub-account to set a fee that applies only to that sub-account.

Fee matching: when a transaction occurs, a sub-account fee takes priority over the main-account default, and the most targeted fee wins.

external_id: required valid UUID in the request body, unique to this create request. Reusing an existing value returns a conflict. If a previous create timed out, look it up via the list endpoint with the external_id query parameter instead of replaying the create request.

post/v1/accounts/{account_id}/partner-fees

Path parameters

account_idstring required

Account ID (main or sub-account)

Request body

external_idstring required

Partner-supplied external_id request value (UUID) used to make a create request idempotent. Validated at the API boundary and stored on the resource as an external identifier.

Example request

{
  "fee": {
    "currency": "USD",
    "payment_rail": "US_FEDWIRE",
    "rate": "0.001",
    "fixed": "0.5"
  },
  "external_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response

Partner fee created

fee_idstring required

Partner fee ID exposed by OpenAPI.

account_idstring required

created_atstring required

Fee creation timestamp (ISO 8601)

modified_atstring required

Last modification timestamp (ISO 8601)

Example response

{
  "fee_id": "e9ece207-8fd6-400e-872b-409701e57b74",
  "fee": {
    "currency": "USD",
    "payment_rail": "US_FEDWIRE",
    "rate": "0.001",
    "fixed": "0.5"
  },
  "created_at": "2026-06-11T08:30:00Z",
  "modified_at": "2026-06-11T08:30:00Z"
}