cardRequest

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

Dependendo do tipo de pagamento (pagamento por Token Cartão ou pagamento com digitação dos dados bancários), um ou mais atributos são requisitados.

  • Pagamento com digitação dos dados bancários:
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

Tipo de cartão escolhido pelo comprador.

Exemplo de valores possíveis: AMEX, MASTERCARD, VISA, VISA_ELECTRON, VPAY, MAESTRO,JCB.

Para maiores detalhes, consulte Lista dos tipos de cartão suportados.

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
cardHolderName

Sobrenome do portador.

Este campo corresponde ao sobrenome do portador do cartão.

Obrigatório para DECIDIR e VISANET, adquirentes da América do Sul.

Requerido em função do meio de pagamento string
proofOfIdType

Tipo de documento de identidade.

Valores possíveis:

  • DNI (= Documento Nacional de Identidad) Obrigatório para DECIDIR.
Requerido em função do meio de pagamento string
proofOfIdNumber

Número de documento de identidade oficial.

Corresponde ao número de documento de identidade selecionado. Exemplo:2AZ265480.

O formato depende do tipo de documento de identidade e é de 7 a 13 dígitos, números, letras e/ou pontos.

Obrigatório para DECIDIR.

Requerido em função do meio de pagamento ano..13
walletPayload

Permite enviar um payload cifrado durante um pagamento por wallet (ApplePay, GooglePay, etc...).

Requer a contratação do serviço "Envio dos dados de pagamento cifrados por Web Services SOAP".

  json
  • Pagamento usando um Token Cartão existente:
Atributo Requisito Formato
paymentToken

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

  • Ou este código foi gerado pela plataforma.
  • Ou este código foi gerado pelo site de e-commerce.

Requer a contratação do serviço “Pagamento por Token Cartão".

string ans..64
cardSecurityCode

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

Para garantir o pagamento, o Estabelecimento comercial deve pedir ao comprador:

  • digitar o CVV
  • uma autenticação 3D Secure
  string ans..64

Observação:

Para garantir um pagamento usando um Token cartão existente (pagamento em um clique), o Estabelecimento comercial deve pedir ao comprador:
  • digitar o CVV
  • uma autenticação 3D Secure