Primeiros passos
O que é a PAYWISE?
A PAYWISE é um gateway de pagamento para aceitar QRIS (todos os bancos e carteiras da Indonésia) e criptomoedas no seu site ou app. Os status dos pagamentos se atualizam sozinhos e os fundos podem ser sacados para uma conta bancária ou uma carteira BEP20. Fundos QRIS também podem ser sacados como USDT (TRC20/ERC20).
Como começo?
1) Cadastre-se como lojista. 2) Complete o perfil da empresa. 3) Adicione seu site. 4) Crie uma chave de API (comece pelo sandbox para testar). 5) Configure o webhook. 6) Quando a integração funcionar, crie uma chave de produção e comece a receber.
Qual a diferença entre sandbox e produção?
O sandbox é para testes: os pagamentos não podem ser pagos de verdade e você escolhe o resultado (pago / falhou / expirado), com os mesmos webhooks da produção. A produção processa pagamentos reais. As chaves de sandbox (pw_test_…) e de produção (pw_live_…) são separadas e nunca veem as transações uma da outra.
Quanto custa?
QRIS 2% e USDT 3% de cada pagamento bem-sucedido, descontado automaticamente antes de ficar disponível para saque. Sem taxa de adesão e sem mensalidade. Cada saque tem uma taxa fixa (veja Saques).
Com quais apps meus clientes podem pagar?
QRIS: qualquer app de banco ou carteira da Indonésia que leia códigos QRIS, como GoPay, OVO, DANA, ShopeePay, LinkAja e os apps dos bancos. Cripto: qualquer carteira ou exchange que envie USDT ou outra das moedas aceitas.
Posso usar uma conta para vários sites?
Sim. Adicione cada site na página Sites e webhook. Não é preciso uma conta para cada site.
Posso conseguir uma tarifa menor?
Sim, para volumes altos. Informe seu volume diário ou mensal esperado no Telegram e enviaremos a nossa melhor oferta.
Pagamentos
Quais os valores mínimo e máximo do QRIS?
Um pagamento QRIS vai de Rp1.000 a Rp10.000.000.
Por quanto tempo um QR code vale?
10 minutos por padrão. Pela API você pode definir um tempo menor com expires_in (em segundos). Depois disso o pagamento expira e o QR code não pode mais ser pago.
O que significam os status de pagamento?
Pendente: aguardando pagamento. Pago: o pagamento foi confirmado. Falhou: o pagamento não pôde ser processado. Expirado: o tempo acabou antes de o cliente pagar.
O cliente diz que pagou, mas o status continua pendente. E agora?
Abra o pagamento no painel e clique em Verificar status: a PAYWISE consulta o provedor diretamente. Se continuar pendente, peça ao cliente o comprovante (referência, horário, valor) e fale com o suporte informando a referência PW… do pagamento.
Como funcionam os pagamentos em USDT?
Na página de pagamento o cliente escolhe uma moeda: USDT em BEP20, TRC20 (a partir de 20 USDT), Polygon ou Solana, ou BTC, ETH, BNB, SOL, TRX ou LTC. Ele envia exatamente o pay_amount mostrado, nessa moeda e nessa rede, para o endereço indicado (a taxa de rede e de conversão está incluída e é paga pelo cliente). As outras moedas são convertidas em USDT: você sempre recebe o valor em USDT. Uma moeda enviada pela rede errada pode ser perdida.
E se o cliente enviar USDT a menos?
O pagamento não é marcado como pago. Quando o tempo acaba ele expira, e nossa equipe acompanha com o cliente (complemento ou reembolso). Se o seu cliente perguntar, fale com o suporte informando a referência PW… do pagamento.
Por que não consigo criar pagamentos agora?
A PAYWISE às vezes pausa um método de pagamento por pouco tempo, por exemplo durante uma instabilidade do provedor ou do banco, ou em manutenção. Os pagamentos já abertos não são afetados. A página Status do sistema mostra quando volta.
Liquidação e fundos disponíveis
Quando posso sacar os pagamentos QRIS?
Os fundos QRIS ficam disponíveis neste horário (UTC+7): pago 20:00–07:59 → disponível às 09:00 (pagamentos antes da meia-noite: no dia seguinte); pago 08:00–11:59 → disponível às 13:00; pago 12:00–15:59 → disponível às 17:00; pago 16:00–19:59 → disponível às 21:00. Um lojista pode ter horários próprios; o horário exato dos seus fundos aparece nas páginas Início e Saques.
Quando posso sacar os pagamentos em USDT?
Os fundos em USDT ficam disponíveis assim que o pagamento é pago.
Por que meus fundos disponíveis são menores que o total de pagamentos?
Os fundos disponíveis são o dinheiro após a taxa da transação, cuja liquidação já chegou e que ainda não foi sacado. O dinheiro que aguarda o lote de liquidação aparece separado como "aguardando liquidação".
Os fundos QRIS e USDT são somados?
Não. Cada método tem seus próprios fundos na própria moeda: QRIS em rupias (saque para conta bancária) e USDT em USDT (saque para carteira BEP20). Nunca são somados. Os fundos QRIS só são convertidos se você escolher Sacar fundos QRIS em USDT.
A liquidação também funciona em fins de semana e feriados?
Sim. Você recebe pagamentos 24 horas por dia, e o horário de liquidação acima vale todos os dias, inclusive sábados, domingos e feriados.
Saques
Quais são os limites e taxas de saque?
QRIS (para conta bancária): de Rp15.000 a Rp25.000.000 por saque, taxa Rp3.000. USDT (para carteira BEP20): de 10.00 USDT a 10,000.00 USDT por saque, taxa 1.00 USDT. O valor que você digita é o que chega; a taxa é somada e descontada dos seus fundos disponíveis. Saques QRIS de Rp5.000.000 ou mais não têm taxa (com Saque parcial: cada parte de Rp5.000.000 ou mais).
E se eu quiser sacar mais que o máximo?
Escolha Saque parcial na página de saque QRIS. Um valor acima de Rp25.000.000 é dividido automaticamente em vários saques (por exemplo, 50 milhões = 20 + 20 + 10 milhões), com taxa de Rp3.000 por saque.
Posso sacar fundos QRIS como USDT?
Sim. Na página de saque QRIS escolha Sacar fundos QRIS em USDT, selecione a rede TRC20 ou ERC20 e informe o endereço da sua carteira. De Rp500.000 a Rp250.000.000 por saque, sem taxa de saque. A cotação e o USDT estimado aparecem antes de confirmar. O valor em USDT é arredondado para baixo em USDT inteiros. Esses saques só podem ser solicitados entre 09:00 e 18:00 (UTC+7).
Quanto tempo leva um saque?
Saques QRIS para conta bancária são enviados automaticamente, em geral em minutos. Saques de QRIS para USDT são processados manualmente pela nossa equipe entre 09:00 e 18:00 (UTC+7). Acompanhe o status em Saques; você é avisado quando terminar.
Por que meu saque foi recusado ou falhou?
O mais comum: número da conta ou banco não conferem, a conta de destino está inativa ou o endereço da carteira BEP20 está errado. Um saque recusado ou com falha sempre volta para os seus fundos disponíveis. Use Verificar conta antes de enviar para confirmar o nome do titular.
O que é o código de saque?
Um código enviado ao seu e-mail sempre que você solicita um saque, como proteção extra. Sem ele nenhum saque pode ser solicitado, mesmo que alguém entre na sua conta.
Quem da minha equipe pode sacar?
Somente o dono da conta e os membros com o perfil Financeiro. Desenvolvedores e membros só de leitura não podem solicitar saques.
Por que os saques estão pausados?
A PAYWISE às vezes pausa os saques por pouco tempo, por exemplo em manutenção ou instabilidade bancária. Um aviso na página de saque explica o motivo. Seus fundos não são afetados e você pode sacar assim que for retomado.
Minha taxa de saque é diferente da mostrada aqui.
As taxas desta Central de ajuda são as padrão. Se você combinou outra tarifa com a PAYWISE, vale a sua, e a página de saque sempre a mostra antes de confirmar.
Integração
Como conecto meu site?
Use a API REST (documentação completa na página Desenvolvedores), o plugin para WooCommerce ou o SDK PHP / Node.js. Crie um pagamento com POST /api/v1/transactions, envie o cliente para a página de pagamento (checkout_url) ou mostre o QR você mesmo, e aguarde o webhook.
O que é um webhook e como verifico?
Um webhook é um aviso que a PAYWISE envia ao seu servidor quando um status muda (payment.paid, payment.failed, payment.expired e withdrawal.*). Todo webhook é assinado: o cabeçalho X-PAYWISE-Signature é o HMAC-SHA256 do corpo bruto com o seu segredo de webhook. Verifique sempre antes de entregar um pedido. Para mais segurança, verifique X-PAYWISE-Signature-V2 (que também assina o horário de envio X-PAYWISE-Timestamp) e recuse webhooks com mais de 5 minutos, para que um webhook copiado não possa ser reenviado.
Meu webhook falhou. O que acontece?
A PAYWISE tenta de novo automaticamente várias vezes. Você também pode reenviá-lo pela página do pagamento. Garanta que o seu servidor responda com HTTP 2xx e não bloqueie os IPs de envio da PAYWISE.
Como evito pedidos duplicados?
Envie um merchant_reference único para cada pedido. Se uma requisição com o mesmo merchant_reference for enviada de novo (por exemplo após um timeout), a PAYWISE devolve o mesmo pagamento em vez de criar outro.
Como mantenho minha chave de API segura?
Guarde as chaves de API só no seu servidor, nunca em um app ou em código visível aos visitantes. Defina os IPs permitidos na página Chaves de API e revogue as chaves que não usa mais.
Há limite de requisições à API?
Sim: 60 requisições por minuto por chave de API, por padrão. Acima disso a API responde HTTP 429; aguarde um pouco e tente de novo. Fale com o suporte se precisar de um limite maior.
De quais IPs vêm os webhooks?
Eles estão na página Sites e webhook. Se o seu servidor ou firewall só aceita endereços conhecidos, libere esses.
Posso testar a API sem programar?
Sim. Use o API Playground do painel para enviar requisições com a sua chave de sandbox, ou baixe a coleção do Postman ou o arquivo OpenAPI na página Desenvolvedores.
Notificações e relatórios
Quais notificações vou receber?
Por exemplo: pagamento recebido, resumo diário, fundos disponíveis, resultado de saques, extrato mensal, webhooks com falha e avisos da PAYWISE. Cada membro da equipe recebe só o que combina com o seu perfil, e algumas notificações podem ser desligadas na página Notificações.
Posso receber notificações no celular?
Sim. Instale o app PAYWISE direto do nosso site (sem loja de apps) e permita as notificações. Você é avisado assim que um pagamento chega.
Como baixo minhas transações ou um extrato?
Na página Transações, exporte suas transações em CSV. A página Relatórios mostra os totais por período, com exportação CSV e extrato mensal em PDF.
Conta e segurança
Por que pedem um código quando entro?
A PAYWISE usa verificação em duas etapas: um login de um dispositivo novo pede um código enviado ao seu e-mail. Você pode marcar um dispositivo pessoal como confiável para não ser perguntado toda vez.
Minha equipe pode usar o painel?
Sim. Convide membros com o perfil certo (por exemplo financeiro, desenvolvedor ou só leitura). Cada perfil só pode fazer o que lhe é permitido.
Esqueci minha senha.
Clique em "Esqueceu a senha?" na página de login, informe seu e-mail e siga o link de redefinição que enviaremos.
E se eu vir atividade suspeita na minha conta?
Troque a senha imediatamente e, na página de segurança, encerre todas as outras sessões e revise a atividade de login. Fale com o suporte sobre qualquer pagamento ou saque que você não reconheça.
Nenhuma pergunta corresponde. Tente outras palavras ou fale com o suporte.
Ainda precisa de ajuda?
Nosso suporte atende pelo Telegram e por e-mail. Lojistas conectados também podem abrir um ticket em Suporte.
Siga o canal da PAYWISE no Telegram
Novidades, avisos e agenda de manutenção, direto no seu Telegram.


