Cartão

Criar cobrança

POST/api/v1/charges

Cria uma cobrança PIX ou cartão. Use o campo method como discriminador — "pix" ou "credit_card". Valores em centavos.

Requisição · cartão

curl -X POST https://beta.venopayments.com/api/v1/charges \
  -H "Authorization: Bearer veno_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "method": "credit_card",
    "amount": 10000,
    "installments": 1,
    "customer": {
      "name": "João Silva",
      "email": "joao@email.com",
      "document": "12345678900"
    },
    "card": {
      "token": "<token do veno.js>",
      "three_ds": "<three_ds do veno.js>"
    }
  }'

Parâmetros do body

methodstringObrigatório

"pix" ou "credit_card".

amountintegerObrigatório

Valor em centavos. 10000 = R$ 100,00.

installmentsinteger

Número de parcelas (cartão). Padrão: 1.

customerobjectObrigatório

Dados do comprador.

cardobject

Obrigatório quando method = "credit_card". O token e o three_ds vêm do veno.js no browser — ambos são necessários para capturar a cobrança (3DS / liability shift).