Search Overlay
Searchbox clear search filters ESC
Filter PreferencesClear

No results found

Shopify: Embedded Credit Card

Paysafe's Embedded Card Payments app is a customizable payment form solution that embeds directly into your website to create a streamlined checkout to match your website design, offering a swift and frictionless customer experience.

  • Global coverage: Transact worldwide and grow your business.
  • Quick and easy sign-up: Simple process to create a merchant account.
  • Fully PCI compliant: Secure check-out solution.
  • Full and partial refunds: Support both refund types.

Installing and Configuring Extension

  1. Log into your Shopify Account (if not already logged in) using your username and password.

  2. Once logged in, click here to access Paysafe Embedded Card Payments app.

  3. Click the Install button to begin the app installation process. If you manage multiple stores, select the store where you wish to install the Paysafe Embedded Card Payments app.

  4. Upon redirection, you will reach the merchant account configuration screen.

  5. Enter your Merchant Id (PMLE ID) and Private API key (Secret Key). Paysafe provides these credentials upon successful signup and creation of your Private API key via Paysafe Optic Portal.

    1. Log in to the Paysafe Optic Portal using the link in the Welcome email you received after successfully signing up and activating your account Login to Paysafe (link provided in the Welcome email upon successful signup and account activation).
    2. Navigate to Developer > API KEY to find your Merchant Id/PMLE ID (highlighted as “1” in the image below) and Private/Secret API key (need to authenticate to view secret key, highlighted as “2” in the image below).
    3. Use the copy button (in the second image below) to ensure the Private API key is copied properly.
    4. If you are using Netbanx instead of the Optic Portal, the procedure is very similar. You can find your keys under Settings→API keys.
      1. The Merchant ID (PMLE) number is part of the API username, located after the minus (-) sign in the API username (as shown in the third image below, marked as 1). Copy it correctly and paste it into the MERCHANT ID field.
      2. Copy the API key using the copy key button (as shown in the third image below, marked as 2) and paste it into the PRIVATE API KEY field.
      3. Note: Each time you create or update an API key, a security token will be sent to your email, which you’ll need to enter.

  6. Click Verify Account.

    Note: Make sure the password string is copied properly. Expected format of API key is “username:password”, for example:

    pmle-339612:B-p1-0-671ac2c6-0-302c021415b4dd1a62a05302be43a17b75de0e5263483f5f021417a 

  7. After successfully verifying your account, the Currency and Payment Methods sections will appear. Select the currency that matches your Shopify store's currency.

  8. Note: If you have multiple accounts (FMAs) for a specific payment method and selected currency, you can choose the correct one (that you plan to use for transaction processing), as shown in the image on the following page.

  9. Once you have finished configuring your Paysafe account, click Submit, and the system will redirect you back to the Shopify Payments settings page.

  10. Click Activate to initiate processing with Paysafe.
    Note: “Test mode” has to be disabled in order to process live card payments.

  11. To simulate test orders and payments, toggle Test Mode and activate the app.

  12. If you want to return later to adjust the extension settings and payment methods, select More actions→Manage, as shown in the image below.

Testing Instructions: Payment testing in test mode

To test various transaction outcomes, we have adopted a transaction amount-based approach. This may require your products to be priced accordingly in your store to effectively simulate different results.

Note: currency does not affect the outcome, only the amount.

Void authorization response/outcome mapping:

# Order/ Transaction Amount Simulated Outcome response
1 300 – 399.99 Void Authorization Rejected
2 All other amounts Void Authorization Accepted

Capture response/outcome mapping:

# Order/ Transaction Amount Simulated Outcome response
1 300 – 399.99 Capture Rejected
2 All other amounts Capture Rejected

Refund response/outcome mapping:

# Order/ Transaction Amount Simulated Outcome response
1 200 – 299.99 Refund Rejected
2 All other amounts Refund Accepted

Test Cards

Important: Please use only Test Cards for testing (no real cards should be used) in Test Mode.

To test a purchase with 3DS Secure (3DS2), you can utilize one of:

Card PAN Expiry Date CVV
Visa 4000000000001091 Any future date Any three digits
Mastercard 5200000000001096 Any future date Any three digits

Users will be prompted to enter a One-Time Passcode (OTP) (received via email or SMS) to authorize a 3DSecure transaction. In Test Mode, you can use the One-Time Passcode: 1234 to authorize a 3DS2 transaction.

Note: Remember to turn off Test Mode after completing your testing.

Congratulations! You have successfully activated the Paysafe Embedded Card Payments App.

Note: If you need to enable 3DSecure (3DS) for your checkout in Production, contact our support team as this service incurs an additional fee.

On this Page