Pagamentos
AdvinPay
Receba Pix na AdvinPay com a Access Key e a Secret Key da sua conta.
A AdvinPay processa Pix na Promisse Store. A conexão pede as duas chaves de uma credencial de API: a Access Key, que começa com ak_, e a Secret Key, que começa com sk_.
Na AdvinPay#
Gere a credencial#
No painel da AdvinPay, abra a área de credenciais de API e gere uma credencial no ambiente de produção. Credencial de sandbox não recebe Pix de verdade.
Marque os escopos#
A loja precisa só de dois:
Escopo Para quê transactions:depositCriar a cobrança Pix do pedido transactions:readConsultar se o Pix foi pago Não marque saque nem transferência: a loja nunca move o seu saldo.
Libere o acesso por IP#
Toda credencial tem uma lista de IPs autorizados. O servidor da loja não tem IP fixo, então coloque
0.0.0.0/0. A Secret Key continua sendo exigida em toda chamada.Com a lista restrita a outro IP, a AdvinPay recusa a conexão e as cobranças.
Copie as chaves#
Copie a Access Key e a Secret Key.
No painel da loja#
Abra Pagamentos, clique em Conectar na AdvinPay e preencha:
| Campo | O que colar | Obrigatório |
|---|---|---|
| Access Key (ak_...) | A Access Key | Sim |
| Secret Key (sk_...) | A Secret Key | Sim |
Na conexão, a plataforma confere as chaves, o IP liberado e os dois escopos sem gerar nenhuma cobrança.
Taxa da Promisse no próprio Pix#
Na AdvinPay, os 3% da plataforma saem por split no próprio Pix, como na PromissePay, na MisticPay e na SyntraPay. Você recebe a venda já sem a taxa, e o pedido não entra em fatura. Se a AdvinPay recusar o split, a venda sai normalmente e a taxa daquele pedido vai para a fatura.
Bom saber#
- A AdvinPay não faz reembolso pela API. Devolva o valor no painel da AdvinPay.
- A confirmação do pagamento é feita por consulta à AdvinPay, disparada pelo aviso dela e repetida periodicamente. O aviso sozinho nunca aprova pedido.
- A URL de aviso vai junto com cada cobrança. Não precisa cadastrar webhook no painel da AdvinPay.
- Contestação de Pix (MED) é tratada no painel da AdvinPay. Se o valor for devolvido ao comprador, marque o pedido como reembolsado na loja.
- A taxa da AdvinPay começa em R$ 0,50 por Pix. O valor exato é o combinado na sua conta.

