ERROR CODES DESCRIPTION:
Alert email - Transaction definitely lost
On PRODUCTION mode, in case of an incorrect value of the SIGNATURE field, during the payment the customer gets the following error message on his browser:


error date


Then the payment is impossible and the transaction is definitely lost.
In this case you receive the following email alert in which you will find the form that the gateway could not process with the signature value.


Hello Mr. XXXX,

A payment form posted from your website has been detected as invalid by the payment gateway. Your client has not been able to finalize his order and has been informed of the technical error on November 3, 2011 at 14:45:42 UTC.

The transaction is definitely lost and is not visible in your back office because it is incomplete.

The error is linked with the following parameter:

00 - SIGNATURE

To understand the origin of this problem refer to the FAQ: https://payzen.io/en-EN/error-code/error-00.html

For your information, here is the invalid payment form received by our gateway:
[vads_capture_delay=]
[vads_ctx_mode=TEST]
[vads_payment_type=]
[vads_trans_id=124709]
[vads_currency=978]
[vads_language=en]
[vads_cust_name=John Smith ]
[vads_cust_address=Tech Park ]
[vads_amount=100,00]
[vads_trans_date=20111103084538]
[vads_version=V2]
[signature=69314499495c59a5ac4b30a7ae4ed9af250ef1d5]
[vads_payment_cards=]
[vads_validation_mode=]
[vads_site_id=98765432]
[vads_cust_zip=31000]
[vads_url_error=http://your-shop.com/vads-test/order.error.a]
[vads_cust_city=Toulouse]
[vads_page_action=PAYMENT]
[vads_url_success=http://your-shop.com/vads-test/order.success]
[vads_order_id=48-486204013]
[vads_action_mode=INTERACTIVE]
[vads_url_cancel=http://your-shop.com/vads-test/order.cancel.a]

We recommend you to contact your webmaster in order to analyze the causes of this malfunction. Once the problem identified, please make the necessary changes.



CAUSES OF THE SIGNATURE CALCULATION ERROR
 
1 - The different fields of the form have not been UTF8 encoded.
When calculating the signature, the fields must be UTF8 encoded. The same applies to your shop which must send all the parameters in UTF8 encoding to the payment gateway.
If the fields are not sent to the gateway in UTF8 encoding, then you will observe special characters in the form especially with the accents.

Example:
[capture_delay=]
[validation_mode=]
[site_id=51872022]
[payment_config=SINGLE]
[version=V1]
[currency=978]
[amount=1000]
[cust_name=Ren�e Martin]
[ctx_mode=PRODUCTION]
[trans_date=20111026083000]
[trans_id=982415]
[payment_cards=]
[signature=84a3feebed6595bfdc773ad01858fc394458477c]

In this example you can see that the accents are not well encoded for the cust_name field.
 
2 - The MODE (test or production) or the CERTIFICATE used is incorrect.
You can use the gateway in TEST or PRODUCTION mode.
Each mode matches with a certificate. Make sure that you use the proper certificate depending on the mode you want to use.
Consult your back office, in the "Settings/Shops/Certificates" section in order to check your certificate.
 
3 - Warning: Line break or carriage return posted in the form.
If you insert some carriage returns or line breaks within one of the posted values, they will not be taken in account.

Example:
If in the address field you post:

3 bellflower street
2nd floor apt 28

The value taken in account by the payment gateway will only be:

3 bellflower street

Then the payment gateway will only take the 3 bellflower street value in account to calculate the signature whereas your signature calculation will be based on the complete address: 3 bellflower street 2nd floor apt 28.

So you will get a signature error.

TO CONCLUDE: Before the signature calculation and the form sending you have to escape the carriage returns and the line breaks.
 
4 - Warning: Quotation marks ["] posted in the form.
If you insert some quotation marks within one of the posted values, they will not be taken in account.

Example:
If in the address field you post:

"Bellflower" Residence

The value taken in account by the payment gateway will only be:

Residence

Then the payment gateway will only take the Residence value in account to calculate the signature whereas your signature calculation will be based on the complete address: "Bellflower" Residence.

So you will get a signature error.

TO CONCLUDE: Before the signature calculation and the form sending you have to escape the quotation marks.
 
5 - The sent signature does not match with the signature calculation rule.
For more information consult the technical documentation.

VERSION V2 IMPLEMENTATION - vads_version=V2
Consult the V2 implementation documentation:
https://payzen.io
Do not forget that in V2 you have to sort the fields by alphabetical order.
warning If you use a WEB agency to administrate your shop, please contact them and communicate them the following address:
https://payzen.io/en-EN/error-code/error-00.html