cardRequest

O objeto cardRequest permite transmitir informações sobre o cartão de pagamento.

Para criar um Token Cartão, diferentes atributos são requisitados:

Atributo Requisito Formato
number

Número do cartão.

requer a contratação do serviço “Acesso à aquisição em site de e-commerce via Web Services”

string
scheme

Tipos de cartões.

Os valores possíveis sãoAMEX, CB, MASTERCARD, VISA, VISA_ELECTRON, VPAY, MAESTRO, E-CARTEBLEUE ou JCB.

string
expiryMonth

Mês de vencimento do cartão, entre 1 e 12.

n..2
expiryYear

Ano de vencimento do cartão de 4 dígitos.

Exemplo: 2016

n4
cardSecurityCode

CVV de 3 números (ou 4 para Amex).

Este campo é obrigatório quando o cartão possui um código CVV. Se o CVV não for enviado, o banco emissor recusará o pagamento.

Porém, este campo é facultativo quando a origem da transação tiver o valor MOTO.

  string
cardHolderBirthday

Data de nascimento do portador no formato YYYY-MM-DD.

Requerido em função do meio de pagamento dateTime ans..64
paymentToken

Código único (Token Cartão) associado a um meio de pagamento.

  • Ou este código será gerado pela plataforma.

    Neste caso, este parâmetro não deve ser informado.

  • Ou este código será gerado pelo site de e-commerce.

    Neste caso, este parâmetro deve ser informado com o valor do código desejado. Cuidado, cabe ao site de e-commerce garantir o caráter único dos códigos de usuários. Toda solicitação de registro contendo um código de usuário já existente será recusada e será exibido uma mensagem de erro.

Requer a contratação do serviço “Gerenciamento dos Token Cartões por Web Services”

  string ans..64