LogoLogo
BlogLogin
English
English
  • An Introduction to Saferpay
    • Licensing
      • Legacy licensing
    • Reconciliation
    • Acquirers & Payment Methods
    • Web Shop Plugins and certified partners
      • ePages Beyond
      • ePages NOW
      • Magento 2
      • Odoo
      • PrestaShop
        • PrestaShop User Guide
      • Salesforce Commerce Cloud
      • SAP Commerce Cloud
      • Shopware 6
        • Shopware 6 User Guide - German
        • Shopware 6 User Guide - English
      • WordPress WooCommerce
      • Shopify
    • Supported Languages
    • Common Saferpay terms - Glossary
  • News
    • Changes for transactions without customer presence
    • Changes for the Saferpay Hosted Forms, Fields and Payment Page
  • Quick Links
    • Web Shop Plugins and certified partners
    • Secure PayGate
    • User Administration
    • Payment Page Configuration
    • Risk Management
    • API Authentication
  • Interfaces
    • Payment API (aka JSON API)
    • Management API
    • Backoffice
      • The Home screen
      • Batch Processing
      • Transactions
        • Transaction Details
        • Batch Close
        • Declined transactions
        • Pending authorizations
        • Analytics
        • SEPA Refunds Export
        • Authorization & Payment
        • Credit
      • Risk Management
      • Secure PayGate / Payment Links
      • Secure Card Data
        • Secure Card Data Details
      • Settings
        • JSON API basic/Client Certificate authentication
        • User Administration
        • Payment Page Configuration
      • Online Support
      • User Profile
    • Saferpay OnSite
    • Feedback
  • Integration Guide
    • Integrating Saferpay
    • Ways of integration
      • General Information
        • Data Security and PCI DSS
        • Versioning
        • 3-D Secure
        • PSD2
        • Dynamic Currency Conversion
        • Iframe Integration and CSS
        • Fraud Intelligence
          • Silver
          • Fraud Intelligence Integration
      • Payment Page
        • Payment Page checklist
      • Transaction Interface
        • Recurring Payments
        • Refunds
          • SEPA Refunds
      • Capture and Daily Closing
        • Partial Captures
          • Marketplace
      • Secure Card Data - Tokenization
      • Saferpay Fields
      • Inquire Interfaces
      • Mobile Integration
      • Omni-Channel
      • Mail Phone Order
      • Error Handling
      • API Health Check
      • Saferpay API Specification
    • Payment Methods & Wallets
      • General and special cases
      • Account-to-Account Payments
      • Alipay+
      • Apple Pay
      • American Express
      • Bancontact
      • Billie
      • blik
      • Click to Pay
      • Diners Club International & Discover Card
      • eps
      • giropay
      • Google Pay
      • iDEAL 2.0
      • JCB
      • Klarna Payments
      • Maestro International
      • Mastercard
      • paydirekt
      • PayPal
      • PostFinance Pay
      • Przelewy24
      • Reka
      • SEPA Direct Debit
      • Sofort by Klarna
      • TWINT
      • UnionPay
      • Visa & V PAY
      • WeChat Pay
      • WL Crypto Payments
    • Testing
    • Go-Live
    • Frequently Asked Questions
    • Saferpay Demo
      • Saferpay Demo Environment
      • Saferpay Demo Shop
    • Support
    • Changelog
Powered by GitBook
On this page
  • General requirements
  • Technical requirements
  • Supported features
  • Mastercard Issuer Installments
  • Prerequisites
  • Receiving installment options
  • Choosing an installment plan
  • Testing

Was this helpful?

  1. Integration Guide
  2. Payment Methods & Wallets

Mastercard

PreviousMaestro InternationalNextpaydirekt

Last updated 4 months ago

Was this helpful?

Saferpay offers the possibility to accept different brands of credit cards, one of which being Mastercard.

General requirements

The handling of Mastercard with Saferpay requires:

  • A and thus a valid identification with a username and password for the Saferpay system.

  • Availability of at least one active Saferpay terminal via which payment can be carried out and availability of the associated Saferpay TerminalId.

  • A valid acceptance contract with a respective acquirer, e.g. SIX/Worldline.

For Mastercard activation on the Saferpay terminal, please contact your sales contact.

Technical requirements

The general integration of Mastercard can be done either via the , or the and does not require any special attention, besides what is mentioned in the respective chapters.

Furthermore, for other flows (Refunds etc.), please refer to the table above.

Supported features

Feature

Support

✅

✅

✅

✅

✅

✅

✅

Mail Phone Order

✅

✅

✅

Mastercard Issuer Installments

Prerequisites

For a merchant to enable Mastercard Issuer Installments, the following prerequisites are required:

  • Saferpay E-Commerce licence.

  • Saferpay E-Commerce terminal.

  • Acquiring contract with Worldline.

  • Mastercard Issuer Installments are activated on the terminal. Please contact your local Sales contact to activate a terminal for Mastercard Issuer Installments.

