Skip to main content
Endpoint público para registrar eventos de telemetria durante o fluxo de checkout (ex: tokenização de cartão, associação de cartão). Sempre retorna 204 No Content — nunca bloqueia o checkout em caso de falha.

​
Autenticação

Não requer autenticação. Protegido por rate limit público.

​
Corpo da Requisição

​
step
string
required
Nome do passo do funil (ex: tokenize_card, associate_card, confirm_payment)
​
outcome
string
required
Resultado do passo. Valores: start, success, failure
​
checkout_id
string
ID da sessão de checkout relacionada
​
flow
string
default:"checkout"
Nome do fluxo de pagamento (ex: checkout, direct)
​
metadata
object
Dados adicionais sobre o evento (ex: brand do cartão, últimos 4 dígitos)

​
Resposta

Sempre retorna 204 No Content. Nenhum corpo na resposta.

​
Exemplo

curl -X POST "https://api.chargefy.io/api/v1/checkouts/funnel-event" \
  -H "Content-Type: application/json" \
  -d '{
    "step": "associate_card",
    "outcome": "success",
    "checkout_id": "chk_1a2b3c4d5e6f",
    "flow": "checkout",
    "metadata": {
      "card_brand": "visa",
      "last4": "4242"
    }
  }'

​
Resposta de Exemplo

HTTP/1.1 204 No Content