> ## Documentation Index
> Fetch the complete documentation index at: https://nexus-docs.ticto.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Processar checkout (venda)

> Gera uma transação financeira na Ticto.

**Rota:** `POST /api/v1/financial/checkout` · **Headers:** `X-Api-Client-Token`

## Parâmetros obrigatórios (body)

<ParamField body="offer_code" type="string" required>
  Código da oferta criada.
</ParamField>

<ParamField body="payment_method" type="string" required>
  `credit_card`, `pix` ou `bank_slip`.
</ParamField>

<ParamField body="installments" type="integer" required>
  De 1 a 12.
</ParamField>

<ParamField body="customer" type="object">
  Objeto contendo `name`, `email` e `document`. Obrigatório caso não envie `customer_code`.
</ParamField>

<ParamField body="card_code" type="string">
  Código do cartão tokenizado pelo Icarus. Obrigatório caso `payment_method` seja `credit_card`. Veja [Tokenizar cartão](/guia/tokenizacao-cartao).
</ParamField>

<ParamField body="card_token" type="string">
  Alternativa legada ao `card_code` (JSON em base64 com tokens PagSeguro e MercadoPago). Novas integrações devem usar `card_code`.
</ParamField>

<Warning>
  A API **não aceita o número bruto do cartão**. Gere o `card_code` no browser do comprador com o [Icarus](/guia/tokenizacao-cartao). Para testar a primeira venda sem cartão, use `payment_method: pix` ou `bank_slip`.
</Warning>

## Exemplo

```bash cURL theme={null}
curl -X POST https://nexus-sandbox.ticto.dev/api/v1/financial/checkout \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-Api-Client-Token: <seu_client_auth_token>" \
  -d '{
    "offer_code": "<offer_code>",
    "payment_method": "credit_card",
    "installments": 1,
    "customer": {
      "name": "Cliente Teste",
      "email": "cliente@exemplo.com.br",
      "document": "<cpf_ou_cnpj_valido>"
    },
    "card_code": "<card_code gerado pelo Icarus>"
  }'
```

## Response de sucesso (200 OK)

```json theme={null}
{
  "data": {
    "transaction_id": "TCDV07C0E01011I3L68RB9",
    "status": "approved",
    "amount": 50000
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.