Identificador de Referência para transações

Alguns negócios geram chaves únicas para identificar unidades básicas de operação, como ordens de serviço, ordem de reparo, entrega. Através do campo "referenceId", a ser enviado em cada carga/transação, pode-se vincular estes identificadores as suas respectivas transações realizadas através da plataforma Zoop.

Caso se deseje vincular um identificador a cada transação e visualizá-lo posteriormente no Dashboard da Zoop, você deve utilizar um dos métodos charge que possuem o campo referenceId como parâmetro.

Este parâmetro é do tipo "String" e deve assumir o máximo de 50 caracteres.

A seguir, os cabeçalhos de métodos do SDK que incluem o parâmetro "referenceId":

  • void charge (BigDecimal valueToCharge, int paymentOption, int iNumberOfInstallments, String marketplaceId, String sellerId, String publishableKey, String referenceId)

  • void charge (BigDecimal valueToCharge, int paymentOption, int iNumberOfInstallments, String marketplaceId, String sellerId, String publishableKey, JSONObject joMetadado, String referenceId)

Lista de transações através de um "referenceId"

Você pode obter a lista de transações vinculadas a um identificador de referência de duas formas: síncrona ou assíncrona.

Síncrona

A solução síncrona está disponível através do método estático getTransactionsByReferenceIdSync que retorna um objeto do tipo "JSONObject". O objeto de resposta possui o parâmetro "items" em sua raíz, cujo valor é a lista de transações.

❗️

Antenção

Mais informações sobre a estrutura e o tipo de dados da lista de transações retornada são apresentadas na página Transação.

Assíncrona

A solução assíncrona está disponível através do método getTransactionsByReferenceId. A utilização deste método requer a implementação da interface ZoopAPIWrapperListener para a definição de "callbacks" de sucesso - "requestSuccessful" (JSONObject var1) - e erro - requestFailed (String var1).

O "callback" de sucesso recebe um "JSONObject" com a mesma estrutura do objeto retornado para o "callback" da forma síncrona.


Did this page help you?