# Cobranças (/docs/cartao/endpoints/charges)



Cobranças são o núcleo da API de Cartão. Você cria a cobrança com os dados do cartão, acompanha o status e, se precisar, estorna o valor total ou parcial.

<QuickLinks>
  <QuickLink href="/docs/cartao/endpoints/charges/post_charges" title="Criar Cobrança" method="POST" path="/charges" />

  <QuickLink href="/docs/cartao/endpoints/charges/get_charges" title="Listar Cobranças" method="GET" path="/charges" />

  <QuickLink href="/docs/cartao/endpoints/charges/get_charges__chargeId_" title="Consultar Cobrança" method="GET" path="/charges/{chargeId}" />

  <QuickLink href="/docs/cartao/endpoints/charges/put_charges__chargeId__reverse" title="Estornar Cobrança" method="PUT" path="/charges/{chargeId}/reverse" />
</QuickLinks>

## Quando usar cada um [#quando-usar-cada-um]

| Pergunta                                                   | Endpoint                                                                                           |
| ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Quero cobrar o cartão de um cliente                        | [`POST /charges`](/docs/cartao/endpoints/charges/post_charges)                                     |
| Preciso de uma lista de cobranças, com filtros e paginação | [`GET /charges`](/docs/cartao/endpoints/charges/get_charges)                                       |
| Qual o estado atual de uma cobrança específica?            | [`GET /charges/{chargeId}`](/docs/cartao/endpoints/charges/get_charges__chargeId_)                 |
| Preciso devolver o dinheiro, total ou parcialmente         | [`PUT /charges/{chargeId}/reverse`](/docs/cartao/endpoints/charges/put_charges__chargeId__reverse) |

<Callout type="warn">
  O campo `amount` é sempre em centavos: `10000` significa R$ 100,00. Isso vale também para o parâmetro `amount` do estorno parcial.
</Callout>

## Exemplo [#exemplo]

<Accordions type="single">
  <Accordion title="POST /charges, cobrança simples">
    O exemplo usa o sandbox e o cartão de teste `4111111111111111`; veja [Cartões de teste](/docs/cartao/test-cards).

    ```bash
    curl -X POST https://api.sandbox.payzu.io/v1/charges \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      --cert cliente.crt \
      --key cliente.key \
      --cacert ca.pem \
      -d '{
        "amount": 10000,
        "paymentType": "creditcard",
        "externalId": "pedido-1234",
        "postbackUrl": "https://seusite.com.br/webhooks/payzu",
        "customer": {
          "name": "Maria Souza",
          "identity": "11144477735",
          "identityType": "CPF",
          "email": "maria.souza@example.com",
          "phone": "11999998888"
        },
        "cart": [
          {
            "name": "Plano Pro",
            "quantity": 1,
            "sku": "PRO",
            "unitPrice": 10000
          }
        ],
        "creditCardPayment": {
          "installments": 1,
          "authenticate": false,
          "card": {
            "number": "4111111111111111",
            "holder": "MARIA SOUZA",
            "expiration": "12/2030",
            "cvv": "123"
          }
        }
      }'
    ```
  </Accordion>
</Accordions>

## Recursos da cobrança [#recursos-da-cobrança]

O `POST /charges` também aceita variações do fluxo básico:

<QuickLinks>
  <QuickLink href="/docs/cartao/three-d-secure" title="Autenticação 3DS" />

  <QuickLink href="/docs/cartao/antifraud" title="Antifraude" />

  <QuickLink href="/docs/cartao/international" title="Cobrança internacional" />

  <QuickLink href="/docs/cartao/webhooks" title="Webhooks" />
</QuickLinks>
