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.
Updated 7 months ago