HELP

Account Setup (9)

How do I get a merchant account?
Register an account at https://smartex.io/dashboard/signup. You will receive a verification e-mail. Once you submit your business information, along with your Ether address and/or bank account details, your account will be instantly activated.
What are my processing volume limits ?

There are currently no processing volume limits.

How can I enable people to pay with Ether or other digital tokens ?

Our open-source plugins are available for most popular ecommerce platforms, also you can easily create a "Pay with Ethereum" button for your website. Alternatively, you can use our powerful API with the available code libraries.

Can I update the email address on file with my Smartex account ?

Send a message to [email protected] from the email address associated with your Smartex account stating the desired change. Our customer support will get in touch with you to complete the procedure.

I forgot my password, what can I do?

Go to the Merchant Login page and click the “Forgot Password” button. Type the email address associated with your account and click send. You will receive a reset link, simply follow the steps to reset your password.

How do I terminate my Merchant Account?

Please send a message to [email protected] from the email address associated with your merchant account stating your interest. Our customer support will contact you to complete the procedure.

I lost my phone with 2FA codes. How do I get into my account?

Send a message to [email protected] from the email address associated with your merchant account stating your situation. Our customer support will contact you to complete the procedure.

What countries and markets can Smartex serve?

Smartex serves the following countries :

  • Afghanistan
  • Åland Islands
  • Albania
  • Algeria
  • American Samoa
  • Andorra
  • Angola
  • Anguilla
  • Antigua And Barbuda
  • Argentina
  • Armenia
  • Aruba
  • Australia
  • Austria
  • Azerbaijan
  • Bahamas
  • Bahrain
  • Barbados
  • Belarus
  • Belgium
  • Belize
  • Benin
  • Bermuda
  • Bhutan
  • Bonaire, Sint Eustatius and Saba
  • Bosnia and Herzegovina
  • Botswana
  • Bouvet Island
  • Brazil
  • British Indian Ocean Territory
  • Brunei Darussalam
  • Bulgaria
  • Burkina Faso
  • Burundi
  • Cambodia
  • Cameroon
  • Canada
  • Cape Verde
  • Cayman Islands
  • Central African Republic
  • Chad
  • Chile
  • China
  • Christmas Island
  • Cocos (Keeling) Islands
  • Colombia
  • Comoros
  • Congo
  • Congo, the Democratic Republic of the
  • Cook Islands
  • Costa Rica
  • Côte d'Ivoire
  • Croatia
  • Curaçao
  • Cyprus
  • Czech Republic
  • Denmark
  • Djibouti
  • Dominica
  • Dominican Republic
  • Egypt
  • El Salvador
  • Equatorial Guinea
  • Eritrea
  • Estonia
  • Ethiopia
  • Falkland Islands (Malvinas)
  • Faroe Islands
  • Fiji
  • Finland
  • France
  • French Guiana
  • French Polynesia
  • French Southern Territories
  • Gabon
  • Gambia
  • Georgia
  • Germany
  • Ghana
  • Gibraltar
  • Greece
  • Greenland
  • Grenada
  • Guadeloupe
  • Guam
  • Guatemala
  • Guernsey
  • Guinea
  • Guinea-Bissau
  • Guyana
  • Haiti
  • Heard Island and McDonald Islands
  • Holy See (Vatican City State)
  • Honduras
  • Hong Kong
  • Hungary
  • Iceland
  • India
  • Indonesia
  • Iraq
  • Ireland
  • Isle of Man
  • Israel
  • Italy
  • Jamaica
  • Japan
  • Jersey
  • Jordan
  • Kazakhstan
  • Kenya
  • Kiribati
  • Korea, Republic of
  • Kosovo
  • Kuwait
  • Lao People's Democratic Republic
  • Latvia
  • Lebanon
  • Lesotho
  • Liberia
  • Libyan Arab Jamahiriya
  • Liechtenstein
  • Lithuania
  • Luxembourg
  • Macao
  • Macedonia, The Former Yugoslav Republic Of
  • Madagascar
  • Malawi
  • Malaysia
  • Maldives
  • Mali
  • Malta
  • Marshall Islands
  • Martinique
  • Mauritania
  • Mauritius
  • Mayotte
  • Mexico
  • Micronesia, Federated States of
  • Moldova, Republic of
  • Monaco
  • Mongolia
  • Montenegro
  • Montserrat
  • Morocco
  • Mozambique
  • Myanmar
  • Namibia
  • Nauru
  • Nepal
  • Netherlands
  • New Caledonia
  • New Zealand
  • Nicaragua
  • Niger
  • Nigeria
  • Niue
  • Norfolk Island
  • Northern Mariana Islands
  • Norway
  • Oman
  • Pakistan
  • Palau
  • Palestinian Territory, Occupied
  • Panama
  • Papua New Guinea
  • Paraguay
  • Peru
  • Philippines
  • Pitcairn
  • Poland
  • Portugal
  • Puerto Rico
  • Qatar
  • Réunion
  • Romania
  • Russian Federation
  • Rwanda
  • Saint Barthélemy
  • Saint Helena
  • Saint Kitts and Nevis
  • Saint Lucia
  • Saint Martin (French Part)
  • Saint Pierre and Miquelon
  • Saint Vincent and the Grenadines
  • Samoa
  • San Marino
  • Sao Tome and Principe
  • Saudi Arabia
  • Senegal
  • Serbia
  • Seychelles
  • Sierra Leone
  • Singapore
  • Sint Maarten (Dutch Part)
  • Slovakia
  • Slovenia
  • Solomon Islands
  • Somalia
  • South Africa
  • South Georgia and the South Sandwich Islands
  • South Sudan
  • Spain
  • Sri Lanka
  • Suriname
  • Svalbard and Jan Mayen
  • Swaziland
  • Sweden
  • Switzerland
  • Taiwan, Province of China
  • Tajikistan
  • Tanzania, United Republic of
  • Thailand
  • Timor-Leste
  • Togo
  • Tokelau
  • Tonga
  • Trinidad and Tobago
  • Tunisia
  • Turkey
  • Turkmenistan
  • Turks and Caicos Islands
  • Tuvalu
  • Uganda
  • Ukraine
  • United Arab Emirates
  • United Kingdom
  • United States
  • United States Minor Outlying Islands
  • Uruguay
  • Uzbekistan
  • Vanuatu
  • Venezuela
  • Vietnam
  • Virgin Islands, British
  • Virgin Islands, U.S.
  • Wallis and Futuna
  • Western Sahara
  • Yemen
  • Zambia
  • Zimbabwe
