3.5. Fiscalization service

3.5.1. Fiscalization service flow

Fiscalization service is used for registration of financial cheques and invoices in PaynetEasy payment gateway and their further processing. This service is realized for Sale transactions. Thus, registration of financial cheque/invoice in PaynetEasy payment gateway is performed via Sale Transactions API. Afterwards, transaction with cheque/invoice is processed by PaynetEasy payment gateway by the flow that can be configured due to customer`s preferences.

All information concerning Sale transaction integration may be found in Sale Transactions API documentation. To perform Sale transaction request with the use of fiscalization service, you need to add to Sale transaction request only one additional API parameter.

Fiscalization service parameter for Sale request

In order to initiate a Sale transaction with the use of fiscalization service, Merchant sends an HTTPS POST request for sale transaction with additional parameter.

Sale Request Parameters Type Comment Necessity
cheque Json string Financial cheque or invoice Mandatory for fiscalization sale request

Json string structure for cheque parameter

Below you may see simple json string example for cheque parameter:

{
  "cheque_type" : 1,
  "tax_system" : 1,
  "positions" : [
    {
      "quantity" : 2,
      "price" : 322.94,
      "tax" : 4,
      "description" : "Product/Service 1"
    },
    {
      "quantity" : 1,
      "price" : 500,
      "tax" : 4,
      "description" : "Product/Service 2"
    }
  ]
}

Json string parameters:

Parameter Type Comment Possible values
cheque_type Decimal Calculation type/sign 0 - income, 1 - expense, 2 - return of income, 3 - return of expense
tax_system Decimal Tax system 0 - General taxation system, 1 - Simplified income taxation system, 2 - Simplified income minus expense taxation system, 3 - Unified tax on imputed income, 4 - Unified agricultural tax, 5 - Patent system of taxation
positions Array Array of products/services Array of products/services
quantity Decimal Quantity of product/service  
price Decimal Price per product/service considering discounts and mark-ups  
tax Decimal value-added tax 1 - 20% value-added tax, 2 - 10% value-added tax, 3 - 0% value-added tax, 4 - without value-added tax, 5 - 20/120 value-added tax, 6 - 10/110 value-added tax
description String(128) Description of product/service  

Please take into consideration that the total price of all products/services which are provided in positions array should be equal to amount parameter value of sale request.

Sale Request with fiscalization example

client_orderid=902B4FF5
&order_desc=Test Order Description
&first_name=John
&last_name=Smith
&ssn=1267
&birthday=19820115
&address1=100 Main st
&city=Seattle
&state=WA
&zip_code=98102
&country=US
&phone=%2B12063582043
&cell_phone=%2B19023384543
&amount=700.00
&email=john.smith@gmail.com
&currency=USD
&ipaddress=65.153.12.232
&site_url=www.google.com
&credit_card_number=4538977399606732
&card_printed_name=CARD HOLDER
&expire_month=12
&expire_year=2099
&cvv2=123
&purpose=www.twitch.tv/dreadztv
&redirect_url=http://doc.payneteasy.com/doc/dummy.htm
&server_callback_url=http://doc.payneteasy.com/doc/dummy.htm
&merchant_data=VIP customer
&cheque={ "cheque_type" : 1, "tax_system" : 1, "positions" : [ { "quantity" : 2, "price" : 100.00, "tax" : 4, "description" : "Product/Service 1" }, { "quantity" : 1, "price" : 500, "tax" : 4, "description" : "Product/Service 2" } ] }
&control=768eb8162fc361a3e14150ec46e9a6dd8fbfa483

Sale Response with fiscalization example

type=async-response
&serial-number=00000000-0000-0000-0000-000001c70080
&merchant-order-id=baltestorder
&paynet-order-id=2711285
&end-point-id=4165