Seu próximo PIX.
Integrado.

Uma chave. Seu ambiente.

Gere sua chave em Mini App → API e use o header Authorization: Bearer SUA_API_KEY em todas as rotas. As chaves são secretas: use somente no backend.

O ambiente é definido pela chave; não envie parâmetro mode. Cada chave tem 64 caracteres hexadecimais após o prefixo. Rotacionar uma chave revoga as anteriores do ambiente.

Crie sua primeira cobrança.

Valores de transações são em reais, com até duas casas decimais. Os exemplos abaixo são ilustrativos e não executam operações nesta página.

const response = await fetch('https://www.slacepay.com/v1/payments', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLACEPAY_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'pedido-1043-v1',
  },
  body: JSON.stringify({ amount: 100, description: 'Pedido #1043' }),
});
const result = await response.json();
// Guarde result.data.id e consulte o pagamento até a confirmação.

Um pagamento. Mais de um recebedor.

O campo opcional splits distribui o líquido entre usuários cadastrados e ativos na SlacePay. Use o id UUID da conta, disponível em GET /v1/me; não use o ID do Telegram. São até 20 destinatários únicos, sem incluir o criador.

{
  "amount": 100,
  "description": "Pedido com parceiros",
  "splits": [
    {
      "userId": "5237c9d0-25dd-4453-86e0-41345b5b58dc",
      "amount": 10
    },
    {
      "userId": "65b6506e-c9ee-466c-87ef-6e6920254cab",
      "percentage": 20
    }
  ],
  "callbackUrl": "https://seusite.com/pagamentos/slacepay",
  "webhookSecret": "SUBSTITUA_POR_SEGREDO_ALEATORIO_32_OU_MAIS"
}

Em cada item, informe amount em reais ou percentage com até duas casas decimais. O percentual incide sobre o líquido após a taxa do criador; frações de centavo são arredondadas para baixo. Cada parcela deve ser de ao menos R$ 0,01, a soma não pode superar o líquido e a soma dos percentuais não pode superar 100%.

A distribuição é congelada na criação e creditada atomicamente na confirmação, em carteiras do mesmo ambiente. netAmount informa o líquido total e creditedAmount informa a parte do titular consultando a operação. O criador vê a divisão; cada parceiro vê somente sua parcela após a confirmação, sem código PIX, dados dos outros recebedores ou configurações de webhook. Uma devolução reverte todas as parcelas uma vez; saldo já gasto pode ficar negativo.

A confirmação chega ao seu sistema.

Ao criar o pagamento, inclua callbackUrl. A SlacePay envia POST JSON para essa URL nos eventos payment.created, payment.confirmed, payment.failed e payment.refunded. A criação é avisada após o aceite do provedor; resultado incerto não é aprovação. O webhook contém a visão do criador, sem código PIX, API key ou segredo.

{
  "id": "8e4a4257-13b6-4b18-99ec-1940f210ea3f",
  "event": "payment.confirmed",
  "sequence": 2,
  "timestamp": "2026-10-23T15:00:00.000Z",
  "data": {
    "id": "7f29c80a-e041-4c25-9109-86184211b107",
    "mode": "test",
    "type": "CASH_IN",
    "status": "COMPLETED",
    "amount": 100,
    "fee": 6,
    "netAmount": 94,
    "creditedAmount": 65.2,
    "webhookEnabled": true
  }
}

Use HTTPS público, domínio DNS e porta 443, sem credenciais ou fragmento na URL. Endereços privados, locais e reservados são bloqueados também após resolver o DNS; redirecionamentos não são seguidos. A URL é destinada à sua integração e não substitui a confirmação financeira recebida pela gateway.

O campo opcional webhookSecret aceita 32 a 128 caracteres ASCII sem espaços e exige callbackUrl. Gere um segredo aleatório no seu servidor. Se omitir, derive o segredo com HMAC-SHA256, usando a API key que criou o pagamento como chave e o texto literal slacepay:webhook:v1 como mensagem, em hexadecimal. A configuração é congelada por pagamento; rotacionar a API key não altera assinaturas de cobranças existentes.

