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.
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:
- 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.
- 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.
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.
/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.
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"}'
/api/v1/credits/redeem
Liquida o crédito e marca o token como redeemed/used impedindo qualquer reutilização.
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.