MasterCard

Supported Features:

Add MasterCard to your payments ecosystem

To connect MasterCard to Paydock, you will need to register for a merchant account, completing MasterCard Sign Up process.

Step 1: Gather your credentials from MasterCard

Firstly, you will need to gather your credentials from Mastercard, this includes your Merchant ID, API password. You can find these parameters by logging into your Mastercard Merchant Administration.

Here is how to obtain your password:

  1. Login into the Mastercard Merchant Administration.
  2. Navigate to Admin > Integration Settings.
  3. Click the Edit button in the section Integration Authentication.
  4. Enable Password 1 (or Password 2) and generate a password.
  5. Click the Submit button.

Step 2: Connect MasterCard to your Paydock Account

  1. Log into your Paydock Production or Sandbox account;
  2. Navigate to Services from the menu on the left;
  3. Click on the Add New tab from the top of the page;
  4. Navigate to or search MasterCard and click on the Activate button;
  5. Complete the field descriptions to connect. Field descriptions are as follows:
    1. Label – this is for your reference only. In PayDock, you are able to add multiple instances of a payment gateway or method. This can be helpful for tracking campaigns or income streams.
    2. Merchant – this is your MasterCard Merchant ID here.
    3. Password – this is your MasterCard API password.
    4. Select Environment Mode – this describes whether you are connected to a MasterCard Production or a Sandbox Environment. Production is used to process real transactions. Sandbox is used for testing purposes only. Please ensure you’re using the correct set of credentials for the type of environment you require to use. 
  6. Click Connect. You have successfully connected MasterCard to Paydock!

If you would like to create a gateway using a Paydock API call, feel free to use this guide.

NB: It's worth noticing that we currently only support the Asia Pacific region and AUD currency for MasterCard.


How to connect Apple Pay with MasterCard

Apple Pay is a digital wallet service by Apple Inc. that allows merchants to make payments in person, in iOS apps, and on the web using the Safari internet browser. This feature is supported on the iPhone, Apple Watch, iPad, and Mac.

In order to integrate your Apple Pay account using the MasterCard gateway, you will need to have both Apple Pay and MasterCard accounts set up. 

Step 1: Gather and configure your credentials from your Apple Pay account

First of all, you need to have an Apple Developer Account and complete the registration. For more information, please check this article.

Follow these instructions to configure all the required details: 

  • Merchant ID - This uniquely identifies you to Apple Pay as a merchant who is able to accept payments.
  • Payment Processing Certificate - This certificate is associated with your merchant ID and is used to secure transaction data. Apple Pay servers use the certificate’s public key to encrypt payment data
  • Merchant Identity Certificate - This is the TLS certificate associated with your merchant ID, which is used to authenticate your sessions with the Apple Pay servers.

Note: The Apple Pay payment token decryption is made on Paydock’s side and not on the gateway's.

After the details are configured, please upload the Apple Payment Processing Certificate to the MPGS Merchant Administration dashboard by going to Admin > Device Payments > Add New Certificate.

Step 2: Connect Apple Pay with the Mastercard gateway

The Apple Pay integration is only possible when adding a new MasterCard gateway:

  1. Please add a new MasterCard service as described in the MasterCard section above.
  2. Check Enable Wallet Payment after filling out the MasterCard fields.
  3. The Apple Pay field descriptions appear once the Wallet Payment is enabled. Please fill out the field descriptions:
    a) Merchant ID - This is what uniquely identifies you to Apple Pay as a merchant who is able to accept payments.
    b) Domain - This is the registered merchant’s domain.
    c) Merchant ID Certificate - This is the TLS certificate associated with your merchant ID, used to authenticate your sessions with the Apple Pay servers.
    d) Merchant ID Key - This is the key associated with the Merchant ID Certificate;
    e) Payment Processing Certificate - This is a certificate associated with your merchant ID, which is used to secure transaction data. Apple Pay servers use the certificate’s public key to encrypt any payment data.
    f) Payment Processing Key - This is a key associated with the Payment Processing Certificate.
  4. Click Connect. You have successfully connected MasterCard with Apple Pay to Paydock!

 How to add the Apple Pay Checkout button

The Apple Pay Checkout button can be added to the website via the Client SDK package. You can find the instructions on how to integrate the button into your website here in the Wallet Buttons section. 

 Below is the step-by-step flow of the Apple Pay checkout button:

  1. Create a wallet token to utilize it in the Client SDK using the {{url}}/v1/charges/wallet endpoint.
  2. Use our Client SDK to create a payment form with the checkout button that displays the ApplePay Payment Sheet to clients.
  3. After clicking the Apple Pay button, the Apple Payment Sheet is displayed.
  4. Clients will be able to update their Credit Card and Billing information (Shipping is not in the first version scope) and confirm.
  5. Finally, the ApplePay sheet is closed. 

Note: Please keep in mind that Apple Wallet is only available in a Safari browser on iPhone. Users need to have the Apple Wallet pre-configured.


Note: You can pass customer’s shipping details with Apple Pay. To use this option for your widget, you will need to include the following identifications depending on the use case: electronic, ground, not_shipped, overnight, pick_up, priority, same_day.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us