Pular para o conteúdo principal
O elemento payment mostra só os meios de pagamento: a escolha entre Pix e cartão e os campos do cartão. O resto da tela é seu: o formulário do comprador, o resumo do pedido e o botão de pagar. Quando o comprador confirma, a sua página chama payment.confirm({ customer }) e o elemento cobra no método escolhido.
Página de loja com o formulário do comprador e, abaixo, o elemento payment com a escolha entre Pix e cartão.
Antes, confira os requisitos. As opções de createElements e os métodos mount, on, unmount e destroy são os mesmos do elemento checkout.

Código

O exemplo monta o elemento e traduz o resultado do confirm() em quatro situações para a sua interface: Pix gerado, pagamento aprovado, nova tentativa ou conferência no servidor.
elements-payment.ts
Formulário
Uso
Habilite o botão pelo evento change: no Pix ele chega sempre com complete: true; no cartão, complete fica true quando número, validade e CVV estão preenchidos de forma válida.

confirm({ customer, timeoutMs })

O elemento valida o comprador com as mesmas regras do checkout hospedado. Dado inválido volta como invalid_customer; cartão incompleto, como invalid_card. Um campo que não seja texto rejeita na hora. Regras do confirm():
  • Antes do ready, ele espera o elemento ficar pronto e é enviado em seguida.
  • Um por vez. Outro confirm() com um em andamento rejeita na hora com confirm_in_progress.
  • Resolve com { type: "pix_created", ... } ou { type: "completed", ... }.
  • Rejeita com SinnuElementsError (code, message, retryable) quando a cobrança falha.
  • No timeout, a cobrança pode ter acontecido mesmo assim. Consulte a transação no seu servidor antes de tentar de novo. O mesmo vale para unmounted e destroyed, quando o elemento sai da página com um confirm() pendente.

Pix

confirm() resolve assim que o QR Code é gerado, com type: "pix_created", transactionId, amountCents (centavos), expiresAt (ISO 8601) e qrCode (o copia e cola). O QR Code, o botão de copiar e a contagem até o vencimento já aparecem dentro do elemento: você não precisa desenhá-los.
Elemento payment depois do confirm(): Pix gerado com QR Code e contagem até o vencimento.
Depois disso, o desfecho chega por evento:
  • completed, quando o pagamento é confirmado;
  • expired, quando o Pix vence sem pagamento. O elemento volta para a escolha do método e um novo confirm() gera outro Pix.
Enquanto o QR Code está na tela, um novo confirm() responde failed com unknown e retryable: true. Esconda o seu botão de pagar até completed ou expired.

Cartão

confirm() resolve com type: "completed" quando o cartão é aprovado. Se o emissor recusar a primeira tentativa e a autenticação do banco (3DS) estiver disponível, o desafio abre dentro do elemento e a promessa espera por ele. Veja como o 3DS entra. Parcelas e juros seguem o link.
Elemento payment com o cartão escolhido: número, validade, CVV e parcelas.

Cartão preenchido

Desafio de autenticação do banco aberto dentro do elemento payment, sem sair da página da loja.

Desafio do banco (3DS) dentro do elemento

Elemento payment com o pagamento aprovado e a confirmação na página da loja.

Aprovado

Trate o failed

Decida pelo retryable recebido, e não só pelo código:
  • retryable: true: mostre message e deixe o comprador tentar de novo. A mensagem já vem em pt-BR, pronta para o comprador.
  • retryable: false com unknown, timeout, unmounted ou destroyed: o desfecho é incerto. Consulte a transação antes de oferecer outra cobrança.
  • retryable: false com outro código, como link_unavailable: não ofereça nova tentativa.
A lista completa está em eventos e erros.

O que o elemento payment não mostra

Resumo do produto, campos do comprador, endereço e botão de pagar ficam de fora. Se o link pede o endereço do comprador, use o elemento checkout: o confirm() envia só nome, e-mail, documento e telefone.
completed e a promessa do confirm() rodam no navegador do comprador. Libere o pedido pelo webhook transaction.approved ou consultando a transação no seu servidor. Veja segurança.