Merchant Enrolment API Deprecation Notice
Mastercard have announced the decommission of their Merchant Enrolment API, moving to acquirer-based enrolment for Mastercard Identity Check. Mastercard will no longer approve new API access requests from 18th June 2025, before fully decommissioning the Merchant Enrolment API on 18th August 2025.

Ravelin advises clients that wish to use the Merchant Enrolment API to do so before 18th June 2025 to minimise potential disruption.
Please reach out to your account manager if you have any questions.

Query

This endpoint allows you to query the status of enrolment or unenrolment requests.

To query the status of a request, please provide the enrolmentRequestID returned from a successful enrolment or unenrolment request as a query parameter to the endpoint 3ds.live.pci.ravelin.com/merchant/query?enrolmentRequestID=[enrolmentRequestID]

Jump to Response

GET 3ds.live.pci.ravelin.com/merchant/query?enrolmentRequestID=[enrolmentRequestID]

Response

Show all
enrolmentRequestID string

The enrolment request ID returned from a successful enrolment or unenrolment request.

action string

Whether the merchants are being enrolled or unenrolled.

Options:
ENROL
UNENROL
status string

The status of the merchant enrolment or unenrolment request.

Options:
PROCESSING
COMPLETED
totalRecords integer

The number of merchants processed in this request.

successRecords integer

The number of merchants processed successfully.

failedRecords integer

The number of merchants for which processing failed.

merchants array

The merchants that have been enrolled or unenrolled as part of this request.

Hide definition
acquirerBIN string

Acquiring institution identification code as assigned by Mastercard.

acquirerCID string

Acquirer Company ID. This is the customer ID assigned to an acquirer by Mastercard.

acquirerICA string

Acquirer ICA (Interbank Card Association) number.

acquirerName string

The name of the acquirer with whom the merchant has a bank account.

acquirerMerchantID string

Acquirer-assigned merchant identifier.

merchantName string

Name of the merchant.

identityCheckExpress string

Indicates whether the merchant supports Mastercard’s Identity Check Express.

deleteReason string

The reason for unenroling a merchant. This will only be populated for unenrolment requests.

status string

Status of the merchant with regards to it’s enrolment or unenrolment.

Options:
Successful
Rejected
reason string

This will contain New Record Data for successfully enrolled merchants. Otherwise it will contain the reason why a merchant failed to enrol or unenrol.

{
  "enrolmentRequestID": "00000000-0000-0000-0000-000000000000",
  "action": "ENROL",
  "status": "COMPLETED",
  "totalRecords": 1,
  "successRecords": 1,
  "failedRecords": 0,
  "merchants": [
    {
      "acquirerBIN": "223456",
      "acquirerCID": "10",
      "acquirerICA": "123",
      "acquirerName": "adyen",
      "acquirerMerchantID": "235",
      "merchantName": "Test Merchant",
      "identityCheckExpress": "Y",
      "status": "Successful",
      "reason": "New Record Data"
    }
  ]
}

Feedback