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.

Enrol

This endpoint allows you to enrol merchants with Mastercard’s ISSM tool. Once enrolled, merchants can participate in Mastercard’s 3DS2 authentications.

Field Status Definitions
Required Required fields must be sent. If the data is not sent Ravelin will return an error.
Important Important fields are crucial for performance.
Optional Optional fields are additional data points that can be shared with the card schemes, issuers, and Ravelin. These fields may impact performance or dashboard usability.
Conditional Fields that may be required under certain conditions.

Jump to Response

POST 3ds.live.pci.ravelin.com/merchant/enrol

Show all
scheme string
required

The card scheme for which the merchant is being enrolled.

Conditions:

Must be Mastercard

product string
required

The product for which enrolment is taking place.

Conditions:

Must be Identity Check

merchants array
required

The merchants which will be enrolled.

Hide definition
Maximum length: 1000
acquirerBIN string
required

Acquiring institution identification code as assigned by Mastercard. This should match the acquirerBIN.

This value should start with 2, 5, or 6.

Maximum length: 6
acquirerCID string
important

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

This value should not contain empty spaces.

Maximum length: 10
acquirerICA string
important

Acquirer ICA (Interbank Card Association) number.

Maximum length: 11
acquirerName string
important

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

acquirerMerchantID string
required

Acquirer-assigned merchant identifier. This should match the acquirerMerchantID.

Maximum length: 24
merchantName string
required

Name of the merchant being enrolled. This should match merchantName.

Maximum length: 25
identityCheckExpress string
optional

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

Options:
Y
N
POST https://3ds.live.pci.ravelin.com/merchant/enrol HTTP/1.1
Authorization: token ...
Content-Type: application/json

{
  "scheme": "Mastercard",
  "product": "Identity Check",
  "merchants": [
    {
      "acquirerBIN": "223456",
      "acquirerCID": "10",
      "acquirerICA": "123",
      "acquirerName": "adyen",
      "acquirerMerchantID": "235",
      "merchantName": "Test Merchant",
      "identityCheckExpress": "Y"
    }
  ]
}

Response

Show all
status string

The status of the merchant enrolment request.

Options:
PROCESSING
COMPLETED
enrolmentRequestID string

The ID of the enrolment request, returned by Mastercard.

totalRecords integer

The number of merchants processed in this request.

{
  "status": "PROCESSING",
  "enrolmentRequestID": "00000000-0000-0000-0000-000000000000",
  "totalRecords": 1
}

Feedback

© Ravelin Technology Ltd. All rights reserved