Entrar Criar conta
● WePayCode REST API v1.0 • OpenAPI Ready

Documentação para Desenvolvedores

Integre o checkout sem cartão da WePayCode em qualquer plataforma de e-commerce com validação instantânea e resgate idempotente.

Ver Checkout Demo em Ação →

Introdução

A API WePayCode permite que lojas parceiras aceitem pagamentos tokenizados gerados diretamente a partir do saldo dos usuários. O processo é composto por duas etapas:

  1. Validação: No momento em que o comprador insere o código no checkout, seu sistema consulta nossa API para verificar o valor autorizado e o status de disponibilidade.
  2. Resgate (Redeem): Ao clicar em finalizar pedido, seu servidor envia uma requisição de resgate com chave de idempotência para liquidar os fundos instantaneamente.
Regra Fundamental de Segurança: O valor cobrado é SEMPRE obtido do banco de dados a partir do token. O frontend nunca pode determinar ou alterar o saldo liquidado.

Autenticação

Todas as requisições aos endpoints /api/v1/* devem enviar as seguintes credenciais nos cabeçalhos HTTP:

X-API-Key Seu identificador único de parceiro (ex: TECHSTORE-BR-994)
X-API-Secret Seu segredo privado gerado no painel administrativo

Garantia de Idempotência

O resgate de tokens exige o envio do cabeçalho Idempotency-Key (ou campo idempotency_key). Caso ocorra uma desconexão de rede ou timeout e sua aplicação reenvie a solicitação, nosso servidor reconhece a chave prévia e devolve o mesmo recibo de sucesso sem cobrar o usuário duas vezes.

POST /api/v1/credits/validate

Verifica se o código existe, se está no prazo de validade, se pertence a este parceiro e quanto está reservado.

EXEMPLO cURL:
curl -X POST https://wepaycode.com/api/v1/credits/validate \
  -H "X-API-Key: TECHSTORE-BR-994" \
  -H "X-API-Secret: sec_live_techstore_secret_994821" \
  -H "Content-Type: application/json" \
  -d '{"code": "WPC-8F42-K91X-73LM"}'
POST /api/v1/credits/redeem

Liquida o crédito e marca o token como redeemed/used impedindo qualquer reutilização.

EXEMPLO cURL:
curl -X POST https://wepaycode.com/api/v1/credits/redeem \
  -H "X-API-Key: TECHSTORE-BR-994" \
  -H "X-API-Secret: sec_live_techstore_secret_994821" \
  -H "Idempotency-Key: order-48192-tx" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "WPC-8F42-K91X-73LM",
    "expected_amount_cents": 25000,
    "order_id": "ORDER-48192"
  }'
⚡

Interactive API Sandbox

Dispare chamadas reais contra o servidor local e veja os cabeçalhos, tempo de resposta e JSON retornado.

Navegação & Recursos
🚀
Como Funciona
⚡
Carteira Digital
🛍️
Lojas Parceiras
📱
Pagar via QR
Desenvolvedor
Seja Parceiro
🧪
Demo Checkout
🛡️
Segurança
Entrar Criar Conta
Instalar WePayCode no iPhone Adicione à Tela de Início para ter o App Nativo completo