Cobranças

Criar cobrança

Crie cobranças via cartão tokenizado, Pix ou boleto usando o endpoint POST /v1/charges.

Cartão de crédito

cURL — cobrança com cartão

curl -X POST https://sandbox.api.futuropay.com.br/v1/charges \
  -H "Authorization: Bearer sk_sandbox_[PREENCHER]" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "currency": "BRL",
    "payment_method": "credit_card",
    "installments": 1,
    "card": { "token": "card_tok_9f8a7b6c5d" },
    "customer": { "name": "Maria Souza", "email": "maria@example.com" }
  }'

Pix

cURL — cobrança Pix

curl -X POST https://sandbox.api.futuropay.com.br/v1/charges \
  -H "Authorization: Bearer sk_sandbox_[PREENCHER]" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 9000,
    "currency": "BRL",
    "payment_method": "pix",
    "expires_in": 3600,
    "customer": { "name": "João Lima", "document": "[PREENCHER: CPF]" }
  }'

Resposta — 201 Created

{
  "id": "ch_3f9a1c2d8e",
  "status": "pending",
  "payment_method": "pix",
  "amount": 9000,
  "pix": {
    "qr_code": "00020126...[PREENCHER]",
    "qr_code_url": "https://sandbox.api.futuropay.com.br/v1/charges/ch_3f9a1c2d8e/qrcode"
  },
  "created_at": "2026-07-17T14:32:00Z"
}

Parâmetros principais

Campo	Tipo	Descrição
amount	integer	Valor em centavos.
payment_method	string	`credit_card`, `pix` ou `boleto`.
customer	object	Dados do pagador.