Skip to main content

Set up and configure a Mastercard payment gateway instance


Set up and configure a Mastercard payment gateway instance

Set up and configure a Mastercard gateway instance by using the information in this article, including prerequisites, configuration procedure, descriptions of the configuration fields, and reference for testing the payment gateway.


If you are interested in using the Mastercard Payment Gateway Services functionality, you must go through a series of procedures to ensure that the feature can be used. 

  • You must configure the settings on the Mastercard payment gateway as below:
    • Select Purchase under Transaction Types in the Merchant Evaluation Registration Form when registering for a merchant account. If the merchant account is already created, you can contact your payment service provider to switch to Purchase Transaction Type.

    • Contact your payment service provider to enable privileges to perform Stand Alone Refunds.

    • Contact your payment service provider to configure token setup with Token Verification Strategy - AcquirerToken Management - Unique Account Identifier, and Token Generation Strategy - Random with Luhn.

    • Configure CSC Response Codes under Transaction Filtering - CSC Rules in the Mastercard Merchant Administration section as below:

      • For (M) CSC Match and (S) CSC Not Present On Card, select No Action.

      • For (U) Issuer Is Not Certified For CSC Processing, (N) No CSC Match, and (P) Not Processed, select Reject.

  • You must obtain the following information from the Mastercard payment gateway.
    • Merchant Id
    • API Password
  • Enable the Mastercard payment gateway integration for your tenant. See Enable payment gateway integrations for your tenant for instructions.


Take the following steps to set up and configure a Mastercard gateway instance:

  1. Click your username at the top right and navigate to Settings > Payments > Setup Payment Gateway
  2. On the Configure Gateway Instance tab, select Mastercard from the Gateway Type drop-down list.
  3. Click Create Gateway.
  4. Complete the information for the gateway instance. See below for more information on the fields.
  5. Click save gateway information after entering the necessary information.

Configuration fields

Basic Information

  • In the Name field, specify a name for the gateway instance.
  • If you want to use the Mastercard gateway test environment, select the Use Gateway Test Environment check box.


  • In the Merchant Id field, enter the unique merchant Id obtained from the Mastercard gateway.
  • In the API Password field, enter the unique API password obtained from the Mastercard gateway. See Generate Password for API for how to generate an API password from the Mastercard payment gateway.


  • In the Cards Accepted check boxes, select the credit cards that you accept.
  • In the  Default Authorization Amount field, specify the minimum default amount used to process a payment. The default value of this field is 1.  
  • If you want to verify new payment methods, select the Verify new payment method check box. By default, this check box is selected.
  • If you want to verify updated payment methods, select the Verify updated payment method check box. By default, this check box is selected.
  • Select Enable L2. You must enable this feature to avoid payment failures in some regions. For more information about the Level 2 data, see Overview of Mastercard payment gateway instance and Level 2 and Level 3 Card Data.

Test the configuration 

We recommend that you test your payment gateway using both your payment gateway's test and production (live) environments.  Once you have completed testing in the gateway's test environment, it is recommended that you perform a test in your live production environment with a real credit card. If there are any differences in the configuration of your testing and production accounts, testing in production ensures your production merchant account is set up properly and can successfully connect to the production environment.

You can use the test card information and testing scenarios provided by the gateway vendor to test your integration. See Mastercard's documentation for details.