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
¤cy=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=user_account1
&redirect_url=http://doc.payneteasy.eu/doc/dummy.htm
&server_callback_url=https://httpstat.us/200
&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