Criptografia Ponta a Ponta Ativa
🏬 Seja um Parceiro
API REST v1 ● Em Produção

Integração: Pagamento via QR Code Dinâmico

Permita que seus clientes paguem no seu e-commerce escaneando um QR Code no celular com autorização instantânea e liquidação em tempo real.

🚀
Ainda não tem suas credenciais de API? Cadastre sua loja no programa de parceiros e obtenha seu Client ID e API Secret na hora.
Solicitar API Key Grátis →
🤖 Copie & Cole no Cursor / ChatGPT / Claude

Super Prompt para IA: Integração Automática em 2 Minutos

Envie este prompt completo para qualquer IA de programação (Cursor, Copilot, ChatGPT ou Claude) para que ela crie toda a lógica de backend e frontend no seu site parceiro de forma 100% pronta e sem erros!

Você é um desenvolvedor especialista em integrações de meios de pagamento. Preciso integrar o método de pagamento por QR Code da WePayCode no meu checkout. Aqui estão as especificações completas da API REST da WePayCode: 1. URL Base da API: https://wepaycode.com/api/v1 2. Autenticação obrigatória via Headers HTTP em todas as requisições: - X-Client-Id: SEU_CLIENT_ID - X-Client-Secret: SEU_CLIENT_SECRET - Content-Type: application/json - Accept: application/json FLUXO DA INTEGRAÇÃO: Passo 1 (Backend do meu site): Quando o cliente escolhe pagar via WePayCode QR Code, faça uma requisição POST para: https://wepaycode.com/api/v1/qr-payment/create Com o body JSON: { "amount": 250.00, "order_id": "NUMERO_DO_MEU_PEDIDO", "description": "Compra na Minha Loja" } A API retorna: - session_id (UUID seguro da sessão) - qr_image_url (URL direta da imagem do QR Code para colocar na tag ) - qr_payload (URL do link de autorização mobile) - expires_at (data de expiração da sessão) Passo 2 (Frontend do meu site): Exiba a imagem do QR Code na tela de checkout com uma contagem regressiva e mensagem "Abra a câmera do seu celular para autorizar o pagamento". Passo 3 (Verificação de Status - Polling ou Webhook): Enquanto o QR Code é exibido, faça uma requisição a cada 2 segundos para: GET https://wepaycode.com/api/v1/qr-payment/{session_id}/status (enviando os mesmos headers X-Client-Id e X-Client-Secret) Quando a resposta retornar: { "success": true, "data": { "is_paid": true, "status": "redeemed" } } Redirecione o cliente automaticamente para a página de confirmação de pedido/sucesso da minha loja! Por favor, gere o código completo pronto para produção contendo o controller de backend e o script de frontend com polling automático para a minha aplicação.
1

Criar a Sessão de Pagamento por QR Code

No momento em que o cliente estiver finalizando o pedido na sua loja, seu backend deve disparar um POST para gerar a sessão de pagamento e receber o payload e a imagem do QR Code.

// Endpoint
POST https://wepaycode.com/api/v1/qr-payment/create
// Headers Obrigatórios
X-Client-Id: TECHSTORE-BR-994
X-Client-Secret: sec_live_techstore_secret_994821
Content-Type: application/json
// Body (JSON)
{
    "amount": 250.00,
    "order_id": "PEDIDO-10928",
    "description": "Compra na TechStore Brasil"
}
Exemplo de Resposta de Sucesso (HTTP 201 Created):
{
  "success": true,
  "data": {
    "session_id": "4bf491cb-7e23-4e8c-8f92-9388df291823",
    "external_order_id": "PEDIDO-10928",
    "amount_cents": 25000,
    "amount_formatted": "CHF 250.00",
    "currency": "CHF",
    "status": "pending",
    "qr_payload": "https://wepaycode.com/autorizar-qr/4bf491cb-7e23-4e8c-8f92-9388df291823",
    "qr_image_url": "https://api.qrserver.com/v1/create-qr-code/?size=250x250&data=...",
    "expires_at": "2026-10-03T16:15:00.000000Z",
    "status_check_url": "https://wepaycode.com/api/v1/qr-payment/4bf491cb-7e23-4e8c-8f92-9388df291823/status"
  }
}
2

Exibir o QR Code e Monitorar a Aprovação (Frontend)

Renderize a imagem do QR Code na tela de pagamento. O cliente abre a câmera do smartphone, é direcionado com segurança para a página de autorização do WePayCode e aprova o débito com 1 clique.

// JavaScript (Frontend Polling a cada 2s)
// 1. Exiba a imagem:
document.getElementById('myQrImg').src = data.qr_image_url;

// 2. Monitore o status até a aprovação:
const timer = setInterval(async () => {
    const res = await fetch('/api/check-qr-status?session_id=' + data.session_id);
    const result = await res.json();

    if (result.is_paid) {
        clearInterval(timer);
        alert('Pagamento aprovado com sucesso!');
        window.location.href = '/pedido/confirmado';
    }
}, 2000);
3

Consulta de Status ou Webhook Assíncrono

A API oferece consulta REST sob demanda e envio assíncrono para o endpoint de Webhook cadastrado nas credenciais da sua loja:

GET https://wepaycode.com/api/v1/qr-payment/{session_id}/status
{
  "success": true,
  "data": {
    "session_id": "4bf491cb-7e23-4e8c-8f92-9388df291823",
    "status": "redeemed",
    "is_paid": true,
    "amount_cents": 25000,
    "amount_formatted": "CHF 250.00",
    "external_order_id": "PEDIDO-10928",
    "redeemed_at": "2026-10-03T15:48:10.000000Z"
  }
}