Pular para o conteúdo principal

Fluxo de Transação Pix via MS-SHIPAY (Assíncrono)

Este documento descreve a rotina de comunicação para a criação e consulta de uma transação Pix com o provedor SHIPAY. A principal característica deste fluxo é a sua natureza assíncrona.

O processo é dividido em três etapas distintas:

  1. Solicitação de Geração: O POS solicita a criação da transação, mas não recebe o QRCode de volta imediatamente.
  2. Consulta do QRCode: O POS consulta em loop até que o QRCode, que foi processado em segundo plano, esteja disponível.
  3. Consulta de Status do Pagamento: Após obter o QRCode, o POS continua consultando para verificar se o pagamento foi efetuado.

Processo 1: Solicitação de Geração de QRCode (POST /pix)​

Nesta etapa, o POS apenas "dispara" o início do processo. A resposta é quase instantânea, contendo um transactionId, mas o QRCode ainda não está pronto. A geração real acontece em segundo plano (assincronamente).

Processo 2: Consulta do QRCode (GET /consult/{transactionId})​

Com o transactionId em mãos, o POS começa a consultar repetidamente para obter o QRCode que foi gerado no processo em segundo plano.

Observação: Nesta fase, a consulta é interna no PSI, que verifica se já recebeu o resultado do processamento em segundo plano do MS-SHIPAY.

Processo 3: Consulta de Status do Pagamento (GET /consult/{transactionId})​

Depois que o QRCode é exibido, o POS continua usando o mesmo endpoint /consult para verificar se o cliente efetuou o pagamento.