Introduction

The Skipify Merchant Portal is where you'll begin your Skipify integration journey. We'll start with a quick overview, and then jump into configuring a few items to make sure we submit payments on your behalf exactly how you want us to.

Environments

Skipify provides a Staging environment and a Production environment during integration. These environments will use separate credentials, Merchant Portals (for integration configurations), and SDK endpoints. When you start your integration, the staging environment should be used for testing your integration before requesting production credentials. All payments processed through Skipify's Staging environment are strictly test transactions, so you can only use test credentials(real credit card credentials will be declined).

You can access the Skipify Merchant Portals at the following links:

• Staging Merchant Portal: https://admin-staging.skipify.com
• Production Merchant Portal: https://admin.skipify.com

Staging and Production environments utilize separate endpoints. The Base URL for each can be viewed in the Skipify Environments Page.

Initial Account Log In

❗️

This section requires you to have a Skipify merchant account

Need an account? Reach out to your favorite Skipify integration manager or submit a request here!

1. Contact your favorite Skipify representative and request a new account

2. Check your inbox for an email from [email protected] with the subject line Welcome to the Skipify family!

3. Click the email link to activate your account and set your password

4. After activating, continue to the Skipify Merchant Portal

5. Click Configuration to customize your Skipify configuration

🚧

Skipify Environments

Remember that Skipify provides a Staging Merchant Portal for testing and a Production Merchant Portal for when you are ready to go live with Connected Checkout. You will need to follow these configuration instructions each time you get setup in a new environment.

Skipify Merchant Portal Configuration

Merchant Credentials
Keep your Merchant ID and API Keys handy and make sure to note whether they're for Staging or Production! These will be used throughout your integration, including setting up the SDK and request authorization.

👍

Best Practice! - MID and API Key Storage

We recommend that you store your Merchant IDs and API keys for Staging and Production in environment variables

Merchant Types and Hierarchy

Skipify recognizes two types of merchants, stand-alone and parent. Underneath parent merchants there are child merchants. If you are unsure of which configuration you need, please ask your favorite implementation manager.

The stand-alone merchant type is for merchants who have only one set of configurations and payment gateway credentials.

The parent merchant type is for Independent Software Vendors (ISVs) and merchants that manage multiple E-commerce businesses. Parent merchants can contain any number of child merchants. As a parent merchant, when you sign in to the Skipify merchant portal, you will have elevated privileges to manage any merchant that belongs to your parent merchant account. Any configurations set on the parent merchant will be inherited by all child merchants unless a configuration has been explicitly set on the child.

Merchant APIs

APIs are available to create new child merchants and manage merchant configurations. Check out the API Documentation for more details.

Required Configurations

The following items are required and must be completed before you can accept payments through Skipify:

Payments and Processing

Choose how you would like to capture payment after checkout and fill out your payment gateway credentials.

Note that if you select manual capture, you are responsible for capturing funds.

🚧

Important!

If you select manual capture, you will be responsible for capturing all funds

You can use one of two processes:

1. Call the Skipify Order Capture API when you are ready to capture. Check out our API Documentation for more details.
2. Capture payments using your own payment gateway (please contact your specific payment gateway company for more information on this process).

Merchant Domains

Enter in a set of domains that can access the Skipify API. Please reach out to your favorite implementation manager to confirm that all the appropriate URLs are whitelisted.

Optional Configurations

The following options and enhancements can set depending on your needs. Some of these configurations are not enabled by default in the Merchant Portal. Your friendly Skipify implementation manager can help you decide which ones are right for your Skipify implementation.

PayLink Branding

When implementing PayLink, update the relevant user interface settings to customize the logo and color of the end user checkout experience. The button text and Skipify logo theme should be set to match your co-branding logo and selected colors.

👍

Remember Accessibility!

Your selected colors should meet modern accessibility standards for readability. Check here for more information.

Fulfillment (Shipping and Tax)

Skipify allows you to designate whether or not Skipify will display and charge your customer for shipping and tax. This is based on the address the customer provides or adds during the payment flow.

You can independently toggle shipping and tax, but you must specify a URL. The URL is the address where Skipify will call your application with the address in order to receive the proper shipping options and tax calculations.

👍

Your Skipify implementation manager is here to help!

To make sure that shipping and tax are properly implemented and the appropriate URLs are whitelisted, be sure to check in with your implementation manager when configuring these features

Webhooks

Webhooks can be used as alerts to keep your systems and partner applications in sync with actions in Skipify. Skipify can send outbound webhooks to any publicly accessible server. When an event in Skipify triggers a webhook (e.g. when a payment has been successfully authorized), Skipify will attempt to send this notification to the endpoint(s) you specify and await a response from your server(s). See our webhooks developer resources for more information.

Tipping

When you turn on tipping, Skipify will display the "add a tip" option to your customers during checkout. You can also configure the tipping percentages shown to your customers.

Purchase Details

You can provide additional information about an order to your customer within the Skipify wallet. The purchase details provided will appear in the header of the Skipify wallet so that you can pass helpful, customized information to your customers during checkout.

Merchant Upload

You are able to provision multiple child merchants at a time. After the file successfully loads, you can view the status of the files and download the reports. Contact your favorite implementation manager for quick overview of this process.

---