import { createHmac, timingSafeEqual } from 'node:crypto';

// Sem webhookSecret explícito, derive usando a chave que criou a cobrança:
const secret = createHmac('sha256', process.env.SLACEPAY_API_KEY)
  .update('slacepay:webhook:v1').digest('hex');
// Se enviou webhookSecret no pagamento, use aquele segredo em seu lugar.

function verifyWebhook(rawBody, headers, paymentSecret) {
  const timestamp = headers['x-slacepay-timestamp'];
  const signature = headers['x-slacepay-signature'];
  if (!/^\d{10,12}$/.test(timestamp || '') ||
      Math.abs(Date.now() / 1000 - Number(timestamp)) > 300 ||
      !/^sha256=[a-f0-9]{64}$/.test(signature || '')) return false;
  const expected = createHmac('sha256', paymentSecret)
    .update(timestamp + '.').update(rawBody).digest();
  const actual = Buffer.from(signature.slice(7), 'hex');
  return actual.length === expected.length && timingSafeEqual(actual, expected);
}
// rawBody deve conter os bytes originais; não serialize JSON novamente.
// Só processe após validar. Persista e deduplique pelo id do evento.
// Responda 2xx após armazenar com segurança; processe o trabalho em fila.

Headers: X-SlacePay-Signature: sha256=…, X-SlacePay-Timestamp em segundos Unix e X-SlacePay-Delivery-Id, igual ao id do evento. A assinatura usa timestamp + "." + corpo JSON original. O timestamp do header é renovado em cada tentativa; o corpo, ID e sequência permanecem iguais.

Responda 2xx para confirmar recebimento. Falhas e respostas fora de 2xx geram até 10 tentativas com intervalos crescentes, limitados a seis horas por intervalo. Destinos inseguros encerram a entrega. Os eventos aguardam a entrega anterior do mesmo pagamento ser concluída ou esgotada; use sequence para acompanhar a ordem. Uma resposta perdida pode causar reenvio: deduplique pelo ID. Registros terminais são retidos por 30 dias. Mantenha consultas ao pagamento como alternativa se sua URL estiver indisponível.

Repita com segurança.

Criação de pagamento e saque exigem Idempotency-Key: 8 a 128 caracteres entre letras, números, ponto, dois-pontos, hífen e sublinhado.

Na repetição, envie a mesma chave e o mesmo corpo. Um corpo diferente com a mesma chave retorna 409. Em timeout ou HTTP 202, guarde o ID e consulte a operação; se precisar reenviar, preserve a chave. Uma nova chave pode criar uma nova transação.

Cada estado tem um significado.

submission acompanha o envio: CREATED, SUBMITTING, ACKNOWLEDGED, UNKNOWN, REJECTED ou MANUAL_REVIEW. UNKNOWN e MANUAL_REVIEW exigem acompanhamento e não confirmam pagamento nem saque.

201 indica solicitação processada; 202 indica resultado pendente/incerto. Consulte status para confirmar a movimentação. As consultas retornam o estado conhecido pela SlacePay. Acompanhe por consulta ou receba eventos na callbackUrl informada ao criar o pagamento.

Erros normalmente retornam { error: { code, message }, requestId }. Uma recusa financeira também pode retornar data.status = FAILED. Guarde o requestId para solicitar suporte.

Do primeiro PIX ao último detalhe.

Todas as rotas abaixo exigem sua API key e acessam somente sua conta e o ambiente da chave.

curl --request GET 'https://www.slacepay.com/v1/me' \
  --header 'Authorization: Bearer SUA_API_KEY'

