Como funcionam os cartões

Os cartões são uma das formas de pagamento online mais populares, com amplo alcance global. Existem diversos tipos de cartões, e o processo tem várias etapas. Para criar uma integração da Stripe que funcione para todos os seus clientes, entenda os bastidores de um pagamento com cartão.

Verificação dos dados do cartão

A Stripe verifica se os dados fornecidos estão formatados corretamente (por exemplo: a data de validade não pode ser no passado). A validade do cartão em si ainda não está garantida.

Autenticação do cliente

Alguns bancos, principalmente em regiões muito regulamentadas como Europa e Índia, podem solicitar que o cliente autentique uma compra (por exemplo, enviando ao cliente um código por SMS para inserir no site do banco). Veja nosso vídeo para saber mais.

Autorização

O banco verifica se há fundos suficientes e, se tudo estiver correto, reserva o valor na conta do cliente para garantir o pagamento ao usuário da Stripe.

Capturar

O dinheiro passa do banco emissor para a conta do usuário da Stripe.

Atualizações de cartão

A atualização de um cartão salvo só pode alterar o nome, endereço de cobrança, data de validade ou metadados. Para fazer qualquer outra alteração, exclua o cartão e crie outro.

Para permitir que os clientes gerenciem as próprias formas de pagamento, implemente processos que permitam a eles atualizar e substituir manualmente os cartões salvos.

Para alterar a forma de pagamento padrão do cliente para faturas e assinaturas, faça uma chamada da API para atualizar o cliente e informe um novo valor para a propriedade invoice_settings.default_payment_method.

curl https://api.stripe.com/v1/customers/cus_V9T7vofUbZMqpv \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[default_payment_method]"=pm_1Msy7wLkdIwHu7ixsxmFvcz7

Para obter informações sobre como o Checkout processa formas de pagamento salvas, consulte a referência da API create session. Para considerar formas de pagamento padrão em outros cenários, use um código personalizado.

Atualizações automáticas de cartão

Os dados de uma forma de pagamento salva podem continuar funcionando mesmo que o banco emissor substitua o cartão físico. A Stripe trabalha com bandeiras de cartão e tenta atualizar automaticamente os dados de cartões salvos sempre que um cliente recebe um novo cartão (por exemplo, substituindo um cartão vencido ou que foi declarado como perdido ou roubado). Isso permite que seus clientes continuem usando seu serviço sem interrupção, reduzindo a necessidade de coletar novos dados de cartão sempre que um cartão é substituído.

As atualizações automáticas de cartão exigem que emissores de cartão interajam com a rede e forneçam essas informações. Esse recurso tem amplo suporte nos Estados Unidos, permitindo que a Stripe atualizem automaticamente a maioria dos cartões American Express, Visa, Mastercard e Discover emitidos no país. O suporte internacional varia conforme o país. Não é possível identificar cartões que aceitam atualizações automáticas.

Você pode escutar os webhooks da Stripe para saber mais sobre a atividade de atualização de cartões:

• O evento payment_method.updated notifica você sobre atualizações em um cartão por meio de uma chamada da API.
• O evento payment_method.automatically_updated notifica você sobre atualizações automáticas de cartão pela rede.

Esses eventos incluem a nova data de validade do cartão e os quatro últimos dígitos, para que você possa atualizar seus próprios registros conforme a necessidade. Se a atualização do cartão incluir um novo número de cartão, a impressão digital será alterada.