Parameters

For the correct formation of the bill in «Invoicebox» system, there is a mandatory set of parameters. The contact details of the customer are mandatory parameters, but can be transferred to the discretion of the merchant. In order not to force the customer to specify the phone number and e-mail address twice, we recommend that you transfer them to the «Invoicebox» system together with the order information (in itransfer_person_email and itransfer_person_phone parameters).

Parameter	Description	Value
itransfer_language_ident	Initial bill language	Language code in ISO 639-3standarts. ENG - english etc.	Optional
itransfer_participant_id	Merchant ID	Int	Mandatory
itransfer_participant_ident	Merchant regional code	Int	Mandatory
itransfer_participant_sign	Form security sign¹	String	Mandatory
itransfer_order_id	Order identifier assigned to an order in merchant's system	String	Optional
itransfer_order_amount	Order total amount	Decimal	Mandatory
itransfer_order_amount_vat	Order total VAT amount	Decimal	Optional
itransfer_order_currency_ident	Currency code	Currency code in ISO 4217 standart. EUR – euro, USD – U.S. dollar etc.	Mandatory
itransfer_order_description	Order description	String	Mandatory
itransfer_body_type	Customer type	PRIVATE – private person LEGAL – company	Optional
itransfer_timelimit	Payment time limit. After the specified time, the unpaid bill will be cancelled.	Time in ATOM format	Optional
itransfer_person_name	Customer's full name	String	Optional
itransfer_person_email	Customer's email address	Correct e-email address	Optional
itransfer_person_phone	Customer's mobile phone number	Phone number in E.164 format with “+” prefix	Optional
itransfer_person_country	Customer's country residence	2 characters, ISO 3166-1-Alpha	Optional
itransfer_person_address	Customer's address	String[2..50]	Optional
itransfer_person_zip	Customer's zip code	String[2..15]	Optional
itransfer_person_city	Customer's city name	String[2..25]	Optional
itransfer_person_state	Customer's state name	String[2..20]	Optional
itransfer_url_returnsuccess	The URL of the page to which the customer will be redirected upon completion of the payment	URL	Optional
itransfer_url_return	The URL of the page to which the customer will be redirected upon cancellation of the payment	URL	Optional
itransfer_testmode	Sandbox mode. Payments in the sandbox mode do not actually pass through the financial system. You can activate the possibility of using sandbox mode in administrative account	Int - 1 or 0	Optional

Information about the customer's basket / item list

Parameter	Description	Value
itransfer_itemN_name	Name of goods or services	String	Mandatory
itransfer_itemN_quantity	Quantity of goods or services	Decimal	Mandatory
itransfer_itemN_measure	Measure of goods or services	String: pc., kilos, liters etc.	Mandatory
itransfer_itemN_price	Price for 1 item of goods or services	Decimal	Mandatory
itransfer_itemN_vat	VAT amount per 1 item	Decimal	Mandatory

Where, N — number, starts from 1

Example of sending information about the composition of the basket

¹The security sign is formed on the basis of concatenation of the values of the following parameters: itransfer_participant_id, itransfer_order_id, itransfer_order_amount, itransfer_order_currency_ident, API security key. Eg. itransfer_participant_sign = md5( itransfer_participant_id + itransfer_order_id + itransfer_order_amount + itransfer_order_currency_ident + API security key )

Read next: Demonstration form →