# Cartão de Crédito (/docs/cartao)



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 com Cybersource, recorrência e estorno.

<Mermaid
  chart="`
flowchart LR
  Sua[&#x22;Sua aplicação&#x22;] <--> API[&#x22;API PayZu Cartão&#x22;]
  API --> CH[&#x22;Cobranças&#x22;]
  API --> TDS[&#x22;3D Secure&#x22;]
  API --> AF[&#x22;Antifraude&#x22;]
  API --> REC[&#x22;Recorrência&#x22;]
  API --> WH[&#x22;Webhooks&#x22;]

  click CH &#x22;/docs/cartao/endpoints/charges/post_charges&#x22; &#x22;POST /charges&#x22;
  click TDS &#x22;/docs/cartao/three-d-secure&#x22; &#x22;3D Secure&#x22;
  click AF &#x22;/docs/cartao/antifraud&#x22; &#x22;Antifraude&#x22;
  click REC &#x22;/docs/cartao/recurrence&#x22; &#x22;Recorrência&#x22;
  click WH &#x22;/docs/cartao/webhooks&#x22; &#x22;Webhooks&#x22;

  style API fill:#14ce71,stroke:#0eb464,color:#ffffff
`"
/>

## Por onde começar [#por-onde-começar]

<Cards>
  <Card title="Primeiros passos" href="/docs/cartao/getting-started" description="Do certificado mTLS à primeira cobrança aprovada no sandbox." />

  <Card title="Endpoints" href="/docs/cartao/endpoints" description="Referência completa de token, cobranças e recorrências." />

  <Card title="3D Secure" href="/docs/cartao/three-d-secure" description="Autenticação do comprador junto ao banco emissor." />

  <Card title="Antifraude" href="/docs/cartao/antifraud" description="Análise de risco com o motor Cybersource integrado à API." />

  <Card title="Recorrência" href="/docs/cartao/recurrence" description="Cobranças recorrentes gerenciadas pela própria API." />

  <Card title="Webhooks" href="/docs/cartao/webhooks" description="Notificações de status da cobrança via postbackUrl." />

  <Card title="Status e motivos" href="/docs/cartao/transaction-status" description="Status da transação, motivos e códigos de retorno." />

  <Card title="Cartões de teste" href="/docs/cartao/test-cards" description="Números de cartão para simular transações no sandbox." />
</Cards>

## Ambientes [#ambientes]

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

<Callout type="info">
  A autenticação combina &#x2A;*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`](/docs/cartao/endpoints/token/post_token). Esse mecanismo garante a identidade do cliente e a segurança da comunicação. Veja o passo a passo em [Autenticação](/docs/cartao/authentication).
</Callout>

<Callout type="warn">
  Todos os valores monetários da API (`amount`, `unitPrice`) são expressos em **centavos**.
</Callout>

## Outros produtos PayZu [#outros-produtos-payzu]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento" title="Pix Processamento" />

  <QuickLink href="/docs" title="Todos os produtos" />
</QuickLinks>

## Suporte [#suporte]

Encontrou um problema ou ficou com dúvida na integração? Escreva para [integracao@payzu.com.br](mailto:integracao@payzu.com.br).