Real-Time Fee Groups
Marqeta enables you to assess fees in real time through the use of real-time fee groups. A real-time fee group is a group of fees associated with an account holder group (and thereby associated with the users and businesses that are part of that account holder group). Real-time fee assessment ensures that associated accounts have sufficient funds available to cover both the transaction amount and the fee before authorization of a transaction.
Before you create a real-time fee group, you must create the individual fees (using the
Use of real-time fee groups requires prior approval by Marqeta. If you are interested in using this feature, contact your Marqeta representative for more information.
Create real-time fee group
Copy section link
Action:
Endpoint:
Use this endpoint to create a real-time fee group. Add the real-time fee group details to the body of the request in JSON format. When you create any Marqeta resource, the system associates a token for referencing that resource. You can create your own token using up to 36 alphanumeric characters. If you do not include a token value, one is generated automatically.
Body field details
Copy section link
Fields | Description |
---|---|
token
string
|
The unique identifier of the real-time fee group. If you do not include a token, the system will generate one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. Allowable Values: 36 char max |
name
string
|
A descriptive name for the real-time fee group. Allowable Values: 50 char max |
active
boolean
|
Indicates whether the real-time fee group is active Allowable Values: true , false
Default value: true
|
fee_tokens
array of strings
|
Specifies the fees in this real-time fee group. No two fees in the group can be applicable to the same transaction type (in other words, each fee must have a different value for its real_time_assessment.transaction_type field.)
Allowable Values: Array of already existing fee tokens. Send a GET request to /fees to retrieve fee tokens.
|
Retrieve real-time fee group
Copy section link
Action:
Endpoint:
Use this endpoint to retrieve a specific real-time fee group. Include the real-time fee group
URL path parameters
Copy section link
Fields | Description |
---|---|
token
string
|
Identifies the real-time fee group to retrieve. Allowable Values: Existing real-time fee group token. Send a GET request to /realtimefeegroups to retrieve real-time fee group tokens.
|
Update real-time fee group
Copy section link
Action:
Endpoint:
Use this endpoint to update a real-time fee group. Include the real-time fee group
URL path parameters
Copy section link
Fields | Description |
---|---|
token
string
|
Identifies the real-time fee group to update. Allowable Values: Existing real-time fee group token. Send a GET request to /realtimefeegroups to retrieve real-time fee group tokens.
|
Body field details
Copy section link
Fields | Description |
---|---|
name
string
|
A descriptive name for the real-time fee group. Allowable Values: 50 char max |
active
boolean
|
Indicates whether the real-time fee group is active Allowable Values: true , false
Default value: true
|
fee_tokens
array of strings
|
Specifies the fees in this real-time fee group. No two fees in the group can be applicable to the same transaction type (in other words, each fee must have a different value for its real_time_assessment.transaction_type field.)
Allowable Values: Array of already existing fee tokens. Send a GET request to /fees to retrieve fee tokens.
|
List real-time fee groups
Copy section link
Action:
Endpoint:
Use this endpoint to list existing real-time fee groups.
This endpoint supports field filtering and pagination.