Merchant Enrollment

Certain services require merchant acceptors to be enrolled for merchants to be able to make use of them. We provide the Create Enrollment endpoint for this. The following services are currently available for merchants to enroll with:

3DS-Secure (Mastercard ISSM): required for merchants to be able to use SCA with Mastercard.
Network Token Requestor (VTS and SCOF): required for merchants to be able to request network tokens with Visa and Mastercard.

3DS-Secure (Mastercard ISSM)

Enrollment is generally an asynchronous process, this means that the initial result is a pending state, whereas the definitive enrollment state will be known at a later point in time. You can query the current status of your enrollments by invoking the Get all Enrollments endpoint.

There is a known latency from Mastercard ISSM indicating that it can take up to 24 hours for Mastercard to synchronize the merchant enrollment status in the Directory Server (DS). We suggest retrying the 3DS charge/authentication later. If the same error persists even after 24 hours of successful enrollment, please contact us. Example request:

Network Token Requestor (VTS and SCOF)

When enrolling merchants for Mastercard SCOF through our endpoint, we in turn use the Mastercard Checkout Solutions API - Registration to complete this process. However this is a batch wise process where we submit the merchant details and a SRCiDPAID per merchant. We continuously query the Mastercard systems whether the batch has been processed successfully. Once we get a 'completed successfully' the enrollment has been completed and this will also be reflected in our systems. Once the enrollmentStatus is equal to enrolled the enrollment key can be used to tokenize cards.

Enrollment is generally an asynchronous process, this means that the initial result is a "pending" state, whereas the definitive enrollment state will be known at a later point in time. You can query the current status of your enrollments by invoking the Get Enrollments endpoint.

Note - make sure that the information provided in the enrollments for SCOF and VTS is correct as updating information with the card networks is a manual process”.

Mastercard SCOF Enrollment

The merchant identifier for Mastercard is called the DPA and is required for merchants to be able to request network tokens with Mastercard.

Note that since this is a batch wise process it could take up to 5 minutes, depending on the size of the batch, before enrollment is successful.
Note - for SCOF enrollments, the programType should be merchant_obo. We do support commerce_platform_obo technically but enabling this functionality requires alignment with Mastercard.

Visa VTS Enrollment

For Visa VTS, a similar enrollment process is followed which is performed via the Visa Digital Solutions API - Onboarding. This is also a batch wise process and there is some delay between the initial registration and the confirmation that this has been completed successfully. Once the enrollmentStatus is equal to enrolled the enrollment key can be used to tokenize cards. Here is an example request:

The merchant identifier for Visa is called the TRID and is required for merchants to be able to request network tokens with Visa.

Note that for Visa it could take up to 2 business days for the VTS enrollment is ready.