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:



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

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.