Introduction

This document provides information about all available API methods. Below are the integration guides that will help you to implement Lovat billing and payments solution in your website/application quickly and easily.

Request and response

All API requests must be made over HTTPS. Calls made over plain HTTP will fail.

You must authenticate for all requests.

The SEND method implements the reception of data on the transaction, taking into account the processing and calculation of VAT and system charges.


Referrer URL

Referrer URL

  • https://merchant.vatcompliance.co/api/1/send/{access_token}?if_digital={true/false}&if_vat_calculate={true/false}

Call Options

Call parameters are divided into two types:

  • Path parameters (token)
  • Query parameters (transaction data)

The token is generated in the internal account of the merchant at the first stage of adding the web-site.

The request parameters are generated by the merchant and sent to the server using the POST method in the application / x-www-form-urlencoded or application / json format.

Below you can find the example of processing payment information with LOVAT.

curl -v POST https://merchant.vatcompliance.co/api/1/send/5aae918d97964ff88df64b059c2cc0f8?if_digital=true&if_vat_calculate=true

--header "Content-Type: application/json" \

-d '{

"transaction_id": "ttt4565-85546",

"transaction_datetime": "2017-01-09T08:27:22 +00:00",

"transaction_sum": "25.99",

"customer_ip": "127.0.0.1",

"customer_phone_number": "+7 677 665 77 77",

"currency": "usd",

"delivery_address" : "USA",

"transaction_status" : "Success",

"service_code": "21",

"customer_bank_card_number": "1234-1234-1234-1234",

"payment_method_country": "Russia",

"billing_address": "USA, California Somebody str 41",

}'

Parameters:

  • String / “usd”, “eur”, “rub”, “gbp”
    Transaction Currency
  • String / 25
    Transaction Amount
  • String / 127.0.0.1
    Customer's IP address
  • String / “+7 AAA BBB BB BB”
    Customer's phone number
  • String / "111 First Street,Saratoga, CA 95070, US"
    Billing address (address of the payment owner)
  • DateTime / 2017-01-09T08:27:22 +00:00
    Date and time of the transaction in accordance with ISO 8601 GMT
  • String / “payonline” paypal”
    Currency fee of payment system. Used three-letter currency code according to the standard ISO 4217.

The full list of parameters is available in API guide.

Get a token