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”
}
Updated about 1 year ago