Syntax

The syntax used for sending a payment order is very simple:

"amount"  "currency"  "buyer’s phone number"

Example:

120,50 EUR +33612345678

Here is a list of available parameters.
Parameter Syntax Required Description
Amount 100.32 or 100.32 Yes Amount to be paid, including tax.

Both point and comma are accepted as the decimal marker.

Currency
Yes Payment currency.

Lowercase and uppercase letters or a combination of both are accepted (e.g.: UsD).

Phone
+336XXXXXXXX
No Buyer’s cell phone number preceded by the country code.

“Classic” mode:

If the parameter is transmitted, the payment order is transmitted to the buyer via WhatsApp and the merchant receives a copy of the message.

If the phone number does not match the one specified for WhatsApp, the merchant receives a message with the payment link that he or she can transmit to the buyer via another channel.

“Echo” mode:

If the parameter is not transmitted, the merchant will receive a message with the payment link that he or she can transmit to the buyer via the channel of his or her choice (SMS, Messenger, Instagram, etc.).

Order ID
ORDER=myOrder-133
No Order ID.
E-mail
john.doe@example.com
No The buyer’s e-mail address that will receive the payment receipt.
Mode
TEST
No Allows to create a test payment order.

If the parameter is not transmitted, the payment orders are created in PRODUCTION mode.

Note:

As long as the shop in in TEST mode, the default mode is TEST, even if the field is not transmitted.

Shop ID
SHOP=12345678
No When a company has several shops, allows to override the shop associated with the payment.
Validity period of the order.
DELAY=10
No Allows to override the validity period of the payment order (expressed in days) defined in the Expert Back Office.

The maximum value is 99 days.

VAT amount
VAT=0 | IVA=19.6 | TVA=5,5%
No Allows to override the default VAT rate.

The amount of taxes transmitted to the acquirer is calculated based on the amount to be paid (including taxes) and the VAT rate.

Both point and comma are accepted.

The “%” symbol is optional

Data collection form
FORM
No Allows to call a personalized data collection form before the payment. Thanks to this form, the merchant can collect buyer’s data (first name, last name, address, etc.).
Language of the message, in “echo” mode.
en | es | fr | de | pt
No Allows to define the language used for sending the message to the merchant, in “echo” mode.
Help
HELP | help | ? | ¿
No Allows to receive the message of the chatbot via WhatsApp.