The cheque is passed within the authorization request. An additional parameter ChequeItems must be passed in the request. The ChequeItems parameter should contain a structure in JSON-format looking like a following example.
An example of a cheque structure in the ChequeItems parameter:
{"items":[
{ "id": 1,
"product": "123460176",
"name": "First item",
"price": 201.45,
"quantity": 42.345,
"amount": 8530.40,
"tax": "vat10"},
"hscode": "8528722001",
"fpmode": 1},
{ "id": 2,
"product": "123460189",
"name": "Second item",
"price": 15301.01,
"quantity": 0.128,
"amount": 1958.53,
"tax": "vat20"},
"fpmode": 1}
]} |
The following cheque item parameters are transfered in the structure:
Name | Mandatory | Type | Description |
id | Yes | int | # of the cheque's position |
product | Yes/ No* | string(50) | Product's code |
name | Yes/ No* | string(250) | Product's name |
price | Yes | float(10.2) | The cost of a product unit |
quantity | Yes | float | The product's quantity in the units of the product measurements |
amount | Yes | float(18.2) | The cost of a specified quantity of product |
tax | Yes** | string(10) | |
hscode | No | string(13) | Code of Harmonized Commodity Description and Coding System (13 digits) |
fpmode | No** | int |
*One of the parameters must be defined – product’s code or product’s name, or both parameters must be transferred (by building a fiscal check they are combined into one string).
**The parameters tax end fpmode are not passed in the cancel or refund request.
Values of the parameters price and amount for all the cheque items should be in the same currency and (OrderCurrency parameter of the authorization request).
The total amount of the cheque items (by amount parameter) must be equal the order amount (OrderAmount parameter of the authorization request).
If the conditions above are not met then cheque is recognized as wrong-formed and the authorization request error appear.
Internet-shop can issue a financial confirmation within 4 days in Personal account, or using Web service.
To confirm the payment, send a request to IPS Assist server via HTTP POST or SOAP method (in UTF-8 coding).
The request URL for the financial confirmation transmission and list of payment confirmation parameters are the same as the values specified here. To send a confirmation cheque via HTTP POST method, only an additional parameter ChequeItems is added, which contains a structure in JSON-format looking like a following example.
An example of a cheque structure in the ChequeItems parameter:
{"items":[
{ "id": 1,
"product": "123460176",
"name": "First item",
"price": 201.45,
"quantity": 21.12,
"amount": 8530.40,
"tax": "vat10"},
"fpmode": 1}
{ "id": 2,
"product": "123460189",
"name": "Second item",
"price": 15301.01,
"quantity": 0.064,
"amount": 979.26,
"tax": "vat20"},
"fpmode": 1}
]} |