Payment Providers

StoreConnect® supports a number of payment methods and payment gateway providers. In order for your StoreConnect store to be able to accept payments using one or more of the gateways, you will need to create accounts with your chosen providers and get from them credentials for both testing and your live site. With these credentials, you then create a Payment Provider record for each payment gateway.

Supported Payment Options:

• Authorize.Net
• Bambora
• Braintree
• eWAY
• PayPal
• SecurePay
• Square
• Stripe
• Stripe ACH
• Windcave
• Zip
• Pay Later
  

Configuring Payment Providers

Each store must have at least one payment provider record to be able to accept payments, and these can be created from the store’s Payment Providers related list. When building your site and testing, you should be using the testing credentials and then switch over to the live credentials when your site goes live.

If you already have an account with one of our supported providers, use the test credentials they have supplied you. Otherwise go to Stripe’s website and create an account. When you first sign up for Stripe, you may get asked to activate payments. Activating payments will take you through the steps needed to give you a live payment gateway that receives real payments. You can skip this for now if you want and go straight to your dashboard where you will be able to access your test credentials.

Payment providers generally offer test card numbers to test with. A common card we use for testing is 4242 4242 4242 4242 Exp:a date in the future CVC any 3 digits

Recurring Payments

If you need to set up a Store that uses subscriptions with recurring payments there are currently three providers that are supported:

• Authorize.Net
• eWAY
• Stripe

To configure a payment provider:

• From the Store record, find the Payment Providers related list and click ‘New’
• Choose the Provider name from the picklist
• Set a display name for how you want this option to display at checkout
• Set a Description if you want to give a description of the payment option or display a message when user selects this payment provider on the website
• Set Payment Instructions if you want to give some payment instructions or show a message to the user on the order completion page if they have any payment remaining to be paid. (Mainly used for Pay Later and order’s that have part/deposit payments)
• Set a position to dictate what order it displays in when more than one Payment Provider is offered at checkout
• Enter the API credentials
  • The API Mode identifies if you are configuring for testing or for a live site
  • The API Key is the key or ID given to you by the provider
  • The API Secret is the secret or password given to you by the provider
  • The API Options are only required by some providers and if needed are in the instructions below
• Click ‘Save’

Refer to the instructions below for more specific directions on the provider you are configuring.

Payment Surcharges

If you need to charge customers a surcharge when using your payment provider, like a credit card fee, you can do this using the Surcharge Product lookup. You can charge a flat amount like $0.30 per transaction or a percentage of the payment amount, like 1.5%, or both. The surcharge will show up on the order as an Order Product, adding to the order’s total amount.

• Create a product and give it a display name that the customer will see, like ‘Payment Processing Fee’
• Make sure your product is active
• Set it as a Virtual Product

• Create a Price Book Entry for each price book and currency you need it for
• Set a list price, this can be $0 or something like $0.30, etc.
• Set a percentage if you want to also charge a percentage of the transaction, like 1.5%
• Add it to every pricebook that you want the surcharge to work for, including Account or Membership specific pricebooks.

• On your Payment Provider record, set the Surcharge Product you just created
• Add a description to let your customers know about the surcharge

And this will then show up during checkout when they select that payment provider.

And also show up on the order summary page.

Authorize.Net

You will need to sign up with Authorize.Net if you don’t already have an account.

To generate the Client Key, log in to the Merchant Interface as an Administrator and navigate to Account > Settings > Security Settings > General Security Settings > Manage Public Client Key.

If the Public Client Key does not yet exist, answer your security question to generate the key. Once your account is set up, go into your store in Salesforce and create a new Payment Provider related object. Enter the values as follows:

Your API Mode should be sandbox and then later be changed to production when you are going live.

To specify the Public Key, add the following to the API Options field of the Payment Provider record:

public_key: "YOUR_PUBLIC_KEY"

