Opções e dados do cartão
Campos do cartão, parcelamento, 3DS, débito, moeda, descritor de fatura e categoria de atividade (MCC).
Campos do cartão
| Campo | Contrato |
|---|---|
card.number | Número do cartão, texto de 13 a 19 dígitos, com dígito verificador válido (Luhn). |
card.expMonth, card.expYear | Mês de 1 a 12 e ano com quatro dígitos. A validade precisa estar vigente. |
card.cvc | Obrigatório com cartão digitado: 3 ou 4 dígitos. Com token, não envie. Na tokenização, o campo se chama cvv. |
card.holderName | Nome do titular, como impresso no cartão. |
card.token | Token ctok_… no lugar dos dados do cartão. Se vier junto com os dados, o token vence. |
Opções de crédito
Em paymentMethodOptions.creditCard:
| Campo | Contrato |
|---|---|
installments | Número de parcelas, de 1 a 24. Padrão: 1. Sujeito às condições da conta, da bandeira e da moeda. |
threeDSecure | automatic (padrão): o emissor decide se pede desafio. required: pede autenticação sempre. Em ambos, a integração precisa suportar RequiresAction. |
threeDs.sessionToken | O session_token da sessão 3DS aberta para esta tentativa. |
mccs | Quando orientado no credenciamento: de 1 a 3 códigos de categoria de atividade, texto de quatro dígitos, como ["7372"]. 0000 não é válido. |
Na raiz da cobrança, statementDescriptor é uma identificação curta para a fatura do comprador, de até 22 caracteres. A fatura pode mostrar o nome cadastrado do estabelecimento, conforme o processamento.
Débito
Use type: "DebitCard". Débito é sempre à vista. As opções do método ficam em paymentMethodOptions.debitCard.
Valor e parcelas
Em crédito, amount é o total da venda, mesmo parcelado: R$ 100,00 em três parcelas continua "amount": 10000. Quando o total não é divisível, o ajuste de centavos fica na primeira parcela.
O valor mínimo de cartão é 50 unidades da menor unidade da moeda (R$ 0,50 em BRL).
Moeda
Cartões aceitam BRL e, conforme a habilitação da conta, USD. A moeda não define o escopo da conta: uma conta Domestic cobrando em USD continua abrindo a sessão 3DS como Domestic.
Crie a cobrança com cartão
Envie a cobrança de crédito com o cartão, a sessão 3DS, o comprador e o split, e trate os quatro desfechos possíveis.
Exiba o desafio 3DS
Abra o desafio em um iframe quando a cobrança voltar RequiresAction, receba as mensagens do navegador e confirme o resultado pelo servidor.