| orderId | FLOAORDE6 | ✓ | A unique transaction reference. Do not reuse it for another Floa Pay payment. |
| currencyCode | EUR | ✓ | The three-letter ISO 4217 currency code of the payment. |
| amount | 45600 | ✓ | The financed amount in minor units. Must match the amount you authorize. |
| customerId | floa-customer-002 | | Your identifier for the customer. |
| order ↳ countryCode | FR | | The country of the order. |
| paymentMethod ↳ paymentType | ECOMMERCE | ✓ | Set to ECOMMERCE. |
| customer ↳ firstName | Carlos | | Recommended. If missing, Floa Pay may request it in its customer information form. |
| customer ↳ lastName | Garcia | | Recommended. If missing, Floa Pay may request it in its customer information form. |
| customer ↳ emailAddress | carlos.garcia@example.com | | Recommended. Validate the email format before creating the client session. |
| customer ↳ mobileNumber | +33624122644 | | Recommended. Mobile number in international format, including the country code. |
| customer ↳ nationalDocumentId | 26351648L | | Conditional. Tax or national identity document number, required in some countries. |
| customer ↳ billingAddress.firstName | Carlos | | Conditional. First name on the billing address. |
| customer ↳ billingAddress.lastName | Garcia | | Conditional. Last name on the billing address. |
| customer ↳ billingAddress.addressLine1 | 12 Rue de Rivoli | | Recommended. Send if available, or if required for the country or product. |
| customer ↳ billingAddress.addressLine2 | Apt 4B | | Additional address information. |
| customer ↳ billingAddress.city | Paris | | Recommended. Send if you provide a billing address. |
| customer ↳ billingAddress.postalCode | 75001 | | Recommended. Used for address and risk checks. Validate the format for the country. |
| customer ↳ billingAddress.countryCode | FR | ✓ | Two-letter ISO country code. Determines eligibility for the selected Floa Pay product. |
| customer ↳ shippingAddress.firstName | Carlos | | First name of the recipient. |
| customer ↳ shippingAddress.lastName | Garcia | | Last name of the recipient. |
| customer ↳ shippingAddress.addressLine1 | 8 Avenue Montaigne | | Conditional. Required when the order is not a virtual delivery. |
| customer ↳ shippingAddress.addressLine2 | Floor 2 | | Additional address information. |
| customer ↳ shippingAddress.city | Paris | | Conditional. Required when you send a shipping address. |
| customer ↳ shippingAddress.postalCode | 75008 | | Conditional. Required when you send a shipping address. Validate the format for the country. |
| customer ↳ shippingAddress.countryCode | FR | | Conditional. Two-letter ISO country code, for example FR, ES, IT, PT, NL, DE or BE. |
| metadata ↳ bnplPlan | BC3XF | ✓ | The Floa Pay product code, which sets the installment plan (for example 3x or 4x) and country. See Floa Pay’s product codes. |
| metadata ↳ shippingMethod | VIR | ✓ | The delivery method: STD standard, EXP express, TRK tracked, REL pickup point, MAG in store, LCK lockers, VIR virtual (digital sales). |
| metadata ↳ itemCount | 2 | ✓ | Total number of items. Must match the number of entries in metadata.itemsMetadata. |
| metadata ↳ reportDelayInDays | 30 | | Conditional. Number of days the payment is deferred. Required for 1x Pay Later products. |
| metadata ↳ birthDate | 1985-04-12 | | Conditional. Customer date of birth in YYYY-MM-DD format, used for eligibility and risk checks. |
| metadata ↳ birthCity | Paris | | Customer place of birth. May be required by some local checks. |
| metadata ↳ birthDepartment | 75 | | Customer department of birth, used in some countries. |
| metadata ↳ birthCountryCode | FR | | Customer country of birth as a two-letter ISO country code. |
| metadata ↳ secondLastName | Fernandez | | Customer second surname, for markets where one is used. |
| metadata ↳ createdDate | 2021-03-01 | | Date the customer account was created, in YYYY-MM-DD format. |
| metadata ↳ firstOrderDate | 2021-03-05 | | Date of the customer’s first order, in YYYY-MM-DD format. |
| metadata ↳ lastOrderDate | 2026-07-14 | | Date of the customer’s most recent order, in YYYY-MM-DD format. |
| metadata ↳ itemsMetadata[].name | Return Flight MAD-BCN | | Recommended. Product name or short description that identifies the financed item. |
| metadata ↳ itemsMetadata[].amount | 45000 | | Recommended. Item amount in minor units. |
| metadata ↳ itemsMetadata[].category | Travel | | Recommended. Product category, used for risk analysis and reporting. |
| metadata ↳ itemsMetadata[].subCategory | Flight | | Recommended. Product subcategory. |
| metadata ↳ floaMetadata[].key | travelType | | Recommended. Additional transaction data key, as agreed with Floa Pay during onboarding. |
| metadata ↳ floaMetadata[].value | TwoWay | | Recommended. The value for the key, sent as a string. |