It is important to put this in quotes as above, so for example, if your Public Key is 86ujz98tK9B767EY7FeWdo293dk4UZZSt65jbmrx5L9fQgm7DqLKFeWdo293dk then you would enter the following exactly into the API Options field:

public_key: "86ujz98tK9B767EY7FeWdo293dk4UZZSt65jbmrx5L9fQgm7DqLKFeWdo293dk"

Bambora

To generate your credentials, follow these instructions from Bambora: Create Account

Currently, we are only supporting the Bambora North America Gateway.

Braintree

To generate your credentials, follow these instructions from Braintree: API keys

To specify the Merchant ID, add the following to the API Options field of the Payment Provider record:

merchant_id: "YOUR_MERCHANT_ID"

It is important to put this in quotes as above, so for example, if your Merchant ID is aqrdb3f78k8dpkbd then you would enter the following exactly into the API Options field:

merchant_id: "aqrdb3f78k8dpkbd"

eWAY

To generate your credentials, follow these instructions from eWAY:

• Sandbox: Creating an eWAY Sandbox API key
• Production: How do I set up my Live eWAY API Key and Password?

To specify the Public Key, add the following to the API Options field of the Payment Provider record:

public_key: "YOUR_ENCRYPTION_KEY"

It is important to put this in quotes as above, so for example, if your Encryption Key is 86ujz98tK9B767EY7FeWdo293dk4UZZSt65jbmrx5L9fQgm7DqLKFeWdo293dk then you would enter the following exactly into the API Options field:

public_key: "86ujz98tK9B767EY7FeWdo293dk4UZZSt65jbmrx5L9fQgm7DqLKFeWdo293dk"

This key can be obtained from your eWAY account under My Account > Client Side Encryption > Encryption Key.

PayPal

StoreConnect uses PayPal’s Smart Payment Buttons.

To generate your credentials, follow these instructions from PayPal: Set Up Your Development Environment.

SecurePay

To generate your credentials, follow these instructions from SecurePay:

• Sandbox: To get started with SecurePay
• Production: Login to your account to test your integration and complete the application form

To specify the Merchant Code, add the following to the API Options field of the Payment Provider record:

merchant_code: "YOUR_MERCHANT_CODE"

It is important to put this in quotes as above, so for example, if your Merchant Code is 86ujz9 then you would enter the following exactly into the API Options field:

merchant_code: "86ujz9"

Stripe

To generate your credentials, follow these instructions from Stripe: Manage your API keys to authenticate requests with Stripe

Stripe ACH

Enable ACH direct debit as a payment method in your stripe dashboard.

To generate your credentials, follow these instructions from Stripe: Manage your API keys to authenticate requests with Stripe

By default the Bank Statement will show the Store name. To specify a different name, add the following to the API Options field of the Payment Provider record:

statement_name: "ACME Inc"

Limitations:

• Only USD currency is supported
• Only microdeposits verification is supported
• It takes 1-4 business days before the money is credited to your Stripe account. The Stripe payment ID (ie. pi_xyz1234) is stored on the Payment record to help with manual reconciliation once the money is credited.

To learn more about ACH direct debit, visit the Stripe ACH docs.

Square

To generate your credentials, follow these instructions from Square: Square API Access Tokens

To specify the location ID, add the following to the API Options field of the Payment Provider record:

location_id: "YOUR_LOCATION_ID"

It is important to put this in quotes as above, so for example, if your location ID is L233H82QGSEQV then you would enter the following exactly into the API Options field:

location_id: "L233H82QGSEQV"

Windcave

To generate your credentials, follow these instructions from Windcave: REST Guide

Zip

To generate your credentials, follow these instructions from Zip:

• Sandbox: Zip Sandbox Merchant Dashboard
• Production: Zip Live Merchant Dashboard

Pay Later

You can add as many Pay Later payment methods to a store as you need.

* Pay Later does not use an API Secret or API Mode, but since these two are required fields you need to give them a value. For simplicity you could use the payment name or just mark them with an x.