Processar checkout (venda)

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

Parâmetros obrigatórios (body)

string

required

Código da oferta criada.

string

required

credit_card, pix ou bank_slip.

integer

required

De 1 a 12.

object

Objeto contendo name, email e document. Obrigatório caso não envie customer_code.

string

Código do cartão tokenizado pelo Icarus. Obrigatório caso payment_method seja credit_card. Veja Tokenizar cartão.

string

Alternativa legada ao card_code (JSON em base64 com tokens PagSeguro e MercadoPago). Novas integrações devem usar card_code.

A API não aceita o número bruto do cartão. Gere o card_code no browser do comprador com o Icarus. Para testar a primeira venda sem cartão, use payment_method: pix ou bank_slip.

Exemplo

cURL

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)

{
  "data": {
    "transaction_id": "TCDV07C0E01011I3L68RB9",
    "status": "approved",
    "amount": 50000
  }
}

Kickoff técnico

Primeira venda

Integração avançada

Regras

Processar checkout (venda)

Parâmetros obrigatórios (body)

Exemplo

Response de sucesso (200 OK)

​Parâmetros obrigatórios (body)

​Exemplo

​Response de sucesso (200 OK)

Parâmetros obrigatórios (body)

Exemplo

Response de sucesso (200 OK)