Receiving installment options

It is important to know that the availability of installment options is up to the issuing bank and not the merchant or the card holder. All Mastercard transactions potentially offer Issuer Installments. However, it's the issuer who decides whether or not to offer installment options for a given transaction. Installment options are only returned as a result of the the authorization. This means that the card holder has to go through a standard transaction flow first, either by using or . the Saferpay Payment Page Transaction Interface If the Issuer decides to offer installment options, he can do so in two different ways. The necessary information will be returned by Saferpay through the Pa or responses respectively, inside the MastercardIssuerInstallments container.yment Page Assert Transaction Authorize Inside this container you will find one of two types of installment plans:

A Fixed plan:

The issuer may propose one or more fixed installment plans. Saferpay will in this case return an array of JSON-Objects, containing the information about the proposed plans within the array MastercardIssuerInstallments.InstallmentPlans:

{
  "MastercardIssuerInstallments": {
    "InstallmentPlans": [
      {
        "NumberOfInstallments": 12,
        "InterestRate": "1000",
        "InstallmentFee": {
          "Value": "1000",
          "CurrencyCode": "CHF"
        },
        "AnnualPercentageRate": "500",
        "FirstInstallmentAmount": {
          "Value": "100000",
          "CurrencyCode": "CHF"
        },
        "SubsequentInstallmentAmount": {
          "Value": "180000",
          "CurrencyCode": "CHF"
        },
        "TotalAmountDue": {
          "Value": "1180000",
          "CurrencyCode": "CHF"
        }
      },
      {
        "NumberOfInstallments": 6,
        "InterestRate": "1000",
        "InstallmentFee": {
          "Value": "1000",
          "CurrencyCode": "CHF"
        },
        "AnnualPercentageRate": "500",
        "FirstInstallmentAmount": {
          "Value": "100000",
          "CurrencyCode": "CHF"
        },
        "SubsequentInstallmentAmount": {
          "Value": "360000",
          "CurrencyCode": "CHF"
        },
        "TotalAmountDue": {
          "Value": "1180000",
          "CurrencyCode": "CHF"
        }
      }
    ],
    "ReceiptFreeText": "Some dummy receipt free text"
  }
}

A custom plan

The card holder can choose the number of installments within the boundaries given by the issuer. In this case, the MastercardIssuerInstallments.CustomPlan container is returned:

{  
  "MastercardIssuerInstallments": {    
    "CustomPlan": {      
      "MinimumNumberOfInstallments": 3,
      "MaximumNumberOfInstallments": 37,
      "InterestRate": "1100",
      "InstallmentFee": {
        "Value": "1200",
        "CurrencyCode": "CHF"
      },
      "AnnualPercentageRate": "600",
      "TotalAmountDue": {
        "Value": "1190000",
        "CurrencyCode": "CHF"
      }
    },
    "ReceiptFreeText": "Some dummy receipt free text"  
  } 
}

Important: Either the first or the second option will be available, but not both. Once the installment options are returned, the merchant has to present the options to the card holder in a way compliant with the relevant Mastercard guidelines. The card holder must be able to choose whether to accept one of the proposed plans, or not.

Choosing an installment plan

{  
  "MastercardIssuerInstallments": {
    "ChosenPlan": {
      "NumberOfInstallments": 12,
      "InterestRate": "1100",
      "InstallmentFee": {
        "Value": "1200",
        "CurrencyCode": "CHF"
      },
      "AnnualPercentageRate": "600",
      "TotalAmountDue": {
        "Value": "1190000",
        "CurrencyCode": "CHF"
      }
    }
  }
}

Testing

/

Mastercard offers together with participating issuers an installment solution where the merchant will immediately receive the full amount of the payment, and the card holder pays back the transaction amount to his issuing bank in installments according to the chosen installment plan. Installment options will only be available if the merchant has implemented the functionality as described below and the issuing bank supports Mastercard Installments, and decides to offer them for the transaction at hand. The functionality can be enabled upon request. Interested merchants can contact the to verify that the local issuers support this feature in the countries where the merchant is active.

If the card holder chooses an installment plan, the data of said plan must be sent back to Saferpay through the request, by submitting the information of the chosen plan through the MastercardIssuerInstallments container. With the of the transaction, the plan has been chosen, the merchant will immediately recieve the money, while the card holders bank handles the installment itself.

Please refer to , if you want to test Mastercard.

corresponding license
Payment Page
Transaction Interface
Mastercard Global Customer Service
Capture
capture
Multipart Captures
Secure Card Data
Refunds
Recurring Payments
3D Secure
Dynamic Currency Conversion
Omni-Channel
Testing
Capture
this chapter
Cancel