POST///
Create a new fee policy.
Request body
| Fields | Description |
|---|---|
| token string Optional | Unique identifier of the fee policy. Allowable Values: 36 char max |
| name string Required | Name of the fee policy. Allowable Values: 255 char max |
| description string Optional | Description of the fee policy. Allowable Values: 255 char max |
| account object Required | Contains information on the fees in an account’s fee policy. Allowable Values: Existing account object |
| account.late_payment object Optional | Contains information on the late payment fee. Allowable Values: Existing late_payment object |
| account.returned_payment object Optional | Contains information on the returned payment fee. Allowable Values: Existing returned_payment object |
| account.foreign_transaction_fee object Optional | Contains information on the foreign transaction fee. Allowable Values: Existing foreign_transaction_fee object |
| account.monthly_fee object Optional | Contains information on the monthly periodic fees. Allowable Values: Existing periodic_fees object |
| account.annual_fee object Optional | Contains information on the annual periodic fees. Allowable Values: Existing periodic_fees object |
Sample request body
JSON
{
"token": "my_fee_policy_token_1234",
"name": "Gold Fee Policy",
"description": "A gold fee policy",
"account": {
"late_payment": {
"default_method": "FLAT",
"default_value": 10
},
"returned_payment": {
"default_method": "FLAT",
"default_value": 10
},
"foreign_transaction_fee": {
"default_method": "PERCENTAGE",
"default_value": 12.5
}
}
}
Response body
| Fields | Description |
|---|---|
| token string Conditionally returned | Unique identifier of the fee policy. Allowable Values: 36 char max |
| name string Conditionally returned | Name of the fee policy. Allowable Values: 255 char max |
| description string Conditionally returned | Description of the fee policy. Allowable Values: 255 char max |
| account object Conditionally returned | Contains information on the fees in an account’s fee policy. Allowable Values: Existing account object |
| account.late_payment object Conditionally returned | Contains information on the late payment fee. Allowable Values: Existing late_payment object |
| account.returned_payment object Conditionally returned | Contains information on the returned payment fee. Allowable Values: Existing returned_payment object |
| account.foreign_transaction_fee object Conditionally returned | Contains information on the foreign transaction fee. Allowable Values: Existing foreign_transaction_fee object |
| account.monthly_fee object Conditionally returned | Contains information on the monthly periodic fees. Allowable Values: Existing periodic_fees object |
| account.annual_fee object Conditionally returned | Contains information on the annual periodic fees. Allowable Values: Existing periodic_fees object |
| created_time datetime Conditionally returned | Date and time when the fee policy was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| updated_time datetime Conditionally returned | Date and time when the fee policy was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"token": "my_fee_policy_token_1234",
"name": "Gold Fee Policy",
"description": "A gold fee policy",
"account": {
"late_payment": {
"default_method": "FLAT",
"default_value": 10
},
"returned_payment": {
"default_method": "FLAT",
"default_value": 10
},
"foreign_transaction_fee": {
"default_method": "PERCENTAGE",
"default_value": 12.5
}
},
"created_time": "2025-04-01T23:41:58.802Z",
"updated_time": "2025-04-05T16:04:48.643Z"
}