Marqeta.com
Support
/
5 minute read
September 4, 2020

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

/fees
endpoint) and the account holder group to which you will associate the real-time fee group (using the
/accountholdergroups
endpoint). Each fee in the group must be applicable to a different transaction type. For example, one fee could assess $1 on authorization transactions while another assesses $2 on PIN-debit transactions.

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

Action:

POST

Endpoint:
/realtimefeegroups

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
Fields Description

token

string
Optional

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
Required

A descriptive name for the real-time fee group.

Allowable Values:

50 char max

active

boolean
Optional

Indicates whether the real-time fee group is active

Allowable Values:

true
,
false

Default value:

true

fee_tokens

array of strings
Optional

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.

Sample request body
Copied

Is this helpful?

Yes
No
Sample response body
Copied

Is this helpful?

Yes
No

Retrieve real-time fee group

Action:

GET

Endpoint:
/realtimefeegroups{token}

Use this endpoint to retrieve a specific real-time fee group. Include the real-time fee group

token
path parameter to specify the real-time fee group to return.

URL path parameters
Fields Description

token

string
Required

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.

Sample response body
Copied

Is this helpful?

Yes
No

Update real-time fee group

Action:

PUT

Endpoint:
/realtimefeegroups/{token}

Use this endpoint to update a real-time fee group. Include the real-time fee group

token
path parameter to specify the real-time fee group to update. Add the real-time fee group details to update to the body of the request in JSON format. Only values of parameters in the request are modified; all others are left unchanged.

URL path parameters
Fields Description

token

string
Required

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
Fields Description

name

string
Required

A descriptive name for the real-time fee group.

Allowable Values:

50 char max

active

boolean
Optional

Indicates whether the real-time fee group is active

Allowable Values:

true
,
false

Default value:

true

fee_tokens

array of strings
Optional

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.

Sample request body
Copied

Is this helpful?

Yes
No
Sample response body
Copied

Is this helpful?

Yes
No

List real-time fee groups

Action:

GET

Endpoint:
/realtimefeegroups

Use this endpoint to list existing real-time fee groups.

This endpoint supports field filtering and pagination.

Sample response body
Copied

Is this helpful?

Yes
No

Feedback on this page?

If you feel we can do anything better, please let our team know.