Skip to main content
POST
/
v1
/
config
/
fee-schedules
Create a fee schedule
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/config/fee-schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Card Processing - Visa",
  "currency": "USD",
  "applicationOrder": "PARALLEL",
  "items": [
    {
      "name": "interchange",
      "structureType": "PERCENTAGE",
      "structure": {},
      "priority": 1
    }
  ],
  "roundingScale": 2,
  "roundingMode": "HALF_UP"
}
'
{
  "id": "019c96a0-2b20-7123-9a1b-2c3d4e5f6a7b",
  "tenantId": "019c96a0-0a98-7287-9a31-786e0809c769",
  "name": "Card Processing - Visa",
  "currency": "USD",
  "applicationOrder": "PARALLEL",
  "roundingScale": 2,
  "roundingMode": "HALF_UP",
  "items": [
    {
      "id": "019c96a0-2b20-7123-9a1b-2c3d4e5f6a7b",
      "name": "interchange",
      "priority": 1,
      "structureType": "PERCENTAGE",
      "structure": {},
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-15T10:30:00Z"
    }
  ],
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-15T10:30:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication (format: "Bearer {token}")

Headers

​
X-Request-Id
string

A unique identifier for tracing the request across services.

Body

application/json

Fee schedule creation payload

Payload for creating a fee schedule

​
name
string
required

Display name for the fee schedule

Required string length: 1 - 100
Example:

"Card Processing - Visa"

​
currency
string
required

Currency code (ISO 4217)

Maximum string length: 3
Example:

"USD"

​
applicationOrder
enum<string>
required

How multiple fee items compose

Available options:
PARALLEL,
CASCADING
Example:

"PARALLEL"

​
items
object[]
required

Fee items to include in this schedule

Required array length: 1 - 100 elements
​
roundingScale
integer

Number of decimal places for rounding

Example:

2

​
roundingMode
enum<string>

Rounding method for intermediate calculations

Available options:
HALF_UP,
BANKERS,
FLOOR,
CEIL,
TRUNCATE
Example:

"HALF_UP"

Response

Successfully created fee schedule

Fee schedule with its fee items

​
id
string<uuid>

Unique identifier for the fee schedule

Example:

"019c96a0-2b20-7123-9a1b-2c3d4e5f6a7b"

​
tenantId
string<uuid>

Tenant that owns this fee schedule

Example:

"019c96a0-0a98-7287-9a31-786e0809c769"

​
name
string

Display name for the fee schedule

Maximum string length: 100
Example:

"Card Processing - Visa"

​
currency
string

Currency code (ISO 4217)

Example:

"USD"

​
applicationOrder
enum<string>

How multiple fee items compose

Available options:
PARALLEL,
CASCADING
Example:

"PARALLEL"

​
roundingScale
integer

Number of decimal places for rounding

Example:

2

​
roundingMode
enum<string>

Rounding method for intermediate calculations

Available options:
HALF_UP,
BANKERS,
FLOOR,
CEIL,
TRUNCATE
Example:

"HALF_UP"

​
items
object[]

Fee items in this schedule

Maximum array length: 100
​
createdAt
string<date-time>

Creation timestamp in RFC 3339 format

Example:

"2025-01-15T10:30:00Z"

​
updatedAt
string<date-time>

Last update timestamp in RFC 3339 format

Example:

"2025-01-15T10:30:00Z"