❖ MatchMove Banking API Specifications

Sections

Theme switcher

Start Card Authentication Simulation

Path Parameters

program_codestring Required

Program code identifier

Body Parameters

card_idstring Required

Card hash ID as per MM system

challenge_methodstring Required

Denotes the challenge method configured for the card type of the given card hash ID

Enum values:
otpoob
typestring

Denotes the delivery channel configured for the card type of the given card hash ID.

If challenge_method is otp, then this field is mandatory.

If challenge_method is oob, then this field is optional and its value is not considered by the system.

Enum values:
smsemail

Response

200
Object

Authentication challenge started successfully

Response Attributes

messagestring

Message that denotes the successful operation of Start authentication

transaction_authentication_idstring

Transaction Authentication ID to be used in subsequent calls

400
Object

Bad Request

Possible error codes :

validation_error : Validation errors — Card_id is required

validation_error : Validation errors — challenge_method is required

validation_error : challenge_method_not_configured — challenge_method 'otp' with type 'email' is not configured for card type '{card_type_code}'

validation_error : challenge_method_not_configured — challenge_method 'oob' is not configured for card type '{card_type_code}'

parameter_card_id_invalid : Parameter Card ID Invalid — card_id is invalid

simulation_error : card_not_found — card not found

simulation_error : card_disabled — card disabled

validation_error : validation_error — type must be one of: sms, email (for otp challenge_method)

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

Possible error codes :

access_denied : access_denied — access denied

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

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 :

generic_error : Generic Error — General application error

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?