Pagamentos
SyntraPay
Receba Pix na SyntraPay com uma chave de API da sua conta.
A SyntraPay processa Pix na Promisse Store. A conexão pede uma chave de API da sua conta, que começa com sk_live_. O comprador não precisa informar CPF ou CNPJ.
Na SyntraPay#
Crie uma chave#
No painel da SyntraPay, abra Integrações → Credenciais e crie uma chave de API.
Marque os escopos#
A loja precisa só de dois:
Escopo Para quê payments.createCriar a cobrança Pix do pedido payments.readConsultar se o Pix foi pago Não marque saque, transferência, webhooks nem links de pagamento: a loja nunca move o seu saldo.
Copie a chave#
Copie a chave, que começa com
sk_live_.
No painel da loja#
Abra Pagamentos, clique em Conectar na SyntraPay e preencha:
| Campo | O que colar | Obrigatório |
|---|---|---|
| Chave de API (sk_live_...) | A chave copiada | Sim |
Na conexão, a plataforma confere a chave e os dois escopos sem gerar nenhuma cobrança. Se faltar escopo, a chave estiver revogada ou a conta ainda não estiver ativada na SyntraPay, a conexão é recusada e o motivo aparece na tela.
Taxa da Promisse no próprio Pix#
Na SyntraPay, a taxa da plataforma sai por split no próprio Pix, como na PromissePay, na MisticPay e na AdvinPay. Você recebe a venda já sem a taxa, e o pedido não entra em fatura. Se a SyntraPay recusar o split, a venda sai normalmente e a taxa daquele pedido vai para a fatura.
Bom saber#
- O valor mínimo por cobrança é R$ 1,00. Abaixo disso, a venda vai para o próximo gateway das regras.
- A taxa da SyntraPay começa em R$ 0,40 por Pix aprovado. O valor exato é o combinado na sua conta.
- A confirmação do pagamento é feita por consulta à SyntraPay, 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 SyntraPay.
- A SyntraPay não faz reembolso pela API. Devolva o valor no painel dela.
- Devolução ou MED feitos no painel da SyntraPay não mudam o pedido aqui. Ajuste o pedido em Vendas.