Are certain industries subject to approval ?

Smartex is located in the United Kingdom and must abide by its laws and regulations. If the type of activity your company is engaged in is prohibited by British laws, Smartex will be unable to process payments for your business, even if the item you are selling is legal in your country. For detailed information see our Terms of use.

Plugins & Development (6)

How do I setup and configure the Smartex VirtueMart plugin?

Setup

Download the latest version of this plugin from https://github.com/smartexio/smartex-joomla-plugin/releases

Compress the content of upload directory in zip format and follow the steps below:

Configuration

  • Got to "Extension Manager: Install"
  • Browse to the previously created zip file location and click "Upload & Install".
  • Go to "Manage", and find the plugin, click on "Publish".
  • Go to "Components -> VirtueMart" and click on "Payment Methods".
  • Click "New" and type in the information, selecting VMPAYMENT_SMARTEX as Payment Method.
  • Create an API Key in your Smartex Merchant account at https://smartex.io.
  • Click "Configuration" in the Tab menu, and insert your API Key from the previous step.
How do I setup and configure the Smartex WooCommerce plugin?

System Requirements

  • Wordpress >= 3.9
  • WooCommerce >= 2.2
  • GMP or BCMath
  • mcrypt
  • PHP compiled with OpenSSL support
  • PHP >= 5.4

Installation

Download the latest version of this plugin from https://github.com/smartexio/smartex-woocommerce-plugin/releases Go to Wordpress's Administration Panels > Plugins > Add New > Upload Plugin, choose the downloaded file and click Install Now. At the end of the installation click on Activate.

Configuration

Log in into the Administration panel of your wordpress installation, browse to configuration settings under WooCommerce > Settings > Checkout > Smartex

Create a pairing code using your Smartex merchant account. Once you have created a Pairing Code, copy & paste the code into the "Pairing Code" field and click the "Find" button:

Once successful, you will receive a token:

Pairing code is valid for a short period of time, if it expires you will need to create a new code and repeat the pairing process.

You can also configure how Smartex's IPNs (Instant Payment Notifications) communicates statuses for orders in your WooCommerce store.

Usage

During Checkout, your customers will be given the option to pay with Ether. and - by choosing this method - will be redirected to a full screen Smartex invoice to pay for the order. These orders will appear as regular in the order management area.

How do I setup and configure the Smartex Prestashop plugin?

System Requirements

  • PrestaShop 1.4+
  • PHP 5+
  • Curl PHP Extension
  • JSON PHP Extension

Configuration

Download the latest version of this plugin from https://github.com/smartexio/smartex-prestashop-plugin/releases

Prestashop v1.5 or older :

  • Upload files to your PrestaShop installation
  • Go to your PrestaShop administration. Modules -> Payments & Gateways -> "Smartex" click [Install]
  • Go to your PrestaShop administration. Modules -> Payments & Gateways -> "Smartex" click [Configure]
  • Enter the API key created on smartex.io

Prestashop v1.6 or newer :

  • Upload files to your PrestaShop installation.
  • Go to your PrestaShop administration. Modules -> "Smartex" click [Install]
  • Go to your PrestaShop administration. Modules -> "Smartex" click [Install]
  • Enter the API key created on smartex.io
How do I setup and configure the Smartex WHMCS plugin?

Installation

Extract these files into your whmcs directory (parent directory of modules/folder)

Configuration

Download the latest version of this plugin from https://github.com/smartexio/smartex-whmcs-plugin/releases

  • Check that you have set your Domain and WHMCS System URL under whmcs/admin > Setup > General Settings
  • Create an API Key in your Smartex account at smartex.io.
  • In the admin control panel, go to "Setup" > "Payment Gateways", select "Smartex" in the list of modules and click Activate.
  • Enter your API Key from step 1.
  • If you see the "Convert To For Processing" option, choose a currency that is accepted by Smartex (e.g. USD/EUR/ETH).
  • If you see the option but such a currency does not appear here, or if don't see the option and you are currently accepting a currency that is not accepted by Smartex:
  • - a. Click "Save Changes."
  • - b. Create an accepted currency (e.g. USD/EUR/ETH ) by going to "Setup" > "Currencies," filling out the form and clicking "Add Currency"
  • - c. Return to "Setup" > "Payment Gateways" and choose this new currency for the "Convert To For Processing" setting.
  • Click "Save Changes."
How to configure subscriptions

Subscriptions are recurring billing agreements with specific buyers. Smartex sends billing emails to active subscribers according to the specified schedule.

In order to bill a buyer for a recurring subscription, a bill with a recurring schedule must be created. This bill will be sent via email to the buyer according to the established schedule. You can choose from: Once (not recurring), Weekly, Monthly, and Yearly. You can set a custom schedule using our API.

Clicking the link received via email the buyer will generate a Smartex invoice and make a payment. If the invoice expires before the buyer sends the payment, the bill can be used to generate a new invoice, unless the due date has passed.

You can send a bill from the merchant dashboard by going to Payment Tools > Client Billing. Set up your subscription by selecting an option from the Schedule drop-down menu and setting a Delivery Date for when the billing should begin.

To edit a bill, click on it in the "My Client Bills" list. To cancel a bill, click the Cancel button to the right of the bill in the “My Client Bills” list.

Can I test my payment notification URL manually?

Problem

Instant Payment Notification (IPN) messages at the location specified in the notificationURL parameter not being received

Solution

Instant Payment Notifications (IPNs) are sent from Smartex upon every invoice status change if you have set the fullNotifications parameter to true. IPNs are POSTed to your notification URL specified when you created the invoice. If the gateway receives an

HTTP/1.1 200 OK
response from your server, the message should have been correctly delivered.

If the gateway receives an HTTP error code, it will attempt to resend the IPN at increasing time intervals. If you experience this, check the parameters sent with the invoice creation request for the notification URL, also check that your fullNotifications parameter is set to true.

The content header for the POST request should be

Content-Type: application/json
and the body of the HTTP POST request should be a JSON-formatted string as follows :

 {
        "id":"1234567890",
        "url":"https://smartex.io/invoice?id=xxxxxxxxxx",
        "posData":"{\"id\":\"1234567890\"}",
        "status":"complete",
        "ethPrice":"0.00",
        "price":0.0000,
        "currency":"USD",
        "invoiceTime":1111111111111,
        "expirationTime":1111111111111,
        "currentTime":1111111111111,
        "ethPaid":"0.0000",
        "rate":1,
        "exceptionStatus":false,
        "buyerFields":
            {
                "buyerName":"Some Customer",
                "buyerAddress1":"123 Main St.",
                "buyerAddress2":"Apt 123",
                "buyerCity":"London",
                "buyerState":"London",
                "buyerZip":"SA1 234",
                "buyerEmail":"[email protected]"
            }
    } 

On Linux and Mac OS, open a terminal/shell and use this command to manually send a test IPN using the curl utility:

  
                            
curl --no-keepalive --raw --show-error --verbose --connect-timeout 10 --insecure --max-redirs 1 -H "Content-Type: application/json" -d '{your JSON IPN test data}' https://your.ipn.handler
                            

The response from the curl command should look something similar to this:

                            
* Hostname was NOT found in DNS cache
*   Trying [the IP address of your server]...
* Connected to [the IP address of your server] port 443 (#0)
> POST /path/to/your/ipnhandler HTTP/1.1
> User-Agent: curl/7.37.1
> Host: [the IP address of your server]
> Accept: */*
> Content-Type: application/json
> Content-Length: [length of your JSON string]
> 
* upload completely sent off: [x] out of [y] bytes
< HTTP/1.1 200 OK
< Date: Wed, 19 Nov 2014 17:36:50 GMT
* Server [your server software] is not blacklisted
< Server: [your server software]
< Content-Length: 0
< Connection: close
< Content-Type: text/html; charset=UTF-8
< 
* Closing connection 0
                             
                            

A successful response will have the 200 response code. If you receive any other HTTP codes, there is a problem with your webserver or your IPN handling application.

Payment Tools (2)

How do I create a "Pay with Ether" button ?

Go to "Payment tools" and then choose "Payment Buttons".

Complete the necessary fields and click the "Create" button.

Select the size of the button, copy the HTML code provided, then copy and paste it onto your webpage.

How do I send a bill to a customer ?

Go to the "Payment Tools" section and select "Client Billing".

Click the "Create New Bill" button to create a bill and send it to your customer via email.

When your customer opens the bill and clicks the "Pay Bill Now" button, an invoice will be generated, and he/she will have 15 minutes to complete the payment. If your customer was not able to pay upon generating the invoice, they can click "Pay Bill Now" when they are ready to pay. A new invoice will be generated with an updated conversion rate.

Purchases (7)

I accidentally sent Ether to a Smartex address, how do i get a refund?

Send a message to [email protected] detailing your transaction as follows:

  • Transaction ID
  • Date/Time/Amount
  • Sending Ether Address
  • Receiving Ether Address

Upon locating your transaction we will contact you to complete the refund process.

My invoice is overpaid, what do I do?

Possible overpayment reasons

Wallets and services often quote different exchange rates causing the Ether amounts denominated in fiat in your wallet or account service to differ from the actual amount needed to pay the Smartex invoice.

Always double check the amount you are sending when paying a Smartex invoice.

Resolving An Overpaid Invoice Issue

Just send a message to merchant's support email address and ask a refund for the overpaid amount providing the refund address.

Merchant may choose to refund the original Ether amount paid or to refund the local currency price listed on the invoice quoted in Ether. Once a refund request is received Smartex needs 1-2 business days to process it. Please note that Smartex cannot return the overpaid amount unless authorized by the merchant.

How do I pay a Smartex invoice?

Just send the Ether amount displayed on the invoice under the 'Pay with Ether' button to the displayed ether address using your favourite wallet application.

Where’s my Ether (or other digital tokens) ?

If you sent a payment to the payment address and haven't received your service, it's possible that the invoice expired and the transaction hasn't been applied, or that the amount sent did not fully pay the invoice.

Please submit a support ticket to [email protected] with some basic transaction information to allow us to locate your payment. If you do not have the Smartex Invoice URL, you can provide any of the following details and we will attempt to locate the transaction :

  • Transaction ID
  • Receiving Ether Address
  • Sending Ether Address & Date/Time/Amount
How do I view an invoice in another language ?

There is a drop down menu on the bottom on the page, clicking it will reveal the list of all available languages.

My invoice is underpaid, what should I do?

Possible underpayment reasons

Wallets and services often quote different exchange rates causing the Ether amounts denominated in fiat in your wallet or account service to differ from the actual amount needed to pay the Smartex invoice.

Always double check the amount you are sending when paying a Smartex invoice.

Resolving An Underpaid Invoice Issue

Please contact the merchant to resolve an underpaid invoice issue.

Can Smartex refund my order?

Smartex can refund only an overpaid invoice and only for the overpayment portion, unless the merchant authorizes a full refund. If the invoice is fully paid, we require the merchant to authorize the procedure.

Settlements & Refunds (10)

How do you handle settlements ?

Every day Smartex collects and deposits all payments processed from the previous business day directly to your bank account or Ether wallet, according to your settlement preferences.

Settlement Currencies

Smartex supports settlement in 4 currencies.

  • ETH - Ether
  • EUR - Euros
  • GBP - Pounds Sterling
  • USD - US Dollars

If you choose to take settlement in ether, Smartex will forward Ether payments to your ether account on file. The minimum settlement is 0.01 ETH. You can choose to take any percentage or all of your settlement in Ether.

My currency is not listed, how do i receive settlements ?

If your currency is not on the list of available currencies, you will receive 100% of your settlement in Ether.

How can i receive my payout in Ether?

Go to your Settlement preferences, set the "Payout Percentage" to the percentage of your payout you would like to receive in Ether, enter a valid address in the” My Ether Address” field, and select “Save Changes”.

Confirm your settlement preference changes by following the instructions received by email.

How do I update my settlement settings ?

Go to "My Account" and then "Settlement", located in your "Account Settings" section.

Confirm your settlement preference changes by following the instructions received by email.

When do i get paid ?

Payouts occur automatically once every business day. Your account balance will be settled when it exceeds the minimum settlement limit required for your preferred currency.

How do I accept an overpaid invoice ?

If an invoice is overpaid, the amount due is automatically credited to the merchant once the transaction has 15 confirmations. The merchant can also accept manually overpaid amount as follows :

  • Log in to your Smartex merchant account and select the Payments view on the left panel.
  • Select the desired invoice in the 'Payments' view.
  • Click 'Resolve' at the top of the page.
  • Select ‘Accept Overpayment’ and click Next.
  • Click the Accept Overpayment button.
  • You will be redirected to the Payments list and the status of the invoice will now be Paid instead of Overpaid. The overpaid amount will be credited to your merchant ledger immediately.
How do I accept an underpaid invoice ?
  • Log in to your Smartex merchant account and select the Payments view on the left panel.
  • Select the desired invoice in the Payments view.
  • Click 'Resolve' at the top of the page.
  • Select 'Accept Underpayment' and click Next.
  • Click the Accept Underpayment button.
  • You will be redirected to the Payments view list of invoices and the status of the invoice will now be Paid. The invoice will also be credited to your merchant ledger immediately.
How do I refund a fully paid invoice ?
  • Log in to your smartex merchant account and select the Payments view on the left panel.
  • Select the desired invoice in the Payments view.
  • Click Refund at the top right corner.
  • Select ‘Full Refund’ to refund the full amount, or 'Partial Refund' to specify a specific amount to partially refund. The refund currency is the same currency that the invoice was priced in. The refund will be issued for the ether equivalent of this amount at the current exchange rate.
  • Select 'Specify a different address' to manually enter a specific ether address to which to issue a refund.
  • Click the 'View Confirmation' button.
  • Confirm the amount to refund by typing it again. Click Refund Payment to proceed.
  • You will be redirected to the Payment Details view, which will now display that a refund is pending until it is processed. Refunds are typically processed within 1-2 business days.
  • After the refund has been processed, the status of the invoice will change from Paid to Refunded in the Payments view list.
How do I refund an underpaid invoice?
  • Log in to your smartex merchant account and select the Payments view on the left panel.
  • Select the desired invoice in the Payments view.
  • Click Resolve at the top of the page to proceed.
  • Select 'Refund Underpayment' and then click Next.
  • Select either 'Use provided address (recommended), which is available if the purchaser’s ethereum account client has included a refund address, or select ‘Specify a different address’ to manually enter a specific ethereum account to which to issue a refund.
  • If the purchaser’s wallet provided a refund address to use, you will have the option to use the provided address. Otherwise, you can specify a refund ethereum account. Click the View Confirmation button to continue..
  • Confirm the amount to refund (this must match the underpaid amount listed above the field) and click Refund Payment.
  • You will be redirected to the Payment Details view for the invoice. The status of the invoice will be changed to ‘Refunded’ once the refund has been processed. Refunds are typically processed within 24 hours, but we ask that you allow up to 1-2 business days.
How do I refund the overpaid portion of a overpaid invoice?

Note: For overpaid invoices, the amount due on the invoice is automatically credited to the merchant once the transaction reaches 15 confirmations. However, the merchant can refund the overpaid amount.

  • Log in to your smartex merchant account and select the 'Payments' view on the left panel.
  • Select the desired invoice in the Payments view.
  • Click Resolve at the top right corner.
  • If the purchaser’s wallet provided a refund address to use, you will have the option to use the provided address. Otherwise, you can specify a refund ethereum account. Click the View Confirmation button to continue.
  • Confirm the amount to refund (this must match the overpaid amount listed above the field) and click Refund Payment.
  • You will be redirected to the Payment Details view for the invoice, which states ‘A refund is pending approval from smartex’ at the top of the screen. The status of the invoice will be changed to ‘Paid’ once the refund has been processed. Refunds are typically processed within 24 hours, but we ask that you allow up to 1-2 business days.