PIX STRIPE

API de Integração

Documentação oficial da Capital Investimentos Pay. Nossa API permite processar pagamentos via PIX Instantâneo (com suporte a White Label) e Cartão de Crédito (via Stripe Checkout) de forma simples e segura.

Autenticação

Todas as requisições devem ser autenticadas via Bearer Token. Utilize sua chave secreta (sk_live_...) disponível no Dashboard.

Header HTTP

Authorization: Bearer sk_live_Q80x...
Content-Type: application/json

POST

/charges (PIX)

Gera um QR Code PIX dinâmico. Suporta Split de Pagamento (White Label), permitindo que o nome da sua empresa (ou do seu cliente) apareça no comprovante bancário.

Parâmetros do Body

Campo	Tipo	Obrigatório	Descrição
amount_cents	Int	Sim	Valor em centavos (ex: 1500 = R$ 15,00)
payment_method	String	Sim	Deve ser `"pix"`
customer	Object	Sim	Dados do pagador (Nome, Email).
sub_merchant	Object	Não	White Label: Dados do vendedor final que aparecerão no comprovante.

Exemplo de Requisição (com White Label)

request.json

{
  "amount_cents": 1500,
  "payment_method": "pix",
  "currency": "BRL",
  
  "sub_merchant": {
    "name": "Loja do Cliente LTDA",
    "document": "12.345.678/0001-99"
  },

  "customer": {
    "name": "João Silva",
    "email": "joao@email.com"
  }
}

Response (201 Created)

response.json

{
  "id": "f3ddcc22-7276-450d-8ee5-7a6d0ba9c872",
  "status": "waiting_payment",
  "pix": {
    "qr_code": "00020126580014BR.GOV.BCB.PIX...",
    "expiration": "2025-12-06T00:00:00"
  },
  "created_at": "2025-12-04T14:30:53"
}

POST

/charges (Cartão / Stripe)

Inicia uma sessão de Checkout segura via Stripe. A resposta conterá uma URL para a qual você deve redirecionar o usuário.

Parâmetros do Body

Campo	Tipo	Obrigatório	Descrição
amount_cents	Int	Sim	Valor em centavos.
payment_method	String	Sim	Deve ser `"stripe_checkout"`.
success_url	String	Sim	URL de retorno após sucesso.
cancel_url	String	Sim	URL de retorno após cancelamento.

Exemplo de Requisição

request.json

{
  "amount_cents": 4990,
  "payment_method": "stripe_checkout",
  "currency": "BRL",
  "success_url": "https://sualoja.com/sucesso",
  "cancel_url": "https://sualoja.com/cancelado"
}

Response (200 OK)

response.json

{
  "id": "cs_test_a1b2c3d4...",
  "status": "pending",
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_test_..."
}

GET

/status/(transaction_id)

Consulta o status atual de uma transação (PIX ou Stripe). Recomendado para polling no frontend.

GET Request

curl -X GET https://api.capitalpay.com/v1/status/f3ddcc22-7276...

response.json

{
  "id": "f3ddcc22-7276-450d-8ee5-7a6d0ba9c872",
  "status": "paid",
  "amount_cents": 1500
}

Webhooks

Configure uma URL de Notificação no Dashboard para receber atualizações automáticas. O evento principal é o transaction.paid.

Exemplo de Payload

POST Payload

{
  "event": "transaction.paid",
  "data": {
    "id": "f3ddcc22-7276-450d-8ee5-7a6d0ba9c872",
    "status": "paid",
    "amount_cents": 1500,
    "updated_at": "2025-12-04T14:31:15"
  }
}