Partners Support Log In
Martin Cogburn


    Back to Top

    Integrating with Stripe

    About Stripe

    Applies to: ONTRAPORT Plus and above.

    Stripe is an international payment gateway supporting businesses in many countries. Stripe charges a transaction fee and percentage of each sale without monthly subscription fees. The ONTRAPORT integration includes the ability to sell subscriptions, payment plans, have upsell forms and charge transactions in currencies other than the US dollar.

    The standard Stripe Gateway in ONTRAPORT does not store customer information in Stripe, and does not take advantage of advanced features such as Stripe's Smarter Saved Cards (auto-update when the bank replaces or updates an existing credit card). See our Integrating with Stripe Token article to enable those features. If you are moving existing Stripe customers to ONTRAPORT see our Stripe Migration article.

    How to Integrate Stripe with ONTRAPORT

    Sign up and configure Stripe to take payments first, getting approval from Stripe, then follow these steps to integrate your active Stripe gateway with ONTRAPORT.

    Configure Stripe

    1. Log into your Stripe account and navigate to Radar > Rules.
    2. Make sure the following two settings are set to Disabled:
      Block if CVC verification fails
      Block if ZIP code verification fails

      disable CVC verification in Stripe
    3. If the two verification settings are enabled they will show "0 blocked" like the Stripe setting above them in this image. You must set these two settings to Disabled. Click the three dot menu to select Disable.

      menu to disable settings
    4. Navigate to Developer > API Key and click "Reveal live key token". Copy the revealed Secret Key to the clipboard.

    Add Stripe to ONTRAPORT

    1. Log into ONTRAPORT and go to Sales > Settings > Gateways

    2. Click the New Gateway button

    3. Select Stripe from the Gateway Select menu

    4. Paste the Live Secret Key into the secret_key field

      Stripe Secret Key
    5. Click Save

    Currency Options

    Stripe can process transactions in non-US currencies. ONTRAPORT sends the currency type to Stripe, so you must make sure your currency setting in Stripe matches the currency setting in ONTRAPORT. Make sure you understand how your bank will process the currency; if your bank account defaults to a different currency you may incur transaction and conversion fees.

    1. Visit Administration > Localization to select your currency setting in ONTRAPORT.

      administration data localization
    2. Select the currency from the drop down.

      Choose currency
    3. Choose how you want the currency symbol to appear. Typical choices include the currency symbol and currency abbreviation, or just the currency symbol, before or after the value.

      choose currency format
    4. Select the number format in the last drop down box. Choices are to use the comma as the decimal separator, typical in Europe, or to use the period as the decimal separator.

      currency number format
    5. Verify that the gateway and currency setting work correctly. Process a live transaction on a valid credit card and verify the charge is reflected correctly in your payment gateway and bank.
    6. Note that the new currency symbol is used on all items and sales reports in ONTRAPORT, including historical sales made prior to the change. It is up to you to segregate sales prior to the change and reflect them properly in your books.

    Available Currencies with Stripe

    • Australian Dollar (AUD)
    • Brazilian Real (RL)
    • Canadian Dollar (CAD)
    • Czech Koruna (CZD)
    • Danish Krone (DKK)
    • Euro (EUR)
    • Hong Kong Dollar (HKD)
    • Hungarian Forint (HUF)
    • Israeli New Sheqel (ILS)
    • Japanese Yen (JPY)
    • Mexican Peso (MXN)
    • Norwegian Krone (NOK)
    • New Zealand Dollar (NZD)
    • Philippine Peso (PHP)
    • Polish Zloty (PLN)
    • Pound Sterling (GBP)
    • Romanian New Leu (RON)
    • Singapore Dollar (SGD)
    • Swedish Krona (SEK)
    • Swiss Franc (CHF)
    • Taiwan New Dollar (TWD)
    • Thai Baht (THB)
    • U.S. Dollar (USD)

    Important Facts

    • Stripe does not include any Address Verification Service (AVS). If that is needed for your local jurisdiction another gateway must be used.
    • Stripe supports over 135 currencies.
    • ONTRAPORT can be set to use a single currency only. Multi-currency support is not available in ONTRAPORT.
    • The ONTRAPORT currency setting is a global setting and must match the setting in your payment gateway to avoid extra fees or refused transactions.
    • Sales reports within ONTRAPORT will aggregate the totals without performing any currency conversions after you change your account currency.

    Other Gateways Supporting Non-US Currency


    Q. I've been using Stripe for a while now, but when I log into their control panel it has a notice that I should update to using their new API. Should I do this?

    A. Yes, you can safely upgrade to using the new API if you are getting this notice.

    Q. Can I use a currency other than US Dollars in Stripe?

    A. Yes. Stripe supports many different currencies. If you connect multiple banks to your Stripe account it can accept payment in different currencies. Each ONTRAPORT account processes in one currency only. If you want to bill in both US Dollars (USD) and Pounds Sterling (GBP), you must use two separate ONTRAPORT accounts.

    Note: Stripe will accept transactions in any of their supported currencies and pass that currency through to the bank you set up for that currency. If you do not have a bank set up for that currency, Stripe will pass the transaction to your primary bank. Your bank may assess currency exchange fees to convert the funds into your bank's currency; these fees can amount to 10% of the sale or more.

    We recommend you set the ONTRAPORT currency setting to match your Stripe setting in Administration > Localization. This will also set the currency symbol for your reports, order forms, etc.

    Q. I changed my currency to Pounds Sterling (GBP) but all the sales values are the same in my account. They should be converted!

    A. ONTRAPORT does not do any currency conversion of existing sales values. You will need to download your transactions prior to the change and convert the values manually for your books.

    Q. I switched my currency in ONTRAPORT and now all my orders are failing!

    A. The currency setting in ONTRAPORT must match the currency setting in the payment gateway. While some gateways refuse transactions with mismatched currency types, others will process the payment and you will incur extra currency exchange and processing fees.

    Q. I have $3,846 in currency exchange fees after switching my currency in ONTRAPORT! Are you going to reimburse me?

    A. No. The currency setting in ONTRAPORT must match the currency setting in the payment gateway. While some gateways refuse transactions with mismatched currency types, others will process the payment and you will incur extra currency exchange and processing fees from the gateway or the bank. ONTRAPORT will not reimburse you for these charges.

    Other Resources

    ONTRAPORT's Community Q&A Forum is our peer-to-peer support site for quick answers to your questions 24 hours a day! ONTRAPORT Support, our Certified Consultants, and your fellow entrepreneurs provide the answers.

    Articles in this section

    Created - Updated
    Have more questions? Submit a request