{
  "data": {
    "id": "7f29c80a-e041-4c25-9109-86184211b107",
    "telegramId": "123456789",
    "status": "active",
    "mode": "test",
    "fees": {
      "cashIn": {
        "bps": 500,
        "fixedCents": 100
      },
      "cashOut": {
        "bps": 0,
        "fixedCents": 500
      }
    },
    "limits": {
      "cashIn": {
        "minCents": 200,
        "maxCents": 100000,
        "dailyCents": 10000000
      },
      "cashOut": {
        "minCents": 1000,
        "maxCents": 100000,
        "dailyCents": 5000000
      }
    },
    "livePayerConfigured": false
  }
}

curl --request GET 'https://www.slacepay.com/v1/balance' \
  --header 'Authorization: Bearer SUA_API_KEY'

{
  "data": {
    "mode": "test",
    "currency": "BRL",
    "available": 94,
    "reserved": 0
  }
}

curl --request POST 'https://www.slacepay.com/v1/payments' \
  --header 'Authorization: Bearer SUA_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: pedido-1043-v1' \
  --data '{"amount":100,"description":"Pedido #1043"}'

{
  "data": {
    "id": "7f29c80a-e041-4c25-9109-86184211b107",
    "mode": "test",
    "type": "CASH_IN",
    "status": "PENDING",
    "submission": "ACKNOWLEDGED",
    "amount": 100,
    "fee": 6,
    "netAmount": 94,
    "creditedAmount": 94,
    "webhookEnabled": false,
    "description": "Pedido #1043",
    "createdAt": "2026-10-22T15:00:00.000Z",
    "updatedAt": "2026-10-22T15:00:00.000Z",
    "copyPaste": "CODIGO_PIX_FORNECIDO_NA_RESPOSTA"
  }
}

curl --request GET 'https://www.slacepay.com/v1/payments/7f29c80a-e041-4c25-9109-86184211b107' \
  --header 'Authorization: Bearer SUA_API_KEY'

{
  "data": {
    "id": "7f29c80a-e041-4c25-9109-86184211b107",
    "mode": "test",
    "type": "CASH_IN",
    "status": "COMPLETED",
    "submission": "ACKNOWLEDGED",
    "amount": 100,
    "fee": 6,
    "netAmount": 94,
    "creditedAmount": 94,
    "webhookEnabled": false,
    "description": "Pedido #1043",
    "createdAt": "2026-10-22T15:00:00.000Z",
    "updatedAt": "2026-10-22T15:00:00.000Z",
    "copyPaste": "CODIGO_PIX_FORNECIDO_NA_RESPOSTA"
  }
}

curl --request POST 'https://www.slacepay.com/v1/withdrawals' \
  --header 'Authorization: Bearer SUA_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: pedido-1043-v1' \
  --data '{"amount":100,"description":"Saque solicitado","pixKey":"[email protected]","pixKeyType":"EMAIL"}'

{
  "data": {
    "id": "7f29c80a-e041-4c25-9109-86184211b107",
    "mode": "test",
    "type": "CASH_OUT",
    "status": "PENDING",
    "submission": "ACKNOWLEDGED",
    "amount": 100,
    "fee": 5,
    "description": "Saque solicitado",
    "createdAt": "2026-10-22T15:00:00.000Z",
    "updatedAt": "2026-10-22T15:00:00.000Z",
    "totalDebit": 105
  }
}

curl --request GET 'https://www.slacepay.com/v1/withdrawals/7f29c80a-e041-4c25-9109-86184211b107' \
  --header 'Authorization: Bearer SUA_API_KEY'

{
  "data": {
    "id": "7f29c80a-e041-4c25-9109-86184211b107",
    "mode": "test",
    "type": "CASH_OUT",
    "status": "COMPLETED",
    "submission": "ACKNOWLEDGED",
    "amount": 100,
    "fee": 5,
    "description": "Saque solicitado",
    "createdAt": "2026-10-22T15:00:00.000Z",
    "updatedAt": "2026-10-22T15:00:00.000Z",
    "totalDebit": 105
  }
}

Nenhuma rota encontrada. Tente outro termo.