Criando uma transação Pix online

Para criar uma transação do tipo Pix, será utilizada a mesma API de transação, apenas alterando o "payment_type"(meio de pagamento) para "pix" (parâmetro).

1981

Fluxo transacional

❗️

Sandbox

As transações de Pix podem ser criadas no ambiente de sandbox (teste), porém não devem ser pagas.

❗️

Sobre o pagamento

Para o cliente “pagador” da transação de Pix será exibida a identificação do seller no campo “mensagem ao pagador”.

Caso uma confirmação de pagamento seja realizada depois da expiração do QR Code, automaticamente uma operação de cancelamento (void) será comandada.

QR Code e "Copia e cola"

Para obter os dados para gerar QR Code ou para o pagamento "copia e cola" é necessário utilizar a informação que retorna no campo "emv" após a criação do Pix, conforme o exemplo abaixo:

"qr_code": {
            "emv": "00020101021226770014BR.GOV.BCB.PIX2555api.itau/pix/qr/v2/c8f91ed7-b017-4e04-b744-7b3a0169625b5204000053039865802BR5925Zoop Tecnologia E Meios D6009SAO PAULO62070503***63042330"
        }

Tempo de expiração de Pix QR Code.

É possível o marketplace escolher o tempo limite para expiração de QR Code, podendo ser 05, 10, 15, 30 minutos, 1, 3, 6, 12 ou 24 horas

Atualmente, o limite global para qualquer marketplace é de 5 minutos, podendo ser ajustado conforme as opções disponíveis. Para atendimento desta alteração, é necessário contatar o time de CX por email ([email protected]) ou clicando aqui.

Tempo de expiração de PIX QR Code acima de 24h

Poderá ser habilitado um tempo acima de 24H para expiração do QR Code, onde o limite da duração máxima será de 730 dias ou aproximadamente 2 anos. Quando habilitada essa opção, a duração poderá ser passada diretamente no request da transação de PIX API de transação.

Para ter acesso a essa funcionalidade, é necessário contatar o time de CX por email ([email protected]) ou clicando aqui.

🚧

Atenção!

Só poderá utilizar expiração acima de 24h para clientes que possuem operação exclusivamente online. Caso o cliente possua operações presenciais o PIX não poderá ser configurado acima desse limite.

1224

Fluxo de status

Fluxo de status

Durante o fluxo de compra uma transação existem diferentes estados de acordo com as atualizações aplicadas.

Você pode verificar o estado atual através do campo "status", sempre retornado no objeto da transação. Também é possível verificar o histórico de uma transação através do campo "history".

new: Uma nova transação foi criada e as informações foram recebidas com sucesso para processamento.

pending: Observe que o status da transação é retornado como pending, permanecendo neste estado até que o pagamento seja identificado ou então o prazo de validade se encerre.

succeeded: O pagamento do Pix foi identificado pela Zoop.

failed: Ocorreu uma falha ao processar a transação.

canceled: O pagamento foi cancelado/anulado pelo vendedor. As taxas cobradas originalmente também são anuladas. Esse status também refere-se a uma transação de Pix não paga dentro do tempo de validade do QR Code. O evento disparado no caso de expiração de QR Code será "transaction.canceled". Também será atualizado o campo "operation_type"' para "expiration" na chave "history"

❗️

Atenção

Atenção

A chave "reference_id" deve ter uma valor único em cada requisição de transação, não podendo ter seu valor informado repetido.