Skip to main content
POST
Create a BillingPackage

Headers

Content-Type
string

The type of media of the resource. Recommended value is application/json.

X-Request-Id
string<uuid>

A unique identifier used to trace and track each request.

Authorization
string

Bearer JWT token for authentication. Required when PLUGIN_AUTH_ENABLED=true (enforced in multi-tenant deployments). Optional in default OSS single-tenant mode. Format: Bearer <token>

Path Parameters

organization_id
string<uuid>
required

The unique identifier of the Organization associated with the Ledger.

Body

application/json
createdAt
string
required
Example:

"2026-01-01T00:00:00Z"

enable
boolean | null
required
Example:

true

id
string
required
Example:

"00000000-0000-0000-0000-000000000000"

label
string
required
Example:

"Monthly Volume Billing"

ledgerId
string
required
Example:

"00000000-0000-0000-0000-000000000000"

organizationId
string
required
Example:

"00000000-0000-0000-0000-000000000000"

type
string
required
Example:

"volume"

updatedAt
string
required
Example:

"2026-01-01T00:00:00Z"

accountTarget
object
assetCode
string
Example:

"BRL"

countMode
string
Example:

"perRoute"

creditAccountAlias
string
Example:

"account_fees_credit"

debitAccountAlias
string
Example:

"account_fees_debit"

deletedAt
string
Example:

"2026-06-01T00:00:00Z"

description
string
Example:

"Charges per completed transaction route"

discountTiers
object[] | null
eventFilter
object
feeAmount
string
Example:

"50.00"

freeQuota
integer<int64>
Example:

100

maintenanceCreditAccount
string
Example:

"account_maintenance_credit"

pricingModel
string
Example:

"tiered"

tiers
object[] | null

Response

OK

createdAt
string
required
Example:

"2026-01-01T00:00:00Z"

enable
boolean | null
required
Example:

true

id
string
required
Example:

"00000000-0000-0000-0000-000000000000"

label
string
required
Example:

"Monthly Volume Billing"

ledgerId
string
required
Example:

"00000000-0000-0000-0000-000000000000"

organizationId
string
required
Example:

"00000000-0000-0000-0000-000000000000"

type
string
required
Example:

"volume"

updatedAt
string
required
Example:

"2026-01-01T00:00:00Z"

accountTarget
object
assetCode
string
Example:

"BRL"

countMode
string
Example:

"perRoute"

creditAccountAlias
string
Example:

"account_fees_credit"

debitAccountAlias
string
Example:

"account_fees_debit"

deletedAt
string
Example:

"2026-06-01T00:00:00Z"

description
string
Example:

"Charges per completed transaction route"

discountTiers
object[] | null
eventFilter
object
feeAmount
string
Example:

"50.00"

freeQuota
integer<int64>
Example:

100

maintenanceCreditAccount
string
Example:

"account_maintenance_credit"

pricingModel
string
Example:

"tiered"

tiers
object[] | null