On the Payment processors tab, you can set which payment processors will be available in your online store. Note that to choose a payment processor, you must have created your own account at this specific provider. On the Payment processors tab, you would need to supply your Merchant/Billing ID with the specific payment processor.

The Offline payment method allows you to provide specific instructions to your customers as to how they must pay to you. With this processor, your customers will see a page with instructions. You need to enter these instructions in the Info box. For example, you could provide instructions on how customers can send you money over a bank-wire, or another off-line payment method such as a check, postal, or money order.

General Information

The Online Stores section can be easily configured to accept payments on your behalf, and it can then process these orders automatically. It is important to note that when payments are processed with our system, they do not go through us - they are directly deposited in the account of your choice. We receive a notification of this transaction, but no fees or commissions.

Supported payment processors

Below, you can find a list of the payment processors that we currently support. To be able to accept payments online through the site widget, you need to have an active business/merchant account with at least one of the available payment processors.

  • PayPal

    If you don't have a PayPal account already, you can sign up for a Business account at PayPal's sign up page. When creating the account, you can skip over the Payment Setup screen, as the shopping cart and checkout process will be handled by our widget.

    Note: if you are using a Personal PayPal account, you will only be able to receive payments from clients with PayPal accounts. In order to accept credit card payments from clients without PayPal accounts, you will need either a Business or a Premier PayPal account.

    To add your PayPal account as a payment method, navigate to the Payment Processors tab and click the Add New button. In the pop-up window, select PayPal from the Processor drop-down menu. You should then enter:

    • The Display name of this payment method. The display name will be the name assigned to this payment method on your store, and it will be visible for your site's customers when they finish their order.
    • Your PayPal account's email address in the Email Address field.
    • The currency of your PayPal account. Generally, PayPal would accept payments in one currency only, and by setting it, the currency conversions would be done by our system, so that the proper amount and currency is sent to the PayPal server.
    • Your PayPal API Client ID and API Client Secret which you can obtain from the Dashboard of your Business PayPal account. More details on obtaining these API credentials are available on PayPal's website. Although, these settings are optional at the moment, and you should be able to receive payments without a configured PayPal API Client ID and API Client Secret, PayPal may make them obligatory at any point to make sure customers use the latest order processing method available. For this reason, we would recommend that you configure your PayPal API Client ID and API Client Secret to ensure the proper operation of the PayPal payment processor on your online store.
  • 2Checkout

    To use 2Checkout to accept payments, you need to sign up for an account at 2Checkout's sign up page.

    To add your 2Checkout account as a payment method of your store, navigate to the Payment Processors tab and click the Add New button. In the pop-up window, select 2Checkout from the Processor drop-down menu. You should then enter:

    • the Display name for the payment method. The display name will be the name assigned to this payment method on your store, and it will be visible for your site's customers when they finish their order.
    • your 2CheckOut Merchant code number in the Account Number field. The 2CheckOut Merchant code is listed in the interface of 2Checkout.com -> Intergrations -> Webhooks & API -> API section.
    • your secret word in the Secret Word field. The secret word is the Instant Notification Service (INS) secret word listed at 2Checkout.com -> Intergrations -> Webhooks & API -> Secret Word section.

    Instant Payment Notifications

    You can set up your 2Checkout account to submit a notification to our system of any successful payments and/or refunds. This is done by specifying the proper Endpoint URL at your 2Checkout account -> Intergrations -> Webhooks & API -> INS Settings -> Endpoint list. The Endpoint URL that you should add: https://api.suresupport.com/postback/2CheckOut

  • ePay.bg

    To use ePay.bg to accept payments (BGN only), you need to submit a registration at ePay's registration page. You need to sign up as a Legal Entity, and then to follow their procedure to become a merchant.

    Once your merchant account is set up, you can add ePay.bg as a payment method for your store, from the Payment Processors tab of your Store -> Add New -> Select ePay.bg from the Processor drop-down menu. Also, you need to enter:

    • The Display name for the payment method. The display name will be the name assigned to this payment method on your store, and it will be visible for your site's customers when they finish their order.
    • Your ePay.bg customer number.
    • Your secret key. You can find both your customer number and your secret key on the Personal Data screen at your ePay.bg account.
    • The desired invoice prefix.

    Also, you can set up the proper URL for payment notifications. This is done in your ePay.bg account, at the Personal data -> Trade data section. The URL for receiving notifications should look like https://your-website.com/hosting-widget/postback (replace with the correct URL of your widget).

    Note: The ePay.bg payment processor supports payments only in Bulgarian Leva (BGN). If your store is using another currency, then once the customer is directed to ePay.bg to submit their payment, the amount will be automatically turned into BGN, according to the current official exchange rate.

  • Authorize.Net

    If you have a merchant account with Authorize.Net, you could set up your site widget/order form to accept payment through it.

    You can add Authorize.Net as a payment method for your widget by choosing Authorize.Net when adding a new payment method through your store settings -> Payment processors tab.

    When adding Authorize.Net, you need to submit the following information also:

    • the Display name for the payment method. The display name will be the name assigned to this payment method on your store, and it will be visible for your site's customers when they finish their order.
    • API Login ID. It is provided by Authorize.Net, and you can find it in your Authorize.Net account -> Account -> Settings -> API Credentials & Keys.
    • Transaction Key and Signature Key. They are needed for the encryption of the response from the Authorize.Net server. You can create your keys at your Authorize.Net account -> Account -> Settings -> API Credentials & Keys.
    • the currency of your Authorize.Net account. This setting would assure that no errors regarding supported currencies would occur. Currency conversions would be done by our system, and the customer would be sent to the Authorize.Net server with the proper amount and currency set.

    Documentation on working with Authorize.Net can be found here. More information on the Signature Key feature is available here.

    Note about Sandbox/Test mode: When you are using Test mode in our settings to connect to the Authorize.Net Sandbox, you must make sure that the Sandbox is set to Live mode (your Authorize.Net account -> Account -> Settings -> Test mode). This setup would not lead to real transactions - as you would be using the Sandbox.
    You could also use the Test Mode at Authorize.Net. In this case, you should turn off Test mode in the settings on our side, so that you connect to your real Authorize.Net (and not the Sandbox). Given that the account at Authorize.Net is set to Test Mode, then no transactions would occur - just the connectivity to their servers would be tested.

  • Stripe

    Using Stripe as a payment method allows your customers to pay quickly and securely on your widget form, without being forwarded to the site of the payment processor, as it is with other supported processors. The customer enters their credit card details directly on your order form and see the result of the payment attempt on the same page. Still, no credit card data is recorded on our side - the software generates a token on the fly, which is then sent to the Stripe server over a secure channel.

    To add Stripe as a payment method for your widget, you need to choose it when adding a new payment method through your store settings -> Payment processors tab.

    You need to submit the following information:

    • the Display name for the payment method. The display name will be the name assigned to this payment method on your store, and it will be visible for your site's customers when they finish their order.
    • Email address - this would be the email address of your Stripe account (Stripe login)
    • Secret Key and Publishable Key - you can obtain them from your Stripe account -> Account Settings -> API Keys.

    Documentation on working with Stripe can be found here.

    Note about Test mode: Your Stripe.com account should contain two pairs of keys on the API keys page - Test keys and Live keys. Using the test keys and setting the Stripe account in Test mode will allow you to perform test payments. To be able to accept real payments, you should set the Stripe account in live mode on their side; also, set the Live keys in your widget settings, as well as set the payment method in Live mode on our side.

  • PayU.com (South America)

    If your reseller business is established in South America, in a country supported by PayU, then you can use the PayU payment services to accept payments from your customers.

    When you add PayU as a payment method for your store, you need to enter the following information:

    • the Display name for the payment method, visible on your hosting order form,
    • API Key, Account ID, and Merchant ID, which can be obtained from your PayU account.

    You can find documentation on working with PayU on their website.

    Note: The PayU payment service not work properly on your storefront for countries outside South America.

  • PayDollar

    When you add PayDollar as a payment method for your store, you need to enter the following information:

    • the Display name for the payment method, visible on your hosting order form,
    • Merchant ID - you can obtain it from your PayDollar account.

    You can find documentation on working with PayDollar on their website.

  • Braintree

    If you have a merchant account with Braintree, you could set up your site widget/order form to accept payment through it.

    You can add Braintree as a payment method for your widget by choosing Braintree when adding a new payment method through your store settings -> Payment Processors tab.

    When adding Braintree, you need to submit the following information:

    • Merchant ID, Private Key, and Public Key are all available on the home page of your Braintree account. You can also find them by clicking the gear icon in the top-right corner and going to API.
    • Account ID is the Merchant Account ID and it differs from the Merchant ID. You can find more information here.
    • Account Currency - Braintree will use your home currency by default. Please make sure to specify the currency set up in your Braintree account.

    Note that if your online store currency is different from the Braintree account currency, we will automatically convert the currency for you.

    Braintree won't send IPN responses by default. We have set up our system to listen for IPN responses, but you will need to enable them through your Braintree account. You can do that through the gear icon in the top-right corner -> API -> Webhooks. More information on the available webhooks is available here.

Test mode

The Test Mode allows you to test the API calls between your store and the payment processor, without conducting real payment transactions. If you turn the Test mode option on for any of the payment methods for your widget, you will be using the sandbox environment of the selected payment processor.

To connect successfully to a sandbox environment, besides setting the Test Mode to ON in the reseller panel, you also need to switch your site widget to test mode. This is done by adjusting the following line in the /app/config.php file of your site widget:

'test_mode' => false,

to:

'test_mode' => true,

When 'test_mode' is set to true in the /app/config.php file, then the widget will display all your payment processors which are currently in Test Mode. When 'test_mode' is set to 'false', then the widget will display only the processors that are set to be live, and will not display payment processors in Test Mode.

You can find out more about PayPal's Sandbox here, and about 2CheckOut's Sandbox here.

Additional processors/landing page

You can also add other means of payment by selecting Offline from the Processor drop-down menu. With this processor enabled, your customers will be redirected to a static page, which is meant to display instructions how they can pay to you. This method is meant to be used to handle cash payments, bank transfers, or even money order services such as Western Union. You can simply enter the additional instructions to your customers in the Info text field. Such instructions could be your bank account details, or how a money order could be submitted to you.