Cartões

Integração de cobrança no cartão: autorização, captura, parcelamento, 3D Secure, antifraude, recorrência e estorno.

A API de Cartão de Crédito é a API que você usa para cobrar com cartão no seu e-commerce, aplicativo ou plataforma. Uma única integração cobre o ciclo inteiro da cobrança: autorização e captura em tempo real, parcelamento, autenticação 3D Secure, análise de risco no motor antifraude da PayZu, recorrência e estorno.

Por onde começar

Primeiros passos

Do certificado mTLS à primeira cobrança aprovada no sandbox.

Endpoints

Referência completa de token, cobranças e recorrências.

3D Secure

Autenticação do comprador junto ao banco emissor.

Antifraude

Análise de risco no motor antifraude da PayZu, integrado à API.

Recorrência

Cobranças recorrentes gerenciadas pela própria API.

Webhooks

Notificações de status da cobrança via postbackUrl.

Status e motivos

Status da transação, motivos e códigos de retorno.

Cartões de teste

Números de cartão para simular transações no sandbox.

Ambientes

Ambiente	Base URL
Produção	`https://api.payzu.io/v1`
Sandbox	`https://api.sandbox.payzu.io/v1`

A autenticação combina mTLS (Mutual TLS) com um token Bearer: o certificado de cliente fornecido pela PayZu acompanha todas as chamadas e o token é obtido em POST /token. Esse mecanismo garante a identidade do cliente e a segurança da comunicação. Veja o passo a passo em Autenticação.

Todos os valores monetários da API (amount, unitPrice) são expressos em centavos. As cotações de câmbio (rate.bid, rate.ask) são a exceção: são números decimais.