Resposta CustomerWallet
Objeto com as informações relativas a um wallet comprador. Contém a lista dos cartões salvos com a referência comprador.
Referência da resposta
customerReference
Formato
cancellationDate
Caminho: tokens.cancellationDate
Data de rescisão do Token.
Formato
tokens.creationDate
Data e hora de criação do Token Catão.
Formato
paymentMethodToken
Caminho: tokens.paymentMethodToken
Token associado a um meio de pagamento.
Formato
paymentMethodType
Caminho: tokens.paymentMethodType
Tipo de meio de pagamento. Exemplo: PAYCONIQ
Formato
tokens.status
Formato
Valores possíveis
Os valores possíveis são os seguintes:
VALOR | Descrição | |
---|---|---|
ACTIVE | O cartão pode ser usado para um pagamento (valor por default) | |
EXPIRED | O método de pagamento venceu. | |
CANCELLED | O cartão está logicamente removido (cancelado) | |
all | Todos os status combinados |
reference
Caminho: tokens.customer.reference
Código de identificação do comprado para o Estabelecimento Comercial.
Formato
Caminho: tokens.customer.email
Endereço e-mail do comprador.
- Especificações de estrutura de e-mail: RFC-2822
Formato
address
Caminho: tokens.customer.billingDetails.address
Endereço de faturamento.
Advertência: Os símbolos > e < não são autorizados.
Formato
address2
Caminho: tokens.customer.billingDetails.address2
Informações complementares sobre o endereço de faturamento.
Advertência: Os símbolos > e < não são autorizados.
Formato
category
Caminho: tokens.customer.billingDetails.category
Tipo de cliente.
Formato
Valores possíveis
valores | Descrição |
---|---|
PRIVATE | Cliente de tipo Pessoa física |
COMPANY | Cliente de tipo Pessoa Jurídica |
cellPhoneNumber
Caminho: tokens.customer.billingDetails.cellPhoneNumber
Telefone mobile do comprador.
Aceita todos os formatos:
Exemplos:
- 0623456789
- +33623456789
- 0033623456789
- (+34) 824 65 43 21
- 87 77 12 34
Formato
city
Caminho: tokens.customer.billingDetails.city
Cidade de faturamento.
Formato
country
Caminho: tokens.customer.billingDetails.country
País do comprador (em maiúscula, conforme à norma ISO 3166-1 alfa-2).
Formato
Valores possíveis
Exemplos de valores possíveis:
País | Código |
---|---|
ÁUSTRIA | AT |
Brasil | BR |
CORSEGA | FR |
COSTA DO MARFIM | CI |
FRANÇA | FR |
GUADALUPE | GP |
ÍNDIA | IN |
MARTINICA | MQ |
NOVA-CALEDONIA | NC |
ST-PIERRE-ET-MIQUELON | PM |
POLINÉSIA FRANCESA | PF |
district
Caminho: tokens.customer.billingDetails.district
Bairro do endereço de faturamento.
Formato
firstName
Caminho: tokens.customer.billingDetails.firstName
Nome do comprador.
Formato
identityCode
Caminho: tokens.customer.billingDetails.identityCode
CPF/CNPJ. Possibilita identificar de maneira única cada cidadão dentro de um país.
Formato
identityType
Caminho: tokens.customer.billingDetails.identityType
Tipo de documento de identidade.
Formato
language
Caminho: tokens.customer.billingDetails.language
Código do idioma do comprador, conforme a norma ISO 639-1.
Permite especificar o idioma de envio dos e-mails de confirmação de pagamento.
Formato
Valores possíveis
Exemplos de valores possíveis:
Idioma | Código |
---|---|
Alemão (Alemanha) | DE |
Inglês (Reino-Unido) | EN |
Inglês (Estados-Unidos) | EN |
Chinês (Tradicional) | ZH |
Espanhol (Espanha) | ES |
Espanhol (Chile) | ES |
Francês (França) | FR |
Italiano (Itália) | IT |
Japonês (Japão) | JP |
Holandês (Holanda) | NL |
Polonês (Polônia) | PL |
Português (Brasil) | PT |
Português (Portugal) | PT |
Russo (Rússia) | RU |
lastName
Caminho: tokens.customer.billingDetails.lastName
Sobrenome do comprador.
Formato
legalName
Caminho: tokens.customer.billingDetails.legalName
Razão social.
Formato
phoneNumber
Caminho: tokens.customer.billingDetails.phoneNumber
Número de telefone do comprador.
Aceita todos os formatos:
Exemplos:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42
Formato
state
Caminho: tokens.customer.billingDetails.state
Região (estado) do endereço de faturamento. Recomendado mas não obrigatório passar o valor em ISO-3166-2.
Formato
streetNumber
Caminho: tokens.customer.billingDetails.streetNumber
Número de rua do endereço de faturamento.
Carateres aceites:
- Caracteres alfabéticos (de "A" a "Z" e de "a" a "z")
- Espaço
Formato
title
Caminho: tokens.customer.billingDetails.title
Estado civil do comprador.
Exemplos:
- Sr.
- Sr.
- Sra.
Formato
zipCode
Caminho: tokens.customer.billingDetails.zipCode
CEP do endereço de faturamento.
Formato
address
Caminho: tokens.customer.shippingDetails.address
Endereço de entrega.
Advertência: Os símbolos > e < não são autorizados.
Formato
address2
Caminho: tokens.customer.shippingDetails.address2
Segunda linha do endereço de entrega.
Advertência: Os símbolos > e < não são autorizados.
Formato
category
Caminho: tokens.customer.shippingDetails.category
Tipo de cliente.
Formato
Valores possíveis
valores | Descrição |
---|---|
PRIVATE | Cliente de tipo Pessoa física |
COMPANY | Cliente de tipo Pessoa Jurídica |
city
Caminho: tokens.customer.shippingDetails.city
Cidade de entrega.
Formato
country
Caminho: tokens.customer.shippingDetails.country
País de entrega (em maiúscula, conforme a norma ISO 3166-1 alfa-2).
Formato
Valores possíveis
Exemplos de valores possíveis:
País | Código |
---|---|
ÁUSTRIA | AT |
Brasil | BR |
CORSEGA | FR |
COSTA DO MARFIM | CI |
FRANÇA | FR |
GUADALUPE | GP |
ÍNDIA | IN |
MARTINICA | MQ |
NOVA-CALEDONIA | NC |
ST-PIERRE-ET-MIQUELON | PM |
POLINÉSIA FRANCESA | PF |
deliveryCompanyName
Caminho: tokens.customer.shippingDetails.deliveryCompanyName
Nome da empresa que entrega o produto.
Formato
district
Caminho: tokens.customer.shippingDetails.district
Bairro do endereço de faturamento.
Formato
firstName
Caminho: tokens.customer.shippingDetails.firstName
Nome do destinatário.
Formato
identityCode
Caminho: tokens.customer.shippingDetails.identityCode
CPF/CNPJ. Possibilita identificar de maneira única cada cidadão dentro de um país.
Formato
lastName
Caminho: tokens.customer.shippingDetails.lastName
Sobrenome do comprador.
Formato
legalName
Caminho: tokens.customer.shippingDetails.legalName
Razão social para uma entrega em uma empresa.
Formato
phoneNumber
Caminho: tokens.customer.shippingDetails.phoneNumber
Número de telefone do comprador.
Aceita todos os formatos:
Exemplos:
- 0123456789
- +33123456789
- 0033123456789
- (00.571) 638.14.00
- 40 41 42 42
Formato
shippingMethod
Caminho: tokens.customer.shippingDetails.shippingMethod
Modo de entrega.
Formato
Valores possíveis
VALOR | Descrição |
---|---|
RECLAIM_IN_SHOP | Retirada de mercadoria na loja. |
RELAY_POINT | Utilização de uma rede de pontos de entrega terceirizados (Kiala, Alveol, etc). |
RECLAIM_IN_STATION | Retirada em um aeroporto, uma agência de viagens ou outros. |
PACKAGE_DELIVERY_COMPANY | Entrega por transportadora (Colissimo, UPS, etc). |
ETICKET | Emissão de uma passagem eletrônica, download de produtos virtuais. |
CARD_HOLDER_ADDRESS | Entrega no endereço do comprador. Reservado para um uso futuro. |
VERIFIED_ADDRESS | Entrega em um endereço verificado. Reservado para um uso futuro. |
NOT_VERIFIED_ADDRESS | Entrega em um endereço não verificado. Reservado para um uso futuro. |
SHIP_TO_STORE | Entrega na loja. Reservado para um uso futuro. |
DIGITAL_GOOD | Entrega digital. Reservado para um uso futuro. |
ETRAVEL_OR_ETICKET | Passagem eletrônica. Reservado para um uso futuro. |
OTHER | Outros Reservado para um uso futuro. |
PICKUP_POINT | Entrega em ponto de retirada. Reservado para um uso futuro. |
AUTOMATED_PICKUP_POINT | Entrega em ponto de retirada automático. Reservado para um uso futuro. |
shippingSpeed
Caminho: tokens.customer.shippingDetails.shippingSpeed
Prazo de entrega.
Formato
Valores possíveis
Exemplos de valores possíveis:
VALOR | Descrição |
---|---|
STANDARD | Entrega padrão. |
EXPRESS | Entrega em menos de 24h. |
PRIORITY | Entrega prioritária (Click & Collect) |
state
Caminho: tokens.customer.shippingDetails.state
Região do endereço de faturamento.
Formato
streetNumber
Caminho: tokens.customer.shippingDetails.streetNumber
Número de rua do endereço de entrega.
Carateres aceites:
- Caracteres alfabéticos (de "A" a "Z" e de "a" a "z")
- Espaço
Formato
zipCode
Caminho: tokens.customer.shippingDetails.zipCode
CEP do endereço de faturamento.
Formato
ipAddress
Caminho: tokens.customer.extraDetails.ipAddress
Endereço IP do comprador.
Formato
fingerPrintId
Caminho: tokens.customer.extraDetails.fingerPrintId
Formato
browserUserAgent
Caminho: tokens.customer.extraDetails.browserUserAgent
Header « User-Agent » do navegador do comprador (HTTP/1.1 - RFC. 2616).
Formato
browserAccept
Caminho: tokens.customer.extraDetails.browserAccept
Header « Accept » do navegador do comprador (HTTP/1.1 - RFC. 2616).
Formato
insuranceAmount
Caminho: tokens.customer.shoppingCart.insuranceAmount
Valor do seguro para a totalidade do pedido expresso na sua menor unidade monetária (o centavo para o Euro).
Exemplo: 30050 para 300,50 EUR.
Formato
shippingAmount
Caminho: tokens.customer.shoppingCart.shippingAmount
Montante do frete para o total do pedido, na menor unidade monetária da moeda (o centavo para o Real). Ex: 1234 para 12,34 BRL.
Exemplo: 30050 para 300,50 EUR.
Formato
taxAmount
Caminho: tokens.customer.shoppingCart.taxAmount
Valor dos impostos para a totalidade do pedido expresso na sua menor unidade monetária (o centavo para o Euro).
Exemplo: 30050 para 300,50 EUR.
Formato
cartItemInfo
Caminho: tokens.customer.shoppingCart.cartItemInfo
cardItemInfo é uma lista de objetos Customer/ShoppingCartItemInfo.
Permite descrever cada artigo do carrinho.
Formato
productAmount
Caminho: tokens.customer.shoppingCart.cartItemInfo.productAmount
Valor do produto expresso na sua menor unidade monetária (o centavo para o Euro).
Exemplo: 30050 para 300,50 EUR.
Formato
productLabel
Caminho: tokens.customer.shoppingCart.cartItemInfo.productLabel
Nome do produto.
Formato
productQty
Caminho: tokens.customer.shoppingCart.cartItemInfo.productQty
Quantidade de produto.
Formato
productRef
Caminho: tokens.customer.shoppingCart.cartItemInfo.productRef
Referência produto.
Formato
productType
Caminho: tokens.customer.shoppingCart.cartItemInfo.productType
Tipo de produto.
Valores possíveis
VALOR | Descrição |
---|---|
FOOD_AND_GROCERY | Produtos alimentares e de mercadinho |
AUTOMOTIVE | Automóvel / Moto |
ENTERTAINMENT | Lazer / Cultura |
HOME_AND_GARDEN | Casa e jardim |
HOME_APPLIANCE | Equipamentos para a casa |
AUCTION_AND_GROUP_BUYING | Leilões e compras em grupo |
FLOWERS_AND_GIFTS | Flores e presentes |
COMPUTER_AND_SOFTWARE | Computadores e softwares |
HEALTH_AND_BEAUTY | Saúde e beleza |
SERVICE_FOR_INDIVIDUAL | Serviços para pessoa física |
SERVICE_FOR_BUSINESS | Serviços para pessoa jurídica |
SPORTS | Esportes |
CLOTHING_AND_ACCESSORIES | Roupas e acessórios |
TRAVEL | Viagem |
HOME_AUDIO_PHOTO_VIDEO | Som, imagem e vídeo |
TELEPHONY | Telefonia |
Formato
productVat
Caminho: tokens.customer.shoppingCart.cartItemInfo.productVat
Tipo de produto.
Valor do imposto sobre o produto (apresentado na menor unidade da moeda).
Valores possíveis
VALOR | Descrição |
---|---|
Um número inteiro | Valor da transação. O valor dela deve ser um número inteiro positivo (ex: 1234 para 12,34 EUR). |
Um número decimal, inferior a 100 | Percentagem aplicada sobre o valor. Exemplos: 20.0 ou 19.6532 |
Para mencionar uma percentagem aplicada sobre o valor do produto em questão, o valor deve ter no máximo 4 dígitos após a virgula. A decimal é obrigatória para mencionar uma percentagem. A decimal é marcada pelo símbolo ".".
Formato
country
Caminho: tokens.tokenDetails.country
Código país do cartão.
Formato
effectiveBrand
Caminho: tokens.tokenDetails.effectiveBrand
Rede do cartão.
Meio de pagamento | Tipo de cartão (effectiveBrand) |
---|---|
Carte enseigne Accord | ACCORD_STORE |
Carte enseigne Accord - Mode sandbox | ACCORD_STORE_SB |
Alipay | ALIPAY |
Alma en 2 fois | ALMA_2X |
Alma en 3 fois | ALMA_3X |
Alma en 4 fois | ALMA_4X |
Alma en 10 fois | ALMA_10X |
Alma en 12 fois | ALMA_12X |
American Express | AMEX |
Titre-Restaurant Dématérialisé Apetiz | APETIZ |
Paiement par Wallet Apple Pay | APPLE_PAY |
Carte Cpay | AURORE-MULTI |
Bancontact Mistercash | BANCONTACT |
Bizum | BIZUM |
CB | CB |
Titre-Restaurant Dématérialisé Chèque Déjeuner | CHQ_DEJ |
Carte Aurore "CORA" | CORA |
Carte Aurore "CORA blanche" | CORA_BLANCHE |
Carte Aurore "CORA Premium" | CORA_PREM |
Carte Aurore "CORA VISA" | CORA_VISA |
Titre-Restaurant Dématérialisé Conecs | CONECS |
Diners | DINERS |
Discover | DISCOVER |
e-carte bleue | E-CARTEBLEUE |
Ticket Eco Chèque Edenred | EDENRED_EC |
Ticket Sports & Culture Edenred | EDENRED_SC |
Ticket Compliment Edenred | EDENRED_TC |
Ticket Restaurant Edenred | EDENRED_TR |
Paiement en 3X Franfinance | FRANFINANCE_3X |
Paiement en 4X Franfinance | FRANFINANCE_4X |
Paiement en 3x sans frais par BNPP PF | FULLCB3X |
Paiement en 4x sans frais par BNPP PF | FULLCB4X |
Giropay | GIROPAY |
Paiement par Wallet Google Pay | GOOGLEPAY |
iDeal Internet Banking | IDEAL |
Carte Cadeau Illicado | ILLICADO |
Carte Cadeau Illicado - Mode sandbox | ILLICADO_SB |
Virement SEPA | IP_WIRE |
JCB | JCB |
Maestro | MAESTRO |
Mastercard | MASTERCARD |
Multibanco | MULTIBANCO |
MyBank | MYBANK |
Payconiq | PAYCONIQ |
PayDirekt | PAYDIREKT |
PAYPAL | PayPal |
PAYPAL_BNPL | PayPal Pay Later |
PAYPAL_SB | PayPal - Mode sandbox |
PAYPAL_BNPL_SB | PayPal Pay Later- Mode sandbox |
PostFinance | POSTFINANCE |
PostFinance E-finance | POSTFINANCE_EFIN |
Przelewy24 | PRZELEWY24 |
Prélèvement Bancaire SEPA DIRECT DEBIT | SDD |
Titre-Restaurant Dématérialisé Sodexo | SODEXO |
Sofort Banking | SOFORT_BANKING |
Union Pay | UNION_PAY |
BHIM-UPI | BHIM-UPI |
Visa | VISA |
Visa Electron | VISA_ELECTRON |
Vpay | VPAY |
Formato
effectiveProductCode
Caminho: tokens.tokenDetails.effectiveProductCode
Código produto do cartão usado para o pagamento.
visa | Designação |
---|---|
a | Visa Traditional |
B | Visa Traditional Rewards |
C | Visa Signature |
D | Visa Signature Preferred |
e | Proprietary ATM |
F | Visa Classic |
G | Visa Business |
G1 | Visa Signature Business |
G2 | Reserved |
G3 | Visa Business Enhanced |
G4 | Visa Infinite Business |
G5 | Visa Business Rewards |
H | Reserved |
I | Visa Infinite |
I1 | Visa Infinite Privilege |
I2 | Visa Ultra High Net Worth |
J | Reserved |
J1 | Reserved |
J2 | Reserved |
J3 | Visa Healthcare |
J4 | Reserved |
K | Visa Corporate T&E |
K1 | Visa GSA Corporate T&E |
L | Electron |
N | Visa Platinium |
N1 | TBA |
N2 | Visa Select |
P | Visa Gold |
Q | Private Label |
Q1 | Reserved |
Q2 | Private Label Basic |
Q3 | Private Label Standard |
Q4 | Private Label Enhanced |
Q5 | Private Label Specialized |
Q6 | Private Label Premium |
R | Proprietary |
S | Visa Purchasing |
S1 | Visa Purchasing |
S2 | Visa Purchasing |
S3 | Visa Purchasing |
S4 | Government Services Loan |
S5 | Commercial Transport EBT |
S6 | Business Loan |
S7 | Visa Distribution |
T | Reserved |
U | Visa TravelMoney |
V | Visa VPay |
W | Reserved |
X | Reserved |
Y | Reserved |
Z | Reserved |
mastercard | Designação |
---|---|
BPD | MASTERCARD BUSINESS PREMIUM DEBIT |
CIR | CIRRUS |
DAG | GOLD DEBIT MASTERCARD SALARY |
DAP | PLATINUM DEBIT MASTERCARD SALARY |
DAS | STANDARD DEBIT MASTERCARD SALARY |
DDB | DOMESTIC DEBIT BRAND |
DLG | DEBIT GOLD DELAYED DEBIT |
DLH | DEBIT WORLD EMBOSSED DELAYED DEBIT |
DLP | DEBIT PLATINUM DELAYED DEBIT |
DLS | MASTERCARD CARD-DELAYED DEBIT |
DOS | STANDARD DEBIT MASTERCARD SOCIAL |
DWF | DEBIT MASTERCARD HUMANITARIAN PREPAID |
Sr. | mastercard |
MAB | WORLD ELITE MASTERCARD |
MAC | MASTERCARD CORPORATE WORLD ELITE |
MAP | MASTERCARD COMMERCIAL PAYMENTS ACCOUNT |
MBB | MASTERCARD PREPAID CONSUMER |
MBC | MASTERCARD PREPAID VOUCHER |
MBD | MASTERCARD PROFESSIONAL DEBIT BUSINESS CARD |
MBE | MASTERCARD ELECTRONIC BUSINESS CARD |
MBK | MASTERCARD BLACK |
MBP | MASTERCARD UNKNOWN PRODUCT |
MBS | MASTERCARD B2B PRODUCT |
MBT | MASTERCARD CORPORATE PREPAID TRAVEL |
MBW | WORLD MASTERCARD BLACK EDITION – DEBIT |
MCB | MASTERCARD BUSINESS CARD |
MCC | MASTERCARD CREDIT MIXED BIN CARD |
MCD | MASTERCARD DEBIT CARD |
MCE | MASTERCARD ELECTRONIC CARD |
MCF | MASTERCARD FLEET CARD |
MCG | MASTERCARD GOLD CARD |
MCH | MASTERCARD PREMIUM CHARGE |
MCO | MASTERCARD CORPORATE CARD |
MCP | MASTERCARD PURCHASING CARD |
MCS | MASTERCARD STANDARD CARD |
MCT | TITANIUM MASTERCARD CARD |
MCV | MERCHANT BRANDED PROGRAM |
MCW | WORLD MASTERCARD CARD |
MDB | DEBIT MASTERCARD BUSINESSCARD CARD |
MDG | DEBIT GOLD MASTERCARD CARD |
MDH | DEBIT OTHER EMBOSSED |
MDJ | DEBIT OTHER 2 EMBOSSED |
MDL | BUSINESS DEBIT OTHER EMBOSSED |
MDN | BUSINESS DEBIT OTHER 2 EMBOSSED |
MDO | DEBIT OTHER CARD |
MDP | DEBIT PLATINUM CARD |
MDR | DEBIT BROKERAGE CARD |
MDS | DEBIT MASTERCARD CARD |
MDT | MASTERCARD BUSINESS DEBIT |
MDW | WORLD ELITE DEBIT MASTERCARD |
MEB | MASTERCARD EXECUTIVE BUSINESS CARD |
MEC | MASTERCARD ELECTRONIC COMMERCIAL CARD |
MEF | ELECTRONIC PAYMENT ACCOUNT |
MEO | MASTERCARD CORPORATE EXECUTIVE CARD |
MET | TITANIUM DEBIT MASTERCARD CARD |
MFB | FLEX WORLD ELITE |
MFD | FLEX PLATINUM |
MFE | FLEX CHARGE WORLD ELITE |
MFH | FLEX WORLD |
MFL | FLEX CHARGE PLATINUM |
MFW | FLEX CHARGE WORLD |
MGF | MASTERCARD GOUVERNMENT COMMERCIAL CARD |
MHA | MASTERCARD HEALTHCARE PREPAID NON-TAX |
MHB | MASTERCARD HSA SUBSTANTIATED (DEBIT MASTERCARD) |
MHD | HELOC DEBIT STANDARD |
MHH | MASTERCARD HSA NON-SUBSTANTIATED (DEBIT MASTERCARD) |
MHL | HELOC DEBIT GOLD |
MHM | HELOC DEBIT PLATINUM |
MHN | HELOC DEBIT PREMIUM |
MIA | PREPAID MASTERCARD UNEMBOSSED STUDENT CARD |
MIP | PREPAID DEBIT MASTERCARD STUDENT CARD |
MIU | DEBIT MASTERCARD UNEMBOSSED |
MLA | MASTERCARD CENTRAL TRAVEL SOLUTIONS AIR CARD |
MLD | MASTERCARD DISTRIBUTION CARD |
MLL | MASTERCARD CENTRAL TRAVEL SOLUTIONS LAND CARD |
MNF | MASTERCARD PUBLIC SECTOR COMMERCIAL CARD |
MNW | MASTERCARD NEW WORLD |
MOC | MASTERCARD UNKNOWN PRODUCT |
MOG | MAESTRO GOLD |
MOP | MAESTRO PLATINIUM |
MOW | MAESTRO WORLD |
MPA | MASTERCARD PREPAID DEBIT STANDARD-PAYROLL |
MPB | PREFERRED BUSINESS CARD |
MPC | MPC |
MPD | MASTERCARD FLEX PREPAID |
MPF | MASTERCARD PREPAID DEBIT STANDARD-GIFT |
MPG | MASTERCARD UNEMBOSSED PREPAID STUDENT CARD |
MPH | MASTERCARD CASH PREPAID |
MPJ | PREPAID DEBIT MASTERCARD CARD GOLD |
MPK | PREPAID MASTERCARD GOUVERNMENT COMMERCIAL CARD |
MPL | PLATINIUM MASTERCARD CARD |
MPM | MASTERCARD PREPAID DEBIT STANDARD-CONSUMER INCENTIVE |
MPN | MASTERCARD PREPAID DEBIT STANDARD-INSURANCE |
MPO | MASTERCARD PREPAID DEBIT STANDARD-OTHER |
MPP | PRE-PAID CARD |
MPR | MASTERCARD PREPAID DEBIT STANDARD-TRAVEL |
MPT | MASTERCARD PREPAID DEBIT STANDARD-TEEN |
MPV | MASTERCARD PREPAID DEBIT STANDARD-GOVERNMENT |
MPW | DEBIT MASTERCARD BUSINESS CARD PREPAID WORK B2B |
MPX | MASTERCARD PREPAID DEBIT STANDARD-FLEX BENEFIT |
MPY | MASTERCARD PREPAID DEBIT STANDARD-EMPLOYEE INCENTIVE |
MPZ | MASTERCARD PREPAID DEBIT STANDARD – GOVERNMENT CONSUMER |
MRC | MASTERCARD ELECTRONIC CONSUMER PREPAID |
MRF | MASTERCARD EUROPEAN REGULATED INDIVIDUAL PAY |
MRG | MASTERCARD STANDARD PREPAID |
MRH | MASTERCARD UNKNOWN PRODUCT |
MRJ | PREPAID MASTERCARD GOLD CARD |
MRK | PREPAID MASTERCARD PUBLIC SECTOR COMMERCIAL CARD |
MRL | PREPAID MASTERCARD ELECTRONIC COMMERCIAL CARD (NON-US) |
MRO | MASTERCARD REWARDS ONLY |
MRP | STANDARD RETAILER CENTRIC PAYMENTS |
MRW | MASTERCARD CREDIT BUSINESS CARD PREPAID |
MSA | PREPAID MAESTRO PAYROLL CARD |
MSB | MAESTRO SMALL BUSINESS CARD |
MSF | PREPAID MAESTRO GIFT CARD |
MSG | PREPAID MAESTRO CONSUMER RELOADABLE CARD |
MSI | maestro |
MSJ | PREPAID MAESTRO GOLD |
MSM | PREPAID MAESTRO CONSUMER PROMOTION CARD |
MSN | PREPAID MAESTRO INSURANCE CARD |
MSO | PREPAID MAESTRO OTHER CARD |
MSQ | RESERVED FOR FUTURE USE |
MSR | PREPAID MAESTRO TRAVEL CARD |
MST | PREPAID MAESTRO TEEN CARD |
MSV | PREPAID MAESTRO GOVERNMENT BENEFIT CARD |
MSW | PREPAID MAESTRO CORPORATE CARD |
MSX | PREPAID MAESTRO FLEX BENEFIT CARD |
MSY | PREPAID MAESTRO EMPLOYEE INSENTIVE CARD |
MSZ | PREPAID MAESTRO EMERGENCY ASSISTANCE CARD |
MTP | MASTERCARD PLATINUM PREPAID TRAVEL (UK AND BRAZIL) |
MUW | WORLD DOMESTIC AFFLUENT |
MWB | WORLD MASTERCARD FOR BUSINESS |
MWD | WORLD DEFERRED |
MWE | MASTERCARD WORLD ELITE |
MWF | MASTERCARD HUMANITARIAN PREPAID |
MWO | MASTERCARD CORPORATE WORLD |
MWR | WORLD RETAILER CENTRIC PAYMENTS |
OLB | MAESTRO SMALL BUSINESS DELAYED DEBIT |
OLG | MAESTRO GOLD DELAYED DEBIT |
OLP | MAESTRO PLATINUM DELAYED DEBIT |
OLS | MAESTRO-DELAYED DEBIT |
OLW | MAESTRO WORLD DELAYED DEBIT |
PVA | PRIVATE LABEL A |
PVB | PRIVATE LABEL B |
PVC | PRIVATE LABEL C |
PVD | PRIVATE LABEL D |
PVE | PRIVATE LABEL E |
PVF | PRIVATE LABEL F |
PVG | PRIVATE LABEL G |
PVH | PRIVATE LABEL H |
PVI | PRIVATE LABEL I |
PVJ | PRIVATE LABEL J |
PVL | PRIVATE LABEL CARD |
SAG | GOLD MASTERCARD SALARY–IMMEDIATE DEBIT |
SAL | STANDARD MAESTRO SALARY |
SAP | PLATINUM MASTERCARD SALARY–IMMEDIATE DEBIT |
SAP | PLATINUM MASTERCARD SALARY IMMEDIATE DEBIT |
SAS | STANDARD MASTERCARD SALARY–IMMEDIATE DEBIT |
SOS | STANDARD MASTERCARD SOCIAL–IMMEDIATE DEBIT |
SUR | PREPAID MASTERCARD UNEMBOSSED (NON-US) |
SUR | PREPAID UNEMBOSSED MASTERCARD CARD (NON-US) |
TBE | MASTERCARD ELECTRONIC BUSINESS IMMEDIATE DEBIT |
TCB | MASTERCARD BUSINESS CARD-IMMEDIATE DEBIT |
TCC | MASTERCARD MIXED BIN-IMMEDIATE DEBIT |
TCE | MASTERCARD ELECTRONIC IMMEDIATE DEBIT |
TCF | MASTERCARD FLEET CARD IMMEDIATE DEBIT |
TCG | LD MASTERCARD CARD-IMMEDIATE DEBIT |
TCO | MASTERCARD (CORPORATE) IMMEDIATE DEBIT |
TCP | MASTERCARD PURCHASING CARD IMMEDIATE DEBIT |
TCS | MASTERCARD STANDARD CARD-IMMEDIATE DEBIT |
TCW | WORLD SIGNIA MASTERCARD CARD-IMMEDIATE DEBIT |
TEB | MASTERCARD EXECUTIVE BUSINESS CARD IMMEDIATE DEBIT |
TEC | MASTERCARD ELECTRONIC COMMERCIAL IMMEDIATE DEBIT |
TEO | MASTERCARD CORPORATE EXECUTIVE IMMEDIATE DEBITCARD |
TIU | TIU |
TNF | MASTERCARD PUBLIC SECTOR COMMERCIAL CARD IMMEDIATE DE |
TNW | MASTERCARD NEW WORLD-IMMEDIATE DEBIT |
TPB | PREFERRED BUSINESS CARD IMMEDIATE DEBIT |
TPL | PLATINUM MASTERCARD IMMEDIATE DEBIT |
TWB | WORLD MASTERCARD BLACK EDITION IMMEDIATE DEBIT |
WBE | MASTERCARD UNKNOWN PRODUCT |
WDR | WORLD DEBIT MASTERCARD REWARDS |
WMR | WORLD MASTERCARD REWARDS |
CB | Designação |
---|---|
1 | Cartão nacional de débito |
2 | Cartão nacional de débito e de pagamento |
3 | Cartão nacional de pagamento |
4 | Cartão nacional de pagamento e de débito com autorização sistemática |
5 | Cartão nacional de pagamento com autorização sistemática |
Outros códigos produtos | Designação |
---|---|
AX | AMERICAN EXPRESS |
DI | Discover |
DN | Diners |
JC | JCB |
Formato
issuerCode
Caminho: tokens.tokenDetails.issuerCode
Código banco associado ao banco emissor.
Formato
issuerName
Caminho: tokens.tokenDetails.issuerName
Nome do banco associado ao banco emissor.
Formato
expiryMonth
Caminho: tokens.tokenDetails.expiryMonth
Mês de vencimento com 2 dígitos. Exemplo: "09" para setembro.
Formato
expiryYear
Caminho: tokens.tokenDetails.expiryYear
Ano de vencimento com 2 dígitos. Exemplo: "25" para 2025.
Formato
mid
Caminho: tokens.tokenDetails.mid
Número de contrato Estabelecimento Comercial. Se este campo é informado, tomar cuidado em utilizar o contrato certo em relação à rede do cartão.
Um contrato STONE não pode ser usado para uma transação AMEX.
Formato
pan
Caminho: tokens.tokenDetails.pan
Número de cartão truncado.
Formato
paymentSource
Caminho: tokens.tokenDetails.paymentSource
Procedência do pagamento.
Formato
Valores possíveis
Os valores possíveis são os seguintes:
VALOR | Descrição |
---|---|
EC | E-Commerce: os dados do meio de pagamento são digitados pelo comprador. Este valor permite ter uma autenticação alta no pagamento. |
MOTO | MAIL OR TELEPHONE ORDER: Digitação realizada por um operador. Os dados do meio de pagamento são enviados por correio ou por e-mail. Requer um contrato de tipo VAD. |
CC | Call Center: pagamento efetuado via um call center. Requer um contrato de tipo VAD. |
OTHER | Outro canal de venda. Valor de saída retornado para pagamentos feitos desde |
Absent ou null | O valor por default é "EC". |
amount
Caminho: tokens.tokenDetails.authorizationResponse.amount
Valor da autorização.
Formato
currency
Caminho: tokens.tokenDetails.authorizationResponse.currency
Código da moeda usada na solicitação de autorização.
Formato
authorizationDate
Caminho: tokens.tokenDetails.authorizationResponse.authorizationDate
Data e hora da solicitação de autorização.
Formato
authorizationNumber
Caminho: tokens.tokenDetails.authorizationResponse.authorizationNumber
Número da solicitação de autorização.
Formato
authorizationResult
Caminho: tokens.tokenDetails.authorizationResponse.authorizationResult
Código retorno da solicitação de autorização.
Ver Lista dos códigos retorno autorização para maiores detalhes.
Formato
authorizationMode
Caminho: tokens.tokenDetails.authorizationResponse.authorizationMode
Especifica de que maneira é realizada a solicitação de autorização.
Valores possíveis
valores | Descrição |
---|---|
MARK | Uma pré-autorização de um valor nulo ou unitário foi realizada, ver abaixo. |
FULL | Autorização para o valor total solicitada no pedido. |
Quando authorizationMode tem o valor MARK : Uma autorização de 1 EUR (ou solicitação de informações na rede CB se for compatível com o adquirente) foi realizada para verificar a validade do cartão. Isso acontece quando a data de captura ultrapassa o período de validade de uma autorização (7 dias para VISA / Mastercard / CB / AMEX na França por exemplo).
Formato
id
Caminho: tokens.tokenDetails.authenticationResponse.id
token único de autenticação, no formato UUID.
Formato
operationSessionId
Caminho: tokens.tokenDetails.authenticationResponse.operationSessionId
Código único da sessão de autenticação.
Formato
instructionType
Caminho: tokens.tokenDetails.authenticationResponse.value.instructionType
Tipo da instrução para ser realizada.
Formato
Valores possíveis
valores | Descrição |
---|---|
FORM | Instrução de tipo redirecionamento por formulário |
name
Caminho: tokens.tokenDetails.authenticationResponse.value.name
Nome da instrução
Valores possíveis
VALOR | Descrição |
---|---|
CHALLENGE | Instrução Challenge, que permite a autenticação interativa do usuário com o ACS |
FINGERPRINT | Instrução Fingerprint, que permite identificar o usuário com o ACS |
Formato
_type
Caminho: tokens.tokenDetails.authenticationResponse.value._type
Tipo de resposta recebida. A interpretação do restante da resposta depende deste atributo.
Valores possíveis
VALOR | Descrição |
---|---|
AuthenticationInstruction | Resposta de tipo Instrução |
AuthenticationResult | Resposta de tipo Resultado final |
Formato
timeout
Caminho: tokens.tokenDetails.authenticationResponse.value.timeout
Prazo máximo de espera da resposta para a execução de uma instrução, apresentado em segundos. Após este prazo, será preciso acionar o retorno para o servidor da plataforma de pagamento para obter o resultado final.
Formato
method
Caminho: tokens.tokenDetails.authenticationResponse.value.http.method
Método (verbo) usado para a solicitação.
Valores possíveis
VALOR | Descrição |
---|---|
DELETE | Método Delete |
GET | Método Get |
PATCH | Método Patch |
POST | Método Post |
PUT | Método Put |
Formato
url
Caminho: tokens.tokenDetails.authenticationResponse.value.http.url
Url para qual apresentar o formulário http.
Formato
body
Caminho: tokens.tokenDetails.authenticationResponse.value.http.body
Lista dos parâmetros do corpo da solicitação, sob a forma “nome”: “valor”.
Formato
headers
Caminho: tokens.tokenDetails.authenticationResponse.value.http.headers
Lista dos cabeçalhos da solicitação http, sob a forma de “nome”: “valor”
Formato
element
Caminho: tokens.tokenDetails.authenticationResponse.value.target.element
Tipo de elemento alvo html no qual deverá ser materializado a instrução.
Valores possíveis
VALOR | Descrição |
---|---|
IFRAME | iFrame |
Formato
height
Caminho: tokens.tokenDetails.authenticationResponse.value.target.height
Altura do alvo html em pixeis.
Formato
visible
Caminho: tokens.tokenDetails.authenticationResponse.value.target.visible
Boolean que indica se o alvo html deve ser visível ou não.
Formato
width
Caminho: tokens.tokenDetails.authenticationResponse.value.target.width
Largura do alvo html em pixeis.
Formato
showUrl
Caminho: tokens.tokenDetails.authenticationResponse.value.target.showUrl
Campo técnico de uso interno, que permite exibir ou ocultar a URL do ACS.
Formato
challengePreference
Caminho: tokens.tokenDetails.authenticationResponse.protocol.challengePreference
Indica se o EC solicita um challenge ou não.
Valores possíveis
valores | Descrição |
---|---|
NO_PREFERENCE | Sem referência particular |
NO_CHALLENGE_REQUESTED | O challenge não foi explicitamente solicitado |
CHALLENGE_REQUESTED | O challenge é solicitado pelo Estabelecimento Comercial |
Formato
name
Caminho: tokens.tokenDetails.authenticationResponse.protocol.name
Nome do protocolo de autenticação do portador do cartão.
Valores possíveis
VALOR | Descrição |
---|---|
THREEDS | Protocolo 3D Secure |
Formato
simulation
Caminho: tokens.tokenDetails.authenticationResponse.protocol.simulation
Booleano que indica se a autenticação deve ser realizada em modo simulação. Se você valorizar este campo obrigatório como:
true
, você ativa o modo simulação.false
, você não ativa o modo simulação.
Este modo permite realizar a integração EC sem estar em produção ou usando cartões reais.
Formato
network
Caminho: tokens.tokenDetails.authenticationResponse.protocol.network
Rede na qual o cartão foi autenticado.
Redes atualmente suportadas
VALOR |
---|
CB |
VISA |
MASTERCARD |
AMEX_SAFEKEY |
PROTECTBUY |
Formato
version
Caminho: tokens.tokenDetails.authenticationResponse.protocol.version
Versão do protocolo de autenticação do portador do cartão.
Versões suportadas atualmente
VALOR | Descrição |
---|---|
1.0.2 | Versão 1.0.2 |
2.1.0 | Versão 2.1.0 |
2.2.0 | Versão 2.2.0 |
Formato
authenticationType
Caminho: tokens.tokenDetails.authenticationResponse.value.authenticationType
O tipo de autenticação que ocorreu.
Valores possíveis
VALOR | Descrição |
---|---|
FRICTIONLESS | Autenticação em modo Frictionless, ou seja de forma transparente pelo cliente |
CHALLENGE | Autenticação com Challenge, o cliente teve que autenticar-se explicitamente com o ACS |
DATA_ONLY | Autenticação assumida pelo DS sem interação do cliente |
Formato
commerceIndicator
Caminho: tokens.tokenDetails.authenticationResponse.value.commerceIndicator
O Commerce Indicator, chamado ECI (Electronic Commerce Indicator) para o protocolo 3DS. Indicador retornado pelo ACS para apresentar os resultados da tentativa de autenticação do portador do cartão.
No caso de uma autenticação sem pagamento (caso do registro de um cartão), a Mastercard pode retornar os dois valores seguintes:
VALOR | Descrição |
---|---|
N0 | Not authenticated |
N2 | Authenticated |
Formato
status
Caminho: tokens.tokenDetails.authenticationResponse.value.status
O status de autenticação, ou seja o resultado positivo/negativo da autenticação.
Valores possíveis
VALOR | Descrição |
---|---|
ATTEMPT | Prova de tentativa de autenticação quando a autenticação não está disponível |
ENROLLED_UNAVAILABLE | Não foi possível obter o status de inscrição |
FAILED | Autenticação errada |
NOT_ENROLLED | Cartão não inscrito |
SUCCESS | Autenticação sucedida |
UNAVAILABLE | A autenticação não pôde acabar (erro técnico, etc...) |
DISABLED | Modo seletivo da autenticação solicitada |
REJECTED | Autenticação recusada pela ACS |
Formato
authenticationIdType
Caminho: tokens.tokenDetails.authenticationResponse.value.authenticationId.authenticationIdType
O tipo de autenticação que ocorreu.
Valores possíveis
VALOR | Descrição |
---|---|
dsTransId | O campo é procedente do campo dsTransId do protocolo 3DS V2 |
Formato
value
Caminho: tokens.tokenDetails.authenticationResponse.value.authenticationId.value
Valor do código da transação de autenticação conhecido pela rede bancária.
O comprimento do campo varia dependendo do protocolo de autenticação.
PROTOCOLO | Formato / Comprimento | valor Exemplo: |
---|---|---|
3DS v2 (dsTransId) | cadeia / 32 caracteres alfanuméricos + 4 travessões | 4317fdc3-ad24-5443-8000-000000000891 |
Formato
authenticationValueType
Caminho: tokens.tokenDetails.authenticationResponse.value.authenticationValue.authenticationValueType
Tipo do valor de autenticação.
Valores possíveis
VALOR | Descrição |
---|---|
AEVV | American Express Verification Value (usado pela Amex) |
CAVV | Cardholder Authentication Verification Value (usado pela VISA) |
AAV | Accountholder Authentication Value (usado pela Mastercard) |
Formato
value
Caminho: tokens.tokenDetails.authenticationResponse.value.authenticationValue.value
Valor de autenticação final (em função do DS este valor pode se chamar CAVV, AEVV ou AAV). Uma cadeia de caracteres codificados com base64 de 28 caracteres de comprimento.
Formato
authenticationType
Caminho: tokens.tokenDetails.authenticationResponse.value.extension.authenticationType
Tipo da extensão de resultado.
Formato
Valores possíveis
valores | Descrição |
---|---|
THREEDS_V2 | Extensão para as autenticações 3DS Secure v2 |
acsTransId
Caminho: tokens.tokenDetails.authenticationResponse.value.extension.acsTransId
Identifiant de transaction de l'ACS. Ce champ concerne uniquement le réseau CB. Voir : Guide d'intégration
Formato
cbScore
Caminho: tokens.tokenDetails.authenticationResponse.value.extension.cbScore
Score CB como definido na extensão CB da mensagem ARES.
Formato
algorithm
Caminho: tokens.tokenDetails.authenticationResponse.value.extension.algorithm
Código do algoritmo usado para gerar o Valor de Autenticação (usado durante a autorização)
Valores possíveis
VALOR | Descrição |
---|---|
0 | HMAC |
1 | CVV |
2 | CVV com ATN |
3 | MasterCard SPA |
Formato
code
Caminho: tokens.tokenDetails.authenticationResponse.value.reason.code
Código adicional informativo sobre a origem do resultado. Ex: DS_TIMEOUT.
Formato
message
Caminho: tokens.tokenDetails.authenticationResponse.value.reason.message
Mensagem adicional informativa sobre a origem do resultado.