Onboard a merchant

Use these APIs to onboard a merchant for Visa and Mastercard TSPs.

Important

• Merchant onboarding is one-time. You can’t update or delete a merchant after onboarding.
• For Visa, wait 5–7 days after a successful onboarding notification before starting tokenization. Visa applies an internal validation window.

1. Merchant creation flow

Merchant creation flow

Step	Description
1	The merchant aggregator/PSP sends a merchant creation request with merchant name.
2	Thales backend creates the merchant in its database and returns an unique identifier.

API

• API reference: Create merchant

2. Merchant registration flow

Payment network merchant registration flow

Step	Description
1	The merchant aggregator/PSP sends a registration request per payment network. The request includes a merchantId, a x-correlation-id, and specific payment network parameters.
2	Thales backend acknowledges the request.
3	Thales backend registers the merchant with the payment network.
4	Thales backend notifies the PSP with the result and the Token Requestor Identifier (TRID).

API

• API reference: Update merchant Mastercard (S-COF)
• API reference: Update merchant Visa
• Callback reference: Notify merchant update