Versions Compared

Old Version 14

changes.mady.by.user Nick Mank (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Nick Mank (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt
nameSet and Config Intro

The Setting and Configuration tab allows you to set up payment options and manage the URLs needed to make your payment page fully functional.

Image RemovedImage Added

Apple Pay

Excerpt
nameApple Pay

The Apple Pay offers a way for customers to make payments quickly and securely by saving payment methods to the Apple service. When a customer makes a purchase on your website, they are present with the saved payment options. They can then chose the payment option to use and complete the transactionsimpler and more secure alternative to using physical credit, debit, or prepaid cards. It allows you to accept payments in stores, apps, or on the web using built in hardware and software security features to make these payments easily, securely, and privately.

 MerchantE can facilitate the processing of transactions using Apple Pay directly from your website using the Payment Gateway or by using a Hosted Payment Page. This document outlines the process for submitting payments directly to the Payment Gateway.

Adding a Payment Card to Apple Wallet

When a customer creates an Apple Wallet account, payment methods must be added to wallet to make purchases. The diagram below shows the process which enables a payment method in Apple Wallet.

Image RemovedImage Added

  1. Customer adds a payment card the physical card number (FPAN) to Apple Wallet.

  2. Apple Wallet adds the device primary account number (DPAN) and personal details to the Apple Pay server.

  3. Apple Pay registers the DPAN and person details with the Issuer Bank.

  4. The Issuer Bank generates the Payment Token, Payment Token Key, and CVV Key and sends it to Apple Pay.

  5. Apple Pay generates the DPAN and provides the Payment Token Key, and CVV Key to Apple Wallet.

  6. coordinates with the card network to validate the customer.

  7. The DPAN is generated and added to the iPhone secure element. The DPAN from the iPhone secure element is then used for Apple Pay transactions.

Making a Purchase using Apple Pay

Once payment methods have been added to Apple Pay, the method can be used to make purchases from Apple Pay compliant merchants. The diagram below shows the transaction processing when a purchase is made using Apple Pay.

Image Removed

  • Apple Wallet verifies the customer identity and sends the DPAN and the Dynamic Cryptogram to the Merchant.

  • The Merchant provides the Payment Token to MerchantE.

  • MerchantE sends the DPAN and Dynamic Cryptogram to the Issuer Bank.

  • The Issuer Bank verifies the transaction.

    • The transaction verification Image Added

    1. Biometric authentication is used to verify the customer.

    2. The Apple Pay servers encrypt the DPAN from the secure element to generate a payment token.

    3. The payment token is sent to the Merchant or the Hosted Payment Portal. If using the Payment Gateway directly, the payment token must be decrypted.

    4. The transaction information is sent to MerchantE.

    5. The Merchant receives the verification and completes the transaction.

    6. Apple Wallet is notified of the approved transaction.

    When a user purchases goods or services from your website, PassKit (mobile) or Apple Pay JS (Safari) determines they are using a qualified device. If they are using a qualified device, the Apple Pay button will appear as one of the payment options.

    Info

    Note: The Apple Pay button will only be displayed if using an approved Apple device or the Safari browser.

     If the customer selects Apple Pay as the payment method, they are immediately presented with the Payment Sheet. The Payment Sheet will present the customer with their stored payment options. This includes the card payment option and address.

    Info

    Note: If no payment options are available, the customer will be directed to set up an Apple Pay account with stored payment options.

    Once the customer has selected a payment option and authorizes the request using a linked device, a payment request is created. If authorization succeeds, a payment object is generated. The payment object contains all the customer data and the payment token.

    The payment token is then decrypted by the MerchantE Payment Gateway. The decrypted sent to the Merchant or the Hosted Payment Portal. If using the Payment Gateway directly, the payment token must be decrypted. The payment token contains:

    • Device specific authorization number (DPAN)

    • Payment amount

    • One-time-use cryptogram

    The contents of the decrypted payment token are is then sent to the card issuer to complete the payment.

    ...

    Excerpt
    nameHPP Surcharging
    Image RemovedImage Added

    A payment card surcharge, also known as a checkout fee, is an additional percentage-based fee that a merchant adds to a transaction when a credit card is used for payment. You can add surcharges to credit card payments to offset the cost of processing the transaction. Surcharges are only valid for credit card transactions and cannot be applied to debit cards, prepaid cards, or ACH transactions.

    Info

    As of April 2023, the maximum surcharge rate is 3%. This rate must be set in the MerchantE Business Portal.

    Initiating Surcharges:

    • The card brand must be notified 30 days in advance of beginning the surcharge. Consult the surcharge rules for each card brand accepted. On the registration forms, it is important that you list:

      • “MerchantE” as the “Acquirer/Payment Service Provider”

      • “Brand” as the “Type of Surcharge.”

    • Some states prohibit surcharging. Consult your legal counsel to ensure that you are in compliance with relevant state laws. The table shows states and US territories where surcharging is prohibited or prohibited but unenforceable due to pending litigation (October 2022).

    Surcharge Prohibited

    Pending Litigation

    Connecticut (CT)

    Massachusetts (MA)

    Puerto Rico (PR)

    California (CA)

    Kansas (KS)

    Maine (ME)

    New York (NY)

    Oklahoma (OK)

    Texas (TX)

     

    ...

    Excerpt
    nameRecurring Payments

    The Recurring Payment setting enables you to offer your customers the option to set up recurring payments. When this feature is enabled, you can establish whether your customers can select their preferred frequency, or you can limit the frequency options to only one (or a limited section of frequencies). Select one or more of the boxes to enable: weekly, bi-weekly, and monthly.

    Info

    Note: Customers can only select a payment frequency that you have enabled. The recurring payment option is available to those who have registered their payment account in Hosted Payments. The recurring payment option is not available to those who checkout as guests.

    Applying Custom Amount and Recurring Payments

    ...

    Excerpt
    nameManage URLs

    The Manage URLs section allows you to manage the various URLs needed to make your payment page fully functional.

    Image Added

    Payment Page URL

    The Payment Page URL will redirect your customer from your website to the Hosted Payment Page. Additional details on how to utilize this URL can be found in the Hosted Payments Implementation section.

    Redirect URL

    The Redirect URL is intended to redirect your customer back to your website. Upon successful checkout, your customer will have the option to be redirected to the URL specified in this field.

    Note

    Caution: It is strongly recommended to specify this address so that customers can navigate back to your website upon completing checkout.

    Advanced URLs Management

    For most Hosted Payments integrations, the process stops after the customer submits their payment. However, there are some merchants who need additional information feed into their back-end systems. The settings in this section are optional and are intended for those who need advance integrations into the Hosted Payment Product. Additional details about how to utilize this section can be found in the Hosted Payments Implementation section.

    ...

    Excerpt
    nameSite Customization

    The HPP Customization tab is the area where you can modify the look the of the Hosted Payments page that your customer sees to best reflect your brand. You can select a theme color, upload a logo, and add links to your company’s Terms of Service and Policy.

    Background Color

    The background color dictates the color of the background on the checkout related screens. You can select a theme color by picking a color box or you can enter the hex code. The color box allows you to modify the color and the opacity of the background.

    You can upload your logo by clicking on the Upload Logo Files button. Your image must be PNG, JPG, or GIF format. The file size cannot exceed 265KB.

    Info

    Note:

    The actual image size is limited to 70 by 70 pixels.

    It is strongly recommended to have a company logo specified so that customers have the certainty they are still within your company’s checkout system.

    The footer will appear at the bottom of your payment page. It will display your company name and all rights reserved. Additionally, you can upload your Terms of Service Policy and your Privacy Policy to your payment page. When one or both links are provided, we add the links to the footer.

    Theme Color

    The theme color controls, links, transaction amount, buttons, and user icon of the payment page and the customer dashboard. You can select a theme color by picking a color box or you can enter the hex code.

    ...