Estornando uma Transação

Mensagem de solicitação de estorno (Void)

Mensagem para iniciar o processo de estorno de uma transação realizada com sucesso. O estorno demanda a presença do portador e do cartão utilizado para realizar a transação aprovada.

Essa mensagem tem os dados básicos necessários para o autorizador Zoop estornar (cancelar) a transação. O status de uma transação estornada passa de “succeeded” para “canceled”.

Para os PINPads de cabo, a detecção é automática, dependendo do modelo e necessidade de drivers instalados. Ver manual de instalação do Zoop PC SDK/ Zoop Checkout Lite PC.

O parâmetro serialPort é opcional, podendo especificar a porta a ser utilizada caso desejado. Útil quando pinpads Bluetooth são utilizados e configurados manualmente.

Direção da mensagem: CLIENTE -> ZOOP CHECKOUT

{
  "mid": "void",  // Tipos de pagamento: charge, 
  "marketplaceId": "MARKETPLACE_ID", // Mudar pelo marketplaceId correto.
  "publishableKey": "zpk_test...", // Mudar pelo correto. Geralmente fixo
  "sellerId": "ba881ae71b8c8d7e99a8d626sas284", // Mudar pelo seller desejado
  "transactionId": “ba881ae71b8c8d7e99a8d626sas2840a”, // transactionId - ID Zoop da transação
  “serialPort”: “COM18” // Parâmetro opcional: A porta serial a ser utilizada
}

Respostas

Mensagem de confirmação de estorno (voidTransactionSuccessful)

Mensagem com notificação de estorno de transação bem sucedida. Essa mensagem é a mensagem de transação com o status atualizado para “canceled”.

Direção da mensagem: Zoop PC Server -> Aplicação Cliente

{
  "mid": "voidTransactionSuccessful",
  "id": "ba881ae71b8c8d7e99a8d626sas2840a", // Id da transação estornada
  ...
  "status": “canceled” , // status da transação com voided ou cancellled
}

Mensagem de erro no Estorno (voidTransactionFailed)

Mensagem com a notificação de que o pagamento falhou. A transação não foi bem sucedida e o Zoop tem sub-categorias de erro para ajudar a identificar a categoria do erro.

Direção da mensagem: Zoop PC Server -> Aplicação Cliente

{
  "mid": "voidTransactionFailed",
}

Mensagem de Estorno abortado (voidTransactionAborted)

Mensagem com a notificação de que a transação foi abortada pelo cliente, apertando o botão Cancelar no PINPad ou com o operador apertando cancelar na aplicação PDV.

Direção da mensagem: Zoop PC Server -> Aplicação Cliente

{
    “mid”: “voidTransactionAborted”
}

Mensagem (endOfTransaction)

Essa mensagem indica o encerramento por completo a transação.

{
    “mid”: “endOfTransaction”
}