Update Merchant Acquirer Link
Allows you to add or update configuration for an acquirer link used by the merchant for payment processing. A merchant can be configured for one or more acquirer links where each acquirer link must have a unique identifier provided in the merchant.acquirerlLink.id field. You must use separate API calls to create or update each link.
You cannot delete an acquirer link once the merchant is approved. However, you can set merchantAcquirerLink.status to Disabled to prevent the merchant from performing transactions using this acquirer link.
Acquirer Information
Depending on the acquirer, you may be required to include or exclude some of the fields, or provide additional fields specific to this acquirer in the Update Merchant Acquirer Link request. Key points to note:
- The fields specific to an acquirer are contained in the
merchant.acquirerLink.acquirergroup. For example, fields that are specific to the acquirer 'PayPal' are grouped undermerchant.acquirerLink.acquirer.paypal. - The fields that are not specific to an acquirer may be mandatory, optional, or not applicable, depending on the acquirer. For example, for the acquirer 'giropay', the field
merchant.acquirerLink.cardTypesis not applicable as this acquirer is used for online bank transfer. - The valid values for a field differ based on the acquirer. For example, for the acquirer 'TSYS', Euro (EUR) is not a valid currency.
Contact the gateway to access these details for the acquirers you wish to configure. Building this information into your integration will enable you to provide valid values for the relevant fields in the Update Merchant Acquirer link request.
Exclusion Rules Information
You can configure exclusion rules that define the type of cards that can be processed through the merchant-acquirer link. These rules can be based on the funding method and the issuer country of the payer's card. You can set up the exclusion rules for the merchant-acquirer link based on the business requirements of the merchant or MSO. The funding methods that are supported for the exclusion rules are credit, debit, charge, and unknown. You can specify all countries or selective countries while configuring the exclusion rules for a merchant.
The parameter group merchant.acquirerLink.exclusionRules allows you to specify different fields based on card type, funding method, and country of issuance of the payer's card. You can use the following fields when you configure the exclusion rules.
merchant.acquirerLink.exclusionRules.cardTypes: Allows you to define the list of supported card types for the merchant acquirer link for which the exclusion rules to be applied If you do not provide this field or you provide the field without entering the card type, the exclusion rule will apply to all cards.merchant.acquirerLink.exclusionRules.fundingMethods: Allows you to define the list of supported card types for the merchant-acquirer link for which the exclusion rule should be applied. If you do not provide this field the exclusion rule will apply to all cards.merchant.acquirerLink.exclusionRules.issuerCountries: Allows you to define the list of issuer countries for which the exclusion rule should be applied. You need to provide the three-letter country code as per the ISO 3166 alpha-3 standards.merchant.acquirerLink.exclusionRules.excludedIssuerCountries: Allows you to define the list of issuer countries that you want to exclude from the exclusion rule. You need to provide the three-letter country code as per the ISO 3166-1 alpha -3 standards.merchant.acquirerLink.exclusionRules.unknownIssuerCountry: Allows you to define the action taken by the gateway when the gateway is unable to determine the issuer country of the payer's card.
For example,if you want to exclude transactions for all debit cards issued in Canada, provide the field values as merchant.acquirerLink.exclusionRules.fundingMethods=[DEBIT]
and merchant.acquirerLink.exclusionRules.issuerCountries=[CAN]. For more information on how to use these parameters, see merchant.acquirerLink.exclusionRules under the Update Acquirer Link section in the API Reference tab.
Payment Plan Information
You can enable payment plans supported by the gateway and the acquirer on a merchant acquirer link by providing the plan ID and the configuration details of the payment plan. See Payment Plan Information to retrieve the plan ID for the payment plan you wish to configure for the merchant.
3-D Secure Scheme Information
You can enable 3-D Secure schemes supported by Mastercard Gateway and the acquirer on a merchant acquirer link by providing the credentials and the configuration details for the scheme. Note that if you provide credentials for a 3-D Secure scheme for one of the acquirer links, then you must provide details on all the acquirer links configured for the merchant else you will not be able to approve the merchant.