❖ MatchMove Banking API Specifications

Sections

Theme switcher

Create 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_type_codestring Required

Unique MatchMove generated code for a card program to be specified as part of the API when the card is requested for the user

Body Parameters

assoc_numberstring

Required value supported only for non personalized physical cards. 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.

card_designstring
name_on_cardstring
additional_detailsstring
auto_activateboolean

If passed as true the POST request does the activation of the card along with the linkage of the card. Do note this parameter is only supported for non personalized card. Also depending on the card management partner used only option true might be supported

Enum values:
truefalse

Response

200
Object

OK

Response Attributes

idstring Required

Unique Reference for Wallet in the MatchMove System

Pattern
^[a-zA-Z0-9]*
numberstring Required

Account Identification Number for the Wallet

holderobject Required
typeobject
tokenobject
dateobject
imageobject

Model to describe the card images that are retuned on the get call for retrieving users payment instrument.

statusobject Required
fundsobject
linksarray
activation_codestring

Only applicable for physical cards. Activation code will be shown in response if card is not activated yet.After card activation , code will not appear in the response.

kitstring
400
Object

Bad Request

Possible error codes : 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 resource_card_auto_activate_not_allowed : Auto activation is not allowed for this card type resource_card_insufficient_balance : Insufficient Wallet Balance.

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?