2. Class mapping
Classes that must be mapped in your HTML code.
Once the class is mapped to it's given field, the script is able to retrieve the value contained in the field and submit it to compose the authentication request.
Warning
- The higher amount of fields parametrized, the higher is the chance of having a frictionless authentication, since the issuer will have more data for the risk analysis.
- The # character indicated in the field must be replaced by the number representing the item index. Example: bpmpi_item_1_productName' represents the first item of the cart.
| Data Category | Field | Description | Type/Size | Required |
|---|---|---|---|---|
| Parameterization | bpmpi_auth | Boolean indicating whether or not the transaction is submitted to the authentication process. | Boolean: true - submit to authentication false - don't subit to authentication | Yes |
| Parameterization | bpmpi_auth_notifyonly | Boolean indicating whether the card transaction will be submitted in "notification only" mode. In this mode, the authentication process will not be triggered, however, the data will be submitted to the flag. Valid only for Mastercard and Visa | Boolean: true - notification only mode; false - authentication mode | Not required if 3DS Full / Required if 3DS Data Only |
| Parameterization | bpmpi_auth_suppresschallenge | Boolean that indicates if ignore or not the challenge. If the challenge is ignored, the liability will keep with the merchant. | Boolean: true – ignore challenge false – perform challenge | Recommended |
| Parameterization | bpmpi_accesstoken | Token generated by Access Token API (step 1) | Alphanumeric (variable) | Yes |
| Order | bpmpi_ordernumber | Merchant order number | Alphanumeric [max 50 positions] | Yes |
| Order | bpmpi_currency | Currency code | Fixed "BRL" | Yes |
| Order | bpmpi_totalamount | Total transaction amount (cents) | Numeric [max 15 positions] | Yes |
| Order | bpmpi_installments | Number of Installments | Numeric [max 2 positions] | Yes |
| Order | bpmpi_paymentmethod | Card type to be authenticated. If the card has both functions, it is necessary to specify the transaction type. | Credit - Credit Card Debit - Debit Card | Yes |
| Order | bpmpi_cardnumber | Card number | Numeric [max 19 positions] | Yes |
| Order | bpmpi_cardexpirationmonth | Card expiration month | Numeric [max 2 positions] | Yes |
| Order | bpmpi_cardexpirationyear | Card expiration year | Numeric [max 4 positions] | Yes |
| Order | bpmpi_cardalias | Card alias | Alphanumeric [max 128 positions] | Recommended if there is a card alias. |
| Order | bpmpi_default_card | Indicates whether it is a standard customer card in the e-commerce | Boolean true - yes false - no | Recommended |
| Order | bpmpi_recurring_enddate | End date of recurrency | Text (AAAA-MM-DD) | Recommended, if recurrent transaction |
| Order | bpmpi_recurring_frequency | Frequency of recurrency | Number 1 - Monthly 2 - Bimonthly 3 - Quarterly 4 - Four Monthly 6 - Semester 12 - Annual | Recommended, if recurrent transaction |
| Order | bpmpi_recurring_originalpurchasedate | Date of first transaction that orignated the recurrency | Text (AAAA-MM-DD) | Recommended, if recurrent transaction |
| Order Description | bpmpi_order_recurrence | Indicates whether it is an order that generates future recurrences | Boolean true false | Recommended, if recurrent transaction |
| Order Description | bpmpi_order_productcode | Product Type | PHY: purchase Goods CHA: Check acceptance ACF: Account financing QCT: Quasi-Cash Transaction PAL: Prepaid Activation and Load | Yes |
| Order Description | bpmpi_order_countlast24hours | Number of orders placed by same customer in the last 24 hours | Numeric [max 3 positions] | No |
| Order Description | bpmpi_order_countlast6months | Number of orders placed by same customer in the last 6 months | Numeric [max 4 positions] | Recommended |
| Order Description | bpmpi_order_countlast1year | Number of orders placed by same customer in the last year | Numeric [max 3 positions] | Recommended |
| Order Description | bpmpi_order_cardattemptslast24hours | Number of orders placed with the same card in the last 24 hours | Numeric [max 3 positions] | Recommended |
| Order Description | bpmpi_order_marketingoptin | Indicates whether the shopper accepted to receive marketing offers | Boolean true - yes false - no | Recommended |
| Order Description | bpmpi_order_marketingsource | Identifies the origin of the marketing campaign | Alphanumeric [max 40 positions] | Recommended |
| Order Description | bpmpi_transaction_mode | Identifies the channel from which the transaction originates | M: MOTO R: Varejo S: E-Commerce P: Mobile T: Tablet | Recommended |
| Order Description | bpmpi_merchant_url | Address of the e-commerce's web site | Alphanumeric [max 100 positions] Example: http://www.exemplo.com.br | Yes |
| Prepaid cards | bpmpi_giftcard_amount | The total purchase amount for prepaid gift cards in rounded value | Numeric [max 15 positions], example: R$125,54 = 12554 | Recommended if the card being used is prepaid |
| Prepaid cards | bpmpi_giftcard_currency | Transaction currency code paid with prepaid type card | Fixed "BRL" | Recommended if the card being used is prepaid |
| Billing Address | bpmpi_billto_customerid | Identifies the CPF/CNPJ of customer | Numeric [11 to 14 positions] 99999999999999 | No |
| Billing Address | bpmpi_billto_contactname | Billing address contact name | Alphanumeric [max 120 positions] | Recommended |
| Billing Address | bpmpi_billto_phonenumber | Billing address phone number | Numeric [max 15 positions], in the format: 5511999999999 | Recommended |
| Billing Address | bpmpi_billto_email | Billing address contact email | Alphanumeric [max 255 positions], in the format [email protected] | Recommended |
| Billing Address | bpmpi_billto_street1 | Street address and billing address number | Alphanumeric [max 60 positions] | Recommended |
| Billing Address | bpmpi_billto_street2 | Neighborhood and complement billing address | Alphanumeric [max 60 positions] | Recommended |
| Billing Address | bpmpi_billto_city | Billing address city | Alphanumeric [max 50 positions] | Recommended |
| Billing Address | bpmpi_billto_state | Billing address state | Text [2 positions] | Recommended |
| Billing Address | bpmpi_billto_zipcode | Billing address zip code | Alphanumeric [max 8 positions], in the format: 99999999 | Recommended |
| Billing Address | bpmpi_billto_country | Billing address country | Text [2 positions] e.g., BR | Recommended |
| Delivery Address | bpmpi_shipto_sameasbillto | Indicates it is the same address provided on the billing address | Boolean true false | Recommended |
| Delivery Address | bpmpi_shipto_addressee | Shipping address contact name | Alphanumeric [max 60 positions] | Recommended |
| Delivery Address | bpmpi_shipTo_phonenumber | Delivery address phone number | Numeric [max 15 positions], in the format: 5511999999999 | Recommended |
| Delivery Address | bpmpi_shipTo_email | Delivery address contact email | Alphanumeric [max 255 positions], in the format [email protected] | Recommended |
| Delivery Address | bpmpi_shipTo_street1 | Street address and delivery address number | Alphanumeric [max 60 positions] | Recommended |
| Delivery Address | bpmpi_shipTo_street2 | Neighborhood and complement delivery address | Alphanumeric [max 60 positions] | NRecommended |
| Delivery Address | bpmpi_shipTo_city | Delivery address city | Alphanumeric [max 50 positions] | Recommended |
| Delivery Address | bpmpi_shipTo_state | Accuracy of delivery address state | string [2 positions] | NRecommended |
| Delivery Address | bpmpi_shipto_zipcode | Delivery address zip code | Alphanumeric [max 2 positions], in the format: 99999999 | Recommended |
| Delivery Address | bpmpi_shipto_country | Delivery address country | Text [2 positions], e.g., BR | Recommended |
| Delivery Address | bpmpi_shipTo_shippingmethod | Shipping method type | lowcost sameday oneday twoday threeday pickup other | Recommended |
| Delivery Address | bpmpi_shipto_firstusagedate | Indicates the date of first use of the delivery address | Text AAAA-MM-DD - criation date | Recommended |
| Shopping Cart | bpmpi_cart_#_description | Item description | Alphanumeric [max 255 positions] | Recommended |
| Shopping Cart | bpmpi_cart_#_name | Item name | Alphanumeric [max 255 positions] | Recommended |
| Shopping Cart | bpmpi_cart_#_sku | Item SKU | Alphanumeric [max 255 positions] | Recommended |
| Shopping Cart | bpmpi_cart_#_quantity | Cart item quantity | Numeric [max 10 positions] | Recommended |
| Shopping Cart | bpmpi_cart_#_unitprice | Unit value of the cart item (cents) | Numeric [max 10 positions] | Recommended |
| User | bpmpi_useraccount_guest | Indicates whether the customer is not logged (guest) | Boolean true - yes false - no | Recommended |
| User | bpmpi_useraccount_createddate | Indicates the account creation date | String AAAA-MM-DD - creation date | Recommended |
| User | bpmpi_useraccount_changeddate | Indicates the last change date of shopper's account | String AAAA-MM-DD - last alteration date | Recommended |
| User | bpmpi_useraccount_passwordchangeddate | Indicates the date when the shopper's account password changed | Text AAAA-MM-DD - date of the last password change | Recommended |
| User | bpmpi_useraccount_authenticationmethod | Shopper's authentication method | 01 - No authentication 02 - Store login 03 - Login with federated ID 04 - Login with FIDO authenticator | Recommended |
| User | bpmpi_useraccount_authenticationprotocol | Data that represents the login protocol carried out in the store | Alphanumeric [max 2048 positions] | Recommended |
| User | bpmpi_useraccount_authenticationtimestamp | The date and time the store was logged in | String [max 19 positions]YYYY-MM-ddTHH:mm:ss | Recommended |
| User | bpmpi_merchant_newcustomer | Indicates whether the consumer is a new or existing customer with the merchant | Boolean true – yes false – no | NRecommended |
| Device | bpmpi_device_ipaddress | IP address of the shopper's machine | Alphanumeric [max 45 positions] | Yes |
| Device | bpmpi_device_#_fingerprint | Id returned by Device Fingerprint | Alphanumeric [no limit] | Recommended |
| Device | bpmpi_device_#_provider | Device Fingerprint provider name | Alphanumeric [max 32 positions] cardinal inauth threatmetrix | Recommended |
| Device | bpmpi_device_#_channel | Channel from which the transaction came from. Possible values: -Browser -SDK -3RI | Alphanumeric [up to 7 positions] | Yes |
| Recurrence | bpmpi_recurring_type | Recurring payment type. | Number 1 - First transaction 2 - Subsequent transaction 3 - Modification 4-Cancellation | Recommended, if recurrent transaction |
| Recurrence | bpmpi_recurring_validationIndicator | Indicates whether the recurring payment transaction was validated or not. | Number 0 - Not validated 1 - Validated | Recommended, if recurrent transaction |
| Recurrence | bpmpi_recurring_maximumAmount | Maximum amount agreed by the cardholder. | numeric [up to 12 positions] | Recommended, if recurrent transactiono |
| Recurrence | bpmpi_recurring_referenceNumber | Unique reference number for the recurring payment transaction. | Alphanumeric [up to 35 positions] | Recommended, if recurrent transaction |
| Recurrence | bpmpi_recurring_occurrence | Indicates how often a recurring payment occurs. | Number 01 - Daily 02 - Twice a week 03 - Weekly 04 - Every ten days 05 - Fortnightly 06- Monthly 07 - Bimonthly 08 - Every three months 09 - Every four months 10 - Every six months 11 - Annually 12 - Unscheduled. | Recommended, if recurrent transaction |
| Recurrence | bpmpi_recurring_numberOfPayments | Total number of payments during the recurring subscription. | Number [up to 2 positions] | Recommended, if recurrent transaction |
| Recurrence | bpmpi_recurring_amountType | Indicates the type of recurring amount agreed by the cardholder. | Supported values: 1 - Recurring payment of fixed value 2 - Recurring payment with maximum value. | Recommended, if recurrent transaction |
| Airlines | bpmpi_airline_travelleg_#_carrier | IATA code for the stretch | Alphanumeric [2 positions] | Recommended for airlines |
| Airlines | bpmpi_airline_travelleg_#_departuredate | Departure date | String AAAA-MM-DD | Recommended for airlines |
| Airlines | bpmpi_airline_travelleg_#_origin | IATA code from origin airport | Alphanumeric [5 positions] | Recommended for airlines |
| Airlines | bpmpi_airline_travelleg_#_destination | IATA code from destination airport | Alphanumeric [5 positions] | Recommended for airlines |
| Airlines | bpmpi_airline_passenger_#_name | Passenger name | Alphanumeric [max 60 positions] | Recommended for airlines |
| Airlines | bpmpi_airline_passenger_#_ticketprice | Ticket price (cents) | Numeric [max 15 positions], example:R$125,54 = 12554 | Recommended for airlines |
| Airlines | bpmpi_airline_numberofpassengers | Passenger number | Numeric [3 positions] | Recommended for airlines |
| Airlines | bpmpi_airline_billto_passportcountry | Code of the country that emitted the passport (ISO Standard Country Codes) | Text [2 positions] | Recommended for airlines |
| Airlines | bpmpi_airline_billto_passportnumber | Passport number | Alphanumeric [40 positions] | Recommended for airlines |
| Merchant Defined Data | bpmpi_mdd1 | Extra data defined by the merchant | Alphanumeric [max 255 positions] | No |
| Merchant Defined Data | bpmpi_mdd2 | Extra data defined by the merchant | Alphanumeric [max 255 positions] | No |
| Merchant Defined Data | bpmpi_mdd3 | Extra data defined by the merchant | Alphanumeric [max 255 positions] | No |
| Merchant Defined Data | bpmpi_mdd4 | Extra data defined by the merchant | Alphanumeric [max 255 positions] | No |
| Merchant Defined Data | bpmpi_mdd5 | Extra data defined by the merchant | Alphanumeric [max 255 positions] | No |
| Merchant Defined Data | bpmpi_brand_establishment_code | Amex Establishment Code (EC) | Text [10 positions] | Required for Amex authentications |
Updated about 2 months ago