Bem-vindo à API Pixispay

Essa é a API da Pixispay — uma subadquirente B2B brasileira que processa PIX, Boleto e Cartão de crédito. Aqui você encontra tudo o que precisa para integrar pagamentos na sua aplicação.

URL Base

https://api.pixispay.com

Sobre os valores

Todos os valores (amount) são enviados e retornados em centavos. Por exemplo, R$ 19,90 é enviado como 1990.

Passo a passo

Em quatro passos você está integrado à Pixispay e pronto para receber pagamentos em produção.

1. Aprovação da conta

Crie sua conta em app.pixispay.com/register e aguarde a aprovação. Após aprovado, acesse app.pixispay.com com seu usuário e senha.

2. Gere sua API Key

No painel, vá até a página Integrações (penúltimo item do menu lateral). Clique em Adicionar, dê um nome para a chave e clique em Criar. A chave aparecerá na lista — clique no ícone de copiar para guardá-la em segurança.

3. Cadastre seu Webhook

No menu lateral, acesse Webhooks e clique em Novo Webhook. Informe a URL do endpoint que receberá os eventos (transações e/ou saques).

Você pode criar um webhook para cada tipo de evento, ou um único endpoint que receba todos.

4. Faça sua primeira chamada

Pronto! Com a API Key em mãos, você já pode criar transações. Veja a seção Transações abaixo.

Autenticação

A autenticação na API Pixispay é feita via header HTTP x-api-key.

Header obrigatório

x-api-key: SUA_API_KEY_AQUI

Exemplo de chamada autenticada

curl -X GET https://api.pixispay.com/balance \
  -H "x-api-key: pk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Endpoints de gerenciamento de chaves

Transações

A API suporta três meios de pagamento: PIX, Boleto e Cartão de crédito (com 3DS).

Endpoints de transações

Exemplo: Gerar PIX

curl -X POST https://api.pixispay.com/transactions/pix \
  -H "x-api-key: pk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1990,
    "description": "Pedido #12345",
    "customer": {
      "name": "João Silva",
      "email": "joao@email.com",
      "document": "12345678900"
    }
  }'

Lembre-se: amount é em centavos (1990 = R$ 19,90).

Webhooks

Configure URLs no painel para receber notificações em tempo real sobre transações e saques.

Tipos de webhook

Eventos de transação

• TRANSACTION_PAID — Pagamento confirmado
• TRANSACTION_PENDING — Aguardando pagamento
• TRANSACTION_REFUNDED — Estornado
• TRANSACTION_FAILED — Falha no processamento
• TRANSACTION_EXPIRED — Expirou sem pagamento

Endpoints de gerenciamento

Withdraw / Cash Out

A API de saques permite enviar valores via PIX para qualquer chave válida no Brasil.

Tipos de chave PIX aceitos

• PHONE — Telefone
• EMAIL — E-mail
• EVP — Chave aleatória
• CPF — CPF
• CNPJ — CNPJ

Endpoints

Exemplo: Cash Out

curl -X POST https://api.pixispay.com/withdraw/cash-out \
  -H "x-api-key: pk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "pix_key_type": "CPF",
    "pix_key": "12345678900",
    "description": "Saque mensal"
  }'

Balance

Consulte o saldo disponível na sua conta Pixispay em tempo real.

Exemplo

curl -X GET https://api.pixispay.com/balance \
  -H "x-api-key: pk_live_xxxxxxxxxxxxxxxx"

Taxas (Fees)

Disputes

Gerencie disputas e contestações de pagamentos com cartão diretamente pela API.

Health Check

Códigos de erro