Create a card fund category
Header Parameters
The matchmove issued user_id for which the request is being made
The IP using which the actor is making the request
The unique id of the device using which the actor is making the request
The user agent of the device using which the actor is making the request
The actor on behalf of whom the API request is being performed
Path Parameters
Unique identifier for your program, issued by MatchMove during onboarding. All requests must use the program_code assigned to your integration. Using a program_code that does not belong to your integration will result in an authorization error.
Body Parameters
Fund category name. Case-insensitive alphanumeric combinations with hyphens. Must be unique and cannot be "DEFAULT".
Default limit amount for the category. Must be numeric and greater than zero, or null to clear it. Optional.
Amount type factor. Only UNIT is supported. Optional.
UNITCategory priority. Numeric, non-zero and must be unique. Optional; auto-assigned when omitted.
Comma-separated list of card hash ids to filter the category on. Optional.
Comma-separated list of MCC codes to filter the category on. Optional.
Comma-separated list of ISO 3166 alpha-3 country codes to filter the category on. Optional.
Comma-separated list of merchant ids to filter the category on. Optional.
Comma-separated list of terminal ids to filter the category on. Optional.
Response
Fund category created successfully.
Response Attributes
Fund category identifier.
Fund category name.
Default amount allocated to the category.
Allocation factor for the category.
Category priority ordering.
Cards associated with this category.
Show child attributes
Merchant category codes bound to this category.
Show child attributes
Currency codes bound to this category.
Show child attributes
Merchant codes bound to this category.
Show child attributes
Terminal codes bound to this category.
Show child attributes
Whether the category is active.
Timestamp the category was created.
Bad Request
The response code field indicates which specific rule was violated.
Possible error codes:
resource_card_fund_category_name_exists- Category name already exists and cannot be usedresource_card_fund_category_amount_invalid- The default amount given is missing or invalidresource_card_fund_category_priority_invalid- The priority given is invalidresource_card_fund_category_priority_exists- Category priority already exists and cannot be usedresource_card_fund_category_is_active_invalid- The is_active value is invalidresource_card_fund_category_card_invalid- One or more card values given is not supportedresource_card_fund_category_mcc_invalid- One or more MCC values given is not supportedresource_card_fund_category_country_invalid- One or more Country values given is not supported
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Unauthorized Request
The response code field indicates which specific rule was violated.
Possible error codes:
invalid_token- Access denied due to invalid token on header
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Forbidden
The response code field indicates which specific rule was violated.
Possible error codes:
access_denied- Access is denied for this resource
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Not Found
The response code field indicates which specific rule was violated.
Possible error codes:
resource_not_found- Resource not found
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Method Not Allowed
The response code field indicates which specific rule was violated.
Possible error codes:
method_not_allowed- The HTTP method is not allowed here
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Internal Server Error
The response code field indicates which specific rule was violated.
Possible error codes:
internal_error- An internal gateway error occurred
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Not Implemented
The response code field indicates which specific rule was violated.
Possible error codes:
not_implemented- This operation is not implemented
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Bad Gateway
The response code field indicates which specific rule was violated.
Possible error codes:
bad_gateway- Bad gateway error.
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Service Unavailable
The response code field indicates which specific rule was violated.
Possible error codes:
service_unavailable- Service is temporarily unavailable
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Gateway Timeout
The response code field indicates which specific rule was violated.
Possible error codes:
gateway_timeout- Gateway timeout error.
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp