Merchant API

Introduction

Our Merchant System will provide you with a way to sell your products without the need for a messy code implementation. With our ystem, the only thing you need to do, is to create your invoice. After the invoice has been paid, you will be notified by email. Payments are forwarded after 1 network confirmation (usually 5-30 minutes) to prevent any unwanted scenarios. Bitcoin USD rate is valid for 15 minutes, after that the price is regenerated because of Bitcoins price volatility. A small fee of 0.5% is taken automatically before system forwards the payment, we use those fees to keep the services up and running.

The minimum supported transaction size is $1 in BTC. Forwarding transactions will include a network fee paid from the amount you received.


Plugin Installation

1. Download the plugins from the links above.
2. If you haven’t done so already, head over and sign up and create a merchant account.
3. Install the plugin based on the readme file found in the archive.

Installation Videos


Generating Invoices

Please use the following link to register for Merchant Vendor ID.

Once you registered, go to "Create Vendor" page, and create your VendorID. Fill in all the required fields and double check, once done, you won't be able to change them without contacting us. After all that is done, you will have several options to create invoices. Manual, from the dashboard, and depending on your website CMS, through our plugins. At the moment we provide plugins only for WORDPRESS (WOOCOMMERCE) and WHMCS. We are currently working on adding more plugins. If you have the necessary skills, you can use the information below to craft your own plugin for your website.
If you wish us to help you incorporate the Merchant API in your system, contact us through email, telegram or livechat.

If you want to create your own plugin, you can send a POST request to our API servers, with the following information;

url:  https://litepay.ch/p/
method: POST
data required:
vendor     = vendor id (received by email)
invoice       = invoice number you generated (from your shop)
secret  = secret word needed to confirm that you are said vendor (received by email)
price    = price of the invoice in USD (bigger than 1)
callbackUrl = a callback url where you can receive callbacks from our system. (urlencoded)
returnUrl = a returnUrl for us to send the client to after the payment. (urlencoded)
A correct input of data will return a JSON response with the status of the POST REQUEST. If the status of the request is "success", you will get a second variable named url, which contains the url of the invoice. Your code must redirect the user to the url received.
A request that is incomplete will result in the status being error and the next variable being message, which will contain the error message.

An example successful invoice:

status : success
url : https://litepay.ch/i/15997391278ebab7febc1ad56b098d92

An example of a error returned by the API

status: error
message: You did not send the "vendor/invoice/secret/price/callbackUrl/returnUrl", try again.
The API is still under development.

For automated shops, using our plugins listed above, the POST will be done automatically and the client will be redirected to our payment system. If the invoice is already in our system, the buyer will be redirected to the existing invoice.

Once the invoice has been paid, our system will send you an email confirming that. We can offer support for websites that require a callback to update their database on the spot.

This is how the email might look like;

Subject:

LitePay.ch Merchant | Invoice Example-818 has been paid!

Body:

Hello, Coffee Shop
Invoice number #Example-818 has been paid.

Payment information:
Used BTC address : 3LNUEC3cCMqXCr5yhLDxjv1BhYrnhzGmXP
Amount:  0.004546 BTC / ~32 USD
TxID: a781b7bccbee0c1ea5b2f4c3ddca4c7396b4508f3067e0a4bf644a19e68db8ce
TxTime: 2017-11-01 22:35:45
Status: Payment has 0 confirmations

During the next 30 minutes (after transaction is verified) this payment will be automatically forwarded to your own external wallet address. 

Best Regards,
LitePay.ch Team
Thank you for using www.LitePay.ch
Support is available at: [email protected]
Address Expiration

BTC Address will expire once the invoice has been paid. Unpaid/Paid invoices expire after 30 days since their creation.