Recebimento integrado com Pix diretamente pela Shipay, sem necessidade de TEF, disponível no PDV e Gourmet.

Configuração

  • Filial

Na aba Integrações do cadastro de filiais, configurar o Access Key e o Token Key:

image1.png

  • Caixa

Dentro do cadastro do caixa, informar o Client ID na aba Opções:

image2.png

  • Administradora de cartão

A configuração do campo Carteira Pix é opcional.

Será utilizado quando houver mais de um banco cadastrado para recebimento no portal, e a chave específica dele será informada no campo. Caso não seja preenchido, no momento do pagamento serão exibidas as opções de bancos disponíveis para recebimento.

image3.png

  • Forma de pagamento

Não pode ter a opção Utilizar TEF marcada.

pg_tef.png



Funcionamento O recebimento pode ser realizado utilizando o modo PDV da Saída e O.S., pelo próprio PDV e pelo Gourmet. É só escolher a forma de pagamento e aguardar o QRCode ser exibido na tela.

pdv2.gif

  • Permissão 533 - Permite confirmar recebimento de pix em integrações

Se houver problemas de conexão para exibir o QR Code, será possível concluir sem a leitura, apenas informando a senha. Para superusuários, será possível finalizar sem a necessidade de confirmação de senha.

image4.png


Monitor de status da api shipay: https://shipay.instatus.com/


Observações

  • TEF e Shipay podem ser utilizados na mesma filial, mas a forma de pagamento da Shipay não deve ter a marcação de TEF.
  • O QRCode sempre será exibido na tela.
  • Não funcionará na forma de recebimento padrão dentro do ETrade.
  • Ao fechar a tela do QRCode, a transação será cancelada.
  • O estorno pode ser realizado diretamente no movimento, bastando clicar em "desefetivar", sem necessidade de confirmação.
  • Se o Client ID não estiver preenchido no caixa, a configuração da shipay será ignorada, e o recebimento será finalizado automaticamente.
  • Gera registro na movimento_TEF

  • Erros conhecidos Unauthenticated User - ocorre quando o cadastro do caixa tem o campo ShipayClientId com valor inválido.

Unauthenticated_User.png


Sobre estornos e modalidades PIX

A Shipay oferece duas modalidades de PIX: PIX Qualquer Banco e PIX Direto com o Banco.

Na modalidade PIX Qualquer Banco, os valores das transações ficam em uma conta bancária de repasse antes de serem enviados para a conta do estabelecimento. Esse repasse ocorre em janelas automáticas, normalmente a cada 2 horas.

O saldo disponível nessa conta de repasse é utilizado para realizar estornos, e cada transação PIX concluída possui uma tarifa.

Por isso, caso não haja saldo suficiente na conta de repasse no momento da solicitação, o estorno não poderá ser realizado pelo sistema. Nesse caso, será necessário que o cliente faça o estorno desse PIX manualmente.

Se a sua operação realiza estornos com frequência, recomendamos considerar a modalidade PIX Direto com o Banco, pois ela não depende do saldo da conta de repasse para esse tipo de processo.

Daegrickcriado em 05 dez 2025 alterado em 07 jul 2026

Manual Comercial Manual

2231 | 0