Endpoints da API
Todas as rotas da API de cartão, do token ao estorno.
Fluxo típico de integração
Você obtém um token, cria a cobrança, recebe o webhook com o resultado, consulta o estado quando precisar e estorna se for o caso.
Token
Autenticação da API: troque client_id e client_secret por um token JWT.
Cobranças
Criação, consulta e estorno de cobranças com cartão de crédito.
POSTCriar cobrança/chargesGETListar cobranças/chargesGETConsultar cobrança/charges/{chargeId}PUTEstornar cobrança/charges/{chargeId}/reverse
Recorrências
Gestão de assinaturas criadas com o nó recurrence no POST /charges.
GETConsultar recorrência/charges/recurrences/{recurrentPaymentId}PUTAlterar valor da recorrência/charges/recurrences/{recurrentPaymentId}/amountPUTDesativar recorrência/charges/recurrences/{recurrentPaymentId}/deactivatePUTReativar recorrência/charges/recurrences/{recurrentPaymentId}/reactivate
Câmbio
Cotações de referência e conversão para cobrança internacional.
GETCotação de moeda/currencies/{code}/rateGETConverter valor/currencies/{code}/convertGETListar cotações/currencies/rates
Convenções
| Item | Valor |
|---|---|
| Base URL (produção) | https://api.payzu.io/v1 |
| Base URL (sandbox) | https://api.sandbox.payzu.io/v1 |
| Autenticação | mTLS (certificado de cliente) + Authorization: Bearer SEU_TOKEN, obtido no POST /token. Veja Autenticação |
| Content-Type | application/json |
| Valores | Em centavos (10000 = R$ 100,00). Cotações de câmbio (rate.bid, rate.ask) são decimais |