Criar pagamento com cartão de débito

ℹ️

Saiba mais sobre essa funcionalidade na documentação.

---

⚠️

A bandeira Hipercard foi descontinuada em 30/06/2025

⚠️

Identificação de transações oriundas de link de pagamento para cartões da bandeira Elo

A partir de 17 de outubro de 2025 será obrigatório identificar transações oriundas de link de pagamento para cartões da bandeira Elo. Envie o parâmetro Payment.SolutionType = "ExternalLinkPay".

Atenção

• Transações de débito Mastercard com credenciais armazenadas: a bandeira Mastercard exige o envio do Indicador de Início da Transação para compras de cartão de crédito e débito que usam os dados armazenados de um cartão. O objetivo é indicar se a transação foi iniciada pelo comprador (Cardholder-Initiated Transaction - CIT) ou pela loja (Merchant-Initiated Transaction - MIT). Nesse cenário é obrigatório o envio do nó InitiatedTransactionIndicator com os parâmetros Category e SubCategory para transações Mastercard, dentro do nó Payment. Confira a lista de categorias na descrição do parâmetro Category e a tabela completa de subcategorias em Indicador de início da transação Mastercard;
• Não é possível realizar uma transação com valor (Amount) = 0. Para verificar a validade de um cartão, use o Zero Auth.

Autenticação 3DS nas transações de cartão de débito

• A autenticação 3DS é obrigatória para as transações de débito. Na transação de débito padrão (com autenticação), envie Authenticate = "true";
• Informe os dados recebidos na saída do script no nó Payment.ExternalAuthentication;
• Em transações com autenticação 3DS Data Only, é necessário informar o parâmetro ExternalAuthentication.DataOnly como true;
• Para validar se a autenticação foi acatada na resposta da autorização, considere o ECI fora do nó Payment.ExternalAuthentication.

---

Resposta da transação de cartão de débito

A tabela a seguir apresenta os principais parâmetros que podem ser retornados pela API na criação de um pagamento com cartão de débito.