Cartão Cobrança no cartão

Como criar uma cobrança no cartão de crédito.

1. Tokenize o cartão

O Paygrid não recebe dados do cartão. O cartão é tokenizado pelo provedor em um ambiente PCI; você envia apenas o token resultante.

A tokenização acontece no checkout do provedor (ex. Pagar.me). O resultado é um payment_token (Pagar.me) que você usa na cobrança.

2. Crie a cobrança

curl -X POST https://api.paygrid.io/v1/transactions \
  -H "X-Api-Key: sk_sua_chave" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-5001" \
  -d '{
    "amount": 59900,
    "currency": "BRL",
    "method": "card",
    "token": "tok_abc123...",
    "installments": 3,
    "cardBrand": "visa",
    "reference": "pedido-5001"
  }'

Campo	Obrigatório	Descrição
`amount`	sim	Valor em centavos.
`token`	sim (card)	Token PCI do cartão.
`installments`	não	Parcelas (padrão 1).
`cardBrand`	não	Bandeira (visa, master, etc.).
`workflowId`	sim	O fluxo que processa a cobrança.

3. Resultado

A resposta traz transactionId e status. Para cartão o desfecho é imediato: approved ou declined (diferente do Pix, que fica pending até o pagador pagar).

4. Reconsulte / Webhook

Consulte GET /v1/transactions/{transactionId} ou configure webhooks para ser notificado.