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).
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:
**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](🔗).
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.