v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Fee models

Create fee model

Create fee model.

A fee model is a structure that defines a collection of fees with custom calculations. You can define the method used to calculate the fee, using a fixed value or a percentage. Fee models can be applied to organizations, programs, and accounts. For more information, see the Fee model guide.

An accumulator fee model requires you call the <a href="https://developers.pismo.io/pismo-docs/reference/post-v1-accumulator-config" target="_blank">Create accumulator configuration</a> endpoint first to define how transaction totals are kept.

Once the fee model is created, it needs to be <a href="https://developers.pismo.io/pismo-docs/reference/attachmentbyaccount">attached to an account</a>, <a href="https://developers.pismo.io/pismo-docs/reference/attachmentbyprogram">attached to a program</a> or <a href="https://developers.pismo.io/pismo-docs/reference/attachmentbytenant">attached to an org</a>.

post/v1/fee/models

Headers

Authorizationstring required

Access token, not an account-specific token. Tokens can expire quickly, which can result in an <b>401 Unauthorized</b> message

Request body

model_descriptionstring required

Model description.

Example request

{
  "model_description": "Fee model applied to org",
  "fees": [
    [
      {
        "type": "fixed",
        "amount": 10,
        "rate": 10
      }
    ]
  ]
}

Response

OK

number required

Pismo fee model ID

Example response

455586868