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
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
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
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.
Last updated
