❖ MatchMove Banking API Specifications

Sections

Theme switcher

Re-activate card

Header Parameters

X-Auth-User-IDstring Required

The matchmove issued user_id for which the request is being made

X-Auth-User-IPstring

The IP using which the actor is making the request

X-Auth-Device-IDstring

The unique id of the device using which the actor is making the request

X-Auth-User-Agentstring

The user agent of the device using which the actor is making the request

X-Auth-Actorstring Required

The actor on behalf of whom the API request is being performed

Path Parameters

program_codestring Required

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.

card_idstring Required

Body Parameters

idstring Required

Card unique identifier. When present, this will unblock the card associated with this parameter.

Pattern
^[a-zA-Z0-9]*
assoc_numberstring

Physical Card Proxy Number [format: PY + Proxy Number (eg. 'PY000000000123')] or Account identification number. When present, this will bind the card to the current user.

Response

200
Object

OK

Response Attributes

idstring
numberstring
statusstring
400
Object

Bad Request

Possible error codes :

user_wallet_card_improper_type : Invalid block reason type.

validate_card_number_not_available : Validate card number not available.

resource_card_activation_code_invalid : activation_code is invalid

resource_card_activation_code_not_empty : activation_code must not be empty

parameter_assoc_number_missing : assoc_number is missing

parameter_assoc_number_invalid : assoc_number is invalid

parameter_assoc_number_in_use : Parameter assoc_number is already in use

resource_wallet_card_design_not_valid : card_design is invalid

parameter_assoc_number_must_be_16_digits : assoc_number must be 16 digits

parameter_auto_activate_required : Parameter auto_activate is required

resource_card_auto_activate_not_allowed : Auto activation is not allowed for this card type

resource_card_param_not_allowed : Parameter :param is not allowed for this card type

resource_card_insufficient_balance : Insufficient Wallet Balance.

resource_user_billing_address_not_empty : billing_address must not be empty for personalised card

resource_user_operational_address_not_empty : operational_address must not be empty for personalised card

Response Attributes

idstring Required

Unique request ID for the API request

statusnumber Required

HTTP response code for the API request

codestring Required

MatchMove generated error code for the API request

titlestring Required

MatchMove generated title for the error code

detailstring Required

Details for the error code

descriptionstring

Details for the error code

sourcearray | null

Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons

timestampstring Required

Timestamp for the processed API

401
Object

Unauthorized request

Response Attributes

idstring Required

Unique request ID for the API request

statusnumber Required

HTTP response code for the API request

codestring Required

MatchMove generated error code for the API request

titlestring Required

MatchMove generated title for the error code

detailstring Required

Details for the error code

descriptionstring

Details for the error code

sourcearray | null

Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons

timestampstring Required

Timestamp for the processed API

403
Object

Forbidden

Possible error codes :

restricted_resource : Access with method POST denied

risk_management_engine_error : An exception occurred during the processing of the risk and compliance of the user.

resource_wallet_card_assoc_number_must_not_be_present : Parameter assoc_number must not be present for non-physical or personalized cards.

Response Attributes

idstring Required

Unique request ID for the API request

statusnumber Required

HTTP response code for the API request

codestring Required

MatchMove generated error code for the API request

titlestring Required

MatchMove generated title for the error code

detailstring Required

Details for the error code

descriptionstring

Details for the error code

sourcearray | null

Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons

timestampstring Required

Timestamp for the processed API

404
Object

Resource not found

Possible error codes :

resource_not_found : The requested URL was not found

Response Attributes

idstring Required

Unique request ID for the API request

statusnumber Required

HTTP response code for the API request

codestring Required

MatchMove generated error code for the API request

titlestring Required

MatchMove generated title for the error code

detailstring Required

Details for the error code

descriptionstring

Details for the error code

sourcearray | null

Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons

timestampstring Required

Timestamp for the processed API

500
Object

Internal Server Error

Possible error codes :

resource_risk_service_config_error : Unable to process the request due invalid risk service configuration.

Response Attributes

idstring Required

Unique request ID for the API request

statusnumber Required

HTTP response code for the API request

codestring Required

MatchMove generated error code for the API request

titlestring Required

MatchMove generated title for the error code

detailstring Required

Details for the error code

descriptionstring

Details for the error code

sourcearray | null

Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons

timestampstring Required

Timestamp for the processed API

502
Object

Bad Gateway

Response Attributes

idstring Required

Unique request ID for the API request

statusnumber Required

HTTP response code for the API request

codestring Required

MatchMove generated error code for the API request

titlestring Required

MatchMove generated title for the error code

detailstring Required

Details for the error code

descriptionstring

Details for the error code

sourcearray | null

Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons

timestampstring Required

Timestamp for the processed API

503
Object

External Service Error

Possible error codes :

resource_wallet_card_limit : Maximum card limit reached for card type.

resource_wallet_card_not_related : Creating an additional or supplementary card requires a wallet and must be related to the user.

user_blocked_risk_threshold_exceeded : User have exceeded the risk and compliance threshold and was automatically blocked.

risk_management_engine_error : An exception occurred during the processing of the risk and compliance of the user.

resource_wallet_card_assoc_number_must_not_be_present : Parameter assoc_number must not be present for non-physical cards.

Response Attributes

idstring Required

Unique request ID for the API request

statusnumber Required

HTTP response code for the API request

codestring Required

MatchMove generated error code for the API request

titlestring Required

MatchMove generated title for the error code

detailstring Required

Details for the error code

descriptionstring

Details for the error code

sourcearray | null

Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons

timestampstring Required

Timestamp for the processed API

504
Object

Gateway timeout

Response Attributes

idstring Required

Unique request ID for the API request

statusnumber Required

HTTP response code for the API request

codestring Required

MatchMove generated error code for the API request

titlestring Required

MatchMove generated title for the error code

detailstring Required

Details for the error code

descriptionstring

Details for the error code

sourcearray | null

Optional object returned when a validation error encountered. The object returns details of the fields which failed validation errors and the respective reasons

timestampstring Required

Timestamp for the processed API

Was this section helpful?

POST

/

Select
1

Response

Was this section helpful?