Additional data

Additional parameter reservation_data can be sent with create purchase request.

Example:

{
  "request": {
    "response_url": "https://site.com/responsepage/",
    "order_id": "test_reservation_data_12345",
    "order_desc": "Test payment",
    "currency": "GEL",
    "amount": "100",
    "signature": "dcf5a9a582872bf0ba89bb77a25c3894671b423a",
    "merchant_id": "1549901",
    "reservation_data": "ewogICJwaG9uZW1vYmlsZSI6ICIrMTIzNDU2NzgiLAogICJjdXN0b21lcl9hZGRyZXNzIjogIjE1IGdhbm5ldCBzdHJlZXQgZWxzcGFyayIsCiAgImN1c3RvbWVyX2NvdW50cnkiOiAiVVMiLAogICJjdXN0b21lcl9zdGF0ZSI6ICJOWSIsCiAgImN1c3RvbWVyX25hbWUiOiAiQnJhbmRvbiBOeWF0aGkiLAogICJjdXN0b21lcl9jaXR5IjogIk5ldyBZb3JrIiwKICAiY3VzdG9tZXJfemlwIjogIjE0MDEiLAogICJhY2NvdW50IjogImlkMzI2NDg0ODAiCn0="
  }
}

reservation_data – it is JSON data, encoded with BASE64 algorithm. It has the following structure:

JSON:

{
  "phonemobile": "+12345678",
  "customer_address": "15 gannet street elspark",
  "customer_country": "US",
  "customer_state": "NY",
  "customer_name": "Brandon Nyathi",
  "customer_city": "New York",
  "customer_zip": "1401",
  "account": "id32648480",
  "uuid": "00002415-0000-1000-8000-00805F9B34FB"
}

All parameters must be alphanumeric, and contain latin characters, digits and separator symbols

Parameter name                        Mandatory Type Description Example
phonemobile no AN(16) Cllient mobile phone +12345678
customer_address no AN(1024) Client address 15 gannet street elspark
customer_country no AN(2) Client billing country ISO code UK
customer_name no AN(1024) Payer name Brandon Nyathi
customer_city no AN(1024) Payer city New York
customer_zip no AN(250) ZIP code 1401
account no AN(250) Client account id in merchant system id32648480
uuid no AN(250) Device UUID 00002415-0000-1000-8000-00805F9B34FB
settlement_id no AN(32) ID to be passed to settlements reports for reconciliation process automation SettlementID::12311233443
3ds_mandatory no boolean Parameter to force payment without 3DS. Can be used only after approval from Flitt risk team. true or false
fields_custom[] no JSON object JSON list of additional fields to be displayed on checkout
products[] no JSON object JSON list of products to be fiscalised

fields_custom is a JSON object which allows to add custom input fields to checkout page

"fields_custom": [
    {
      "name": "id-1",
      "label": "label1",
      "value": "1",
      "valid": {
        "pattern": "^[0-9]+$",
        "max_length": 222,
        "min_length": 10
      },
      "readonly": false,
      "required": true,
      "type": "input",
      "p": 1
    },
    {
      "name": "id-2",
      "label": "label2",
      "value": "",
      "p": 2
    },
    {
      "name": "id-3",
      "label": "label3",
      "type": "checkbox",
      "required": true,
      "p": 3
    }
  ]

products is a JSON object which contains data to be fiscalised

    "products": [
        {
            "id": 1,
            "name": "Product A",
            "price": 100.00,
            "quantity": 2,
            "vat_percent": 20,
            "code": "00702001001000001",
            "units": 1,
            "discount": 10.00,
            "package_code": "5678",
            "total_amount": 190.00
        },
        {
            "id": 1,
            "name": "Product B",
            "price": 100.00,
            "quantity": 2,
            "vat_percent": 20,
            "code": "00702001001000001",
            "units": 1,
            "discount": 10.00,
            "package_code": "5679",
            "total_amount": 190.00
        }
    ]
Description of products JSON object:

Parameter name                        Mandatory Type Description Example
id no number ID of product 1
discount no number Discount based on quantity of goods or services in tiyins 100.20
name no string Product name Scooters rental
price no number Price per unit of goods or services in tiyins 122.56
quantity no number Quantity of goods or services 2
code no number Product and service identification code 00702001001000001
units no number Unit code 241092
vat_percent no number Percentage of VAT paid for this product 20
package_code no number Product packaging code 123456
total_amount no number Total amount of all products and services 245.12