Instruction for technical integration with the lovat system


TERMS AND ABBREVIATIONS

API - application Programming Interface. A set of calls provided by the system calls for integration with external software products.


MERCHANT - the owner of an online store.


CUSTOMER - an individual who pays for goods or services.


TRANSACTION - transfer of funds for goods or services received by the сustomer from the merchant.


TOKEN - a secret string used by the system to identify the merchant and the web-site through which the transaction is registered



API DESCRIPTION

Send method
Description of the method
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

  • https://merchant.lovat.be/api/1/send/{TOKEN}

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.

  • Type / Example
    Example Description
    Validation
  • String/ 555-yyy
    Transaction ID
    Maximum 255 characters. Not an empty value
  • DateTime / 2017-01- 09T08:27:22 +00:00
    Date and time of the transaction in accordance with ISO 8601 GMT
    Not an empty value
  • String / 25
    Transaction Amount
    Maximum 45 characters. Not an empty value
  • String / “usd”, “euro”, “rub”, “gbp”
    Transaction Currency
    Maximum 4 characters. Not an empty value
  • String / “payonline” paypal”
    Payment Operator
    Maximum 45 characters. Not an empty value
  • String / “Success”, “Charge back”
    Transaction Status
    Not an empty value
  • String / 127.0.0.1
    Customer's IP address
    Maximum 45 characters. Not an empty value
  • String / “+7 AAA BBB BB BB”
    Customer's phone number
    Maximum 100 characters. Not an empty value
  • String / "111 First Street,Saratoga, CA 95070, US"
    Billing address (address of the payment owner)
    Maximum 255 characters. Not an empty value
  • String / "111 First Street,Saratoga, CA 95070, US"
    Delivery address
    Maximum 255 characters. Not an empty value
  • String / "111 First Street,Saratoga, CA 95070, US"
    The address of the Customer's bank (merchant requests this information from the payment system)
    Maximum 255 characters. Not an empty value
  • String / “1”
    Merchant service type code

    If the merchant does not send data on the type of service provided, the transaction is assigned the nominal principal type of merchant's service that was specified at registration
    Maximum 255 characters. Not an empty value
  • String / “1234-1234-1234- 1234”
    Bank card number of the buyer
    Maximum 19 characters. Not an empty value
  • String / “Z291143207289”
    Customer's e-wallet number
    Maximum 255 characters. Not an empty value

SERVER RESPONSE CODE

The response to the query uses the basic HTTP code:

Example query

Sample request from the console


curl -v POST https://merchant.lovat.be/api/1/send/5aae918d97964ff88df64b059c2cc0f8 \

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

-d '{

"transactionID ": "500000001",

"transactionSum ": "25.99",

"IPAddressCustomer ": "127.0.0.1",

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

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

"currency": "usd",

"paymentOperator":"paypal",

"billingAddress": "111 First Street, Saratoga, CA 95070, US",

"deliveryAddress" : "111 First Street, Saratoga, CA 95070, US",

"bankAdress" : "111 First Street, Saratoga, CA 95070, US",

"transactionStatus" : "Success",

"serviceCode": "1",

"bankCardNumberCustomer": "1234-1234-1234-1234",

}'