How to create your payment gateway on ShopBase

Kindly make sure your gateway is fully tested and works before integrating it. The ShopBase Approval team will tests all gateways before publishing them to ShopBase merchants.

Payment gateway developers are permitted to integrate a payment gateway with ShopBase.

The payment gateway integrated may be made available to merchants privately. Or, if approved by ShopBase, it may be listed in the public list of ShopBase’s payment gateways, and be made available to customers of all shops in its supported countries.

How to integrate your hosted payment gateway with ShopBase

A. Become a ShopBase Partner

B. Create your payment gateway and submit a request-for-review form

C. Get your ShopBase payment key

D. Make your payment gateway available to you privately, or to your selected merchants, or all ShopBase customers

A. Become a ShopBase Partner

• To sign up for a ShopBase Partner account, click here.

• To get more information about ShopBase Partner Program, click here.

B. Create your payment gateway

Take the following steps to create your payment gateway with ShopBase:

1. Log in to the Partner Dashboard.

2. Click Gateways.

3. Click Create new gateway.

4. Enter your gateway name and click Create.

5. Fill out the registration form, including different fields as follows:

Gateway information

Field	Explanation
Gateway name	This will appear in the payment settings and on the checkout page as a payment option.
Gateway website	This URL will be provided to the merchant within the payment settings and will also be used to review your service.
Gateway category	This will define how your gateway receives methods and display under the payment settings.
Checkout flow	This will specify how your gateway processes transactions: using embedded iframe on ShopBase checkout page or redirecting to payment gateway page.
Gateway logo	This will appear on the checkout page.
Help document URL	This URL will be provided to the merchant within the payment settings and will also be used to review your service.
Description	This will give your users a brief description of your service.

Gateway redirect/embedded settings

Field	Explanation
Redirect URL	The customer will be redirected to this address at checkout. This URL must properly handle the request values that will be sent
Embedded Iframe URL	This will be embedded to checkout step
Field label	The naming convention used to describe the login credentials for your gateway. Maximum 70 characters. Only alphabet and numeric characters are allowed.
Field name	The parameters used to connect the login credentials from ShopBase to your gateway. Maximum 120 characters. Alphabet, numeric and special characters are allowed.
Credentials validation	This URL will be used to validate your Field name and Field label to make sure they work fine.

Gateway order management

Field	Explanation
Capture payments URL	When a payment capture is triggered, ShopBase will send the Request Values to your Capture URL.
Refund payments URL	When a merchant clicks on the Refund item button from the ShopBase dashboard, the Request Values will be sent to your Refund URL.
Void payments URL	When a merchant clicks on the Cancel order button from the ShopBase dashboard, the Request Values will be sent to your Void URL.
Payment information URL	This URL will be used to retrieve information about a transaction. Payment Provider needs to return the corresponding information with x_transaction_type (authorization, capture, refund or void) requested by ShopBase.
Gateway credential webhook	This will be used to receive notification from ShopBase. ShopBase will trigger notification any time a merchant updates his/her gateway credentials on ShopBase dashboard.
Update Authorization URL	This will be used when a post-purchase authorization is triggered

Currency

Field	Explanation
Currency supported	Supported currencies for your merchant accounts.

Note:

• Payment gateway name: The gateway name filled in the registration form will be displayed on merchants’ dashboard and customers’ checkout page. The gateway name can’t be changed after being submitted to ShopBase for review.

• Payment gateway logo: Upload the logo that meets the following criteria:

  • It is a high-resolution raster image (e.g. PNG or SVG).

  • It comes with a transparent background.

  • It contains small yet easy-to-read texts.

6. After filling out the registration form successfully, you can perform one of the following actions:

• Make your payment gateway available for you privately

• Make your payment gateway available for your selected merchants

• Request a public listing for your payment gateway

C. Get ShopBase payment key

List of ShopBase Payments keys

ShopBase payment key will be generated after your payment gateway is successfully created.

To find your gateway key, click one gateway and choose the tab ShopBase payment key.

To get more detailed instructions, visit here.

D. Make your payment gateway available to you privately, or to your selected merchants, or all ShopBase customers

1. Make your payment gateway available to you privately

• Once your payment gateway has been successfully created, it will be listed in the Gateway list and can be used by your customers only.

• To make any change to your gateway, click its name.

2. Make your payment gateway available to selected merchants

• Click the icon to share the install link with the ShopBase merchants that you are connected to on your own network

Disclaimer:

• ShopBase takes no responsibility for any issues that may arise when customers check out their orders using the payment gateway that isn’t publicly listed on the ShopBase’s payment gateways list.

3. Request for a public listing for your payment gateway

• You must submit a request to ShopBase if you want us to list your payment gateway publicly to all shops in your supported countries.

• To do so, click the Submit for review button.

• Your request will be processed by ShopBase within 3-5 days from its receipt.

  • If approved by ShopBase, your payment gateway will be made available to all shops on ShopBase in your supported countries.

  • If rejected by ShopBase, your payment gateway will require further modification to meet the criteria set out by ShopBase.

• After processing, ShopBase will send you the result via email.