Add MasterCard to your payments ecosystem

To connect MasterCard to Paydock, you will need to have a merchant account with them. You can complete the MasterCard Sign Up process here.

Step 1: Look up your MasterCard credentials

Your MasterCard gateway credentials, including your Merchant ID and API password, can be found by logging into your Mastercard Merchant Administration account. You can obtain your password by completing the following steps:

  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 required fields to connect:
    1. Label - Specify the name by which you will recognize this service later. This is just for your reference. In Paydock, you can add multiple instances of a service, which can be helpful for tracking campaigns or income streams.
    2. Merchant - This is your MasterCard Merchant ID.
    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're using.
  6. Click Connect. You have successfully connected MasterCard to Paydock!

If you would like to connect this service via API, please use this guide.

Note: Paydock currently only supports the Asia Pacific region and AUD currency for the MasterCard gateway.

Connecting 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 online 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: Look up and configure your credentials from your Apple Pay account

  1. To integrate Apply Pay, you need to have an Apple Developer Account. For more information and to register, please follow the instructions in this article.
  2. Follow these instructions to configure all the required details in your Apply Pay Account:
    • 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.
  3. After the credentials 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 can only be completed by adding a new MasterCard gateway to your Paydock account:

  1. 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. Complete the required fields to connect Apple Pay:
    1. Merchant ID - This is your Apple Pay merchant ID.
    2. Domain - This is the registered merchant’s domain.
    3. Merchant ID Certificate - This is the TLS certificate associated with your merchant ID, used to authenticate your sessions with the Apple Pay servers.
    4. Merchant ID Key - This is the key associated with the Merchant ID Certificate;
    5. Payment Processing Certificate - This is a certificate associated with your merchant ID, which is used to secure transaction data.
    6. Payment Processing Key - This is the key associated with the Payment Processing Certificate.
  4. Click Connect. You have successfully connected MasterCard with Apple Pay to Paydock!

Adding the Apple Pay Checkout button

The Apple Pay Checkout button can be added to your checkout page 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.

Here 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. Customers will be able to update their Credit Card and Billing information (Shipping is not in the first version scope) and confirm.
  5. 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 your customer's shipping details with Apple Pay. To use this option with your widget, you will need to include the following identifications relevant to your 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