Skip to main content

Overview of MasterCard payment gateway integration

Zuora

Overview of MasterCard payment gateway integration

Supported features

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: