Skip to main content

Integration Prerequisites

To integrate SmartPay for online payments, please ensure the following steps are completed:

  1. The Key Account Manager has been assigned to the project.

  2. The Product Solution Specialist has been assigned to the project.

  3. The required payment options for the project have been aligned via the contacts above.

  4. Please inform the Product Solution Specialist of the domain you intend to use for configuration.

    • Only domains with HTTPS are allowed; HTTP is not supported.

    • Domains containing localhost or 127.0.0.1 are not allowed. For local development and testing, an alias (e.g. "my-merchant-shop.local") can be configured in hosts file on your local machines. To ensure this alias functions correctly, follow these steps:

      • Whitelist the alias (e.g. my-merchant-shop.local) in the SmartPay Admin Portal for the corresponding Merchant key.
      • Ensure that the alias is configured in the hosts file on each developer's local machine, mapping the domain (e.g. "my-merchant-shop.local") to the 127.0.0.1 IP address. On Windows machines the hosts file is located at: C:\Windows\System32\drivers\etc\hosts.
    • Please note that domains with and without "www" are distinct. You can either choose one or provide both, for example, "https://www.domain.com" and "https://domain.com".

    • Use only the main part of the website address, like "domain.com", and skip any extras at the end, such as "https://domain.com/pay". SmartPay and the SmartPay User's Browser will disregard extra details.

    • Examples of valid domains:

  5. Ensure that the latest SmartPay SDK bundle is integrated into the web page from this link: sdk.smartpay.jpmmps.com/smp-bundle.js.

    Note: It is essential to link to this file from SmartPay servers and avoid self-hosting.

  6. To customize the appearance of SmartPay, reach out to your Product Solution Specialist to discuss available options for adapting the SmartPay Frontend (JavaScript/CSS) Library to meet your brand's styling requirements. The SmartPay Stylesheet Generator is the tool used for this customization, you can access it directly via this link: https://smartpay.cons.stylesheet.jpmmps.com.

  7. Make sure you have obtained the most recent Sandbox Merchant Key from the Sandbox vs. Production page.

  8. Configure your web server to allow SmartPay from "cons.sdk.smartpay.jpmmps.com" to access styles and fonts from your stylesheet by setting up Access-Control-Allow-Origin.