• France
status page
Merchant Back Office
assistance
FAQContact support
Search
Categories
Tags
English
French
English
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
Logos
Push mail
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

error 170 - Error 170 - FRANFINANCE_UNRECOGNIZED_FIELD

In PRODUCTION mode, if your buyer gets an error message such as:

An error occurred during the payment request, please make sure that the posted parameters match the ones specified in the documentation.

It becomes impossible to make the payment and the transaction is definitively lost.

You will receive an e-mail notification containing the form that the gateway was unable to process and the value of the invalid field.

The FRANFINANCE_UNRECOGNIZED_FIELD error appears during a transaction via Franfinance.

We invite you to check the following reason(s) to resolve the issue:

Transmitted keys not recognized for the FRANFINANCE key.

By default, the rules for fee application upon a 3xWEB or 4xWEB payment are defined in MID configuration.

However, the merchant has the possibility to enable or disable fee application via his or her payment form.

To do so, the vads_acquirer_transient_data field should be valued as follows:
  • To enable fee application upon a 3xWEB payment only:
    vads_acquirer_transient_data={"FRANFINANCE":{"FEES_3X":"Y","FEES_4X":"N"}}

  • To enable fee application upon a 4xWEB payment only:
    vads_acquirer_transient_data={"FRANFINANCE":{"FEES_3X":"N","FEES_4X":"Y"}}

  • To enable fee application upon a 3xWEB and a 4xWEB payment:
    vads_acquirer_transient_data={"FRANFINANCE":{"FEES_3X":"Y","FEES_4X":"Y"}}

  • To disable fee application upon a 3xWEB and a 4xWEB payment:
    vads_acquirer_transient_data={"FRANFINANCE":{"FEES_3X":"N","FEES_4X":"N"}}

  • To enable fee application upon 3xWEB payment and leave the default choice for the 4xWEB payment:
    vads_acquirer_transient_data={"FRANFINANCE":{"FEES_3X":"Y"}}

Make sure you send the FEES_3X and FEES_4X keys with the values "Y" or "N".

© 2025 {'|'} All rights reserved to Systempaylegal
25.18-1.11