Skip to main content

Overview of MasterCard payment gateway integration

Zuora

Overview of MasterCard payment gateway integration

Supported features

The MasterCard payment gateway integration is in limited availability. If you want to enable this gateway integration, submit a request at Zuora Global Support.

The following table provides a quick reference for the supported features. For details about each feature, see the later sections in this article.

Supported payment methods
  • Credit Card/Prepaid Card/Gift Card
  • Credit Card Reference Transactions
Supported payment operations 

Validate (Both zero and non-zero amounts), Payment, Referenced refund, Non-referenced refund, Cancel

Support 3D Secure 2.0 No
Support Delayed Capture No
Support Level 2 and Level 3 card data Support only Level 2 card data
Support stored credential transactions No
Support Gateway Options fields No
Gateway provider’s API version version 59
MasterCard production endpoint used for Zuora gateway integration service

https://na-gateway.mastercard.com/api/rest/version/50/merchant/

https://na-gateway.mastercard.com/api/rest/version/50/merchant/{merchant-id}/order

https://na-gateway.mastercard.com/api/rest/version/50/merchant/{merchant-id}/token

Support Gateway Reconciliation No
Support Payment Method Updater No

Supported payment methods

The Mastercard payment gateway integration supports the following payment methods:

  • Credit Card/Prepaid Card/Gift Card:
    • Visa
    • Visa Electron
    • MasterCard 
    • Maestro
    • American Express
    • Diners
    • JCB
    • Discover
  • Credit Card Reference Transactions

Support for Level 2 card data

The Mastercard gateway integration supports processing the following Level 2 card data for both Credit Card and Credit Card Reference Transaction payment methods. You must enable this feature to avoid payment failure in some regions.

  • order.taxAmount
  • order.itemAmount

The following table describes the data mapping relationship between Mastercard and Zuora for Level 2 card data processing:

Mastercard Zuora
order.taxAmount The sum of Tax*(Applied Amount/Invoice Amount)
order.itemAmount Total Amount - Tax Amount

For how to enable this feature in Zuora, see Set up and configure a MasterCard payment gateway instance.

For more information about Level 2 card data processing, see the following articles: