Ao fazer uma transa\u00e7\u00e3o, um problema t\u00e9cnico ou de comunica\u00e7\u00e3o pode impedir que sua caixa registradora receba a resposta. Sem essa resposta, sua equipe poder\u00e1 n\u00e3o conseguir verificar se a transa\u00e7\u00e3o foi processada ou qual foi seu resultado. Eles tamb\u00e9m podem tentar cancelar ou reembolsar a transa\u00e7\u00e3o ou arriscar uma transa\u00e7\u00e3o duplicada.<\/p>\n
Em vez disso, sua integra\u00e7\u00e3o deve solicitar o status da transa\u00e7\u00e3o<\/a> para verificar se a transa\u00e7\u00e3o:<\/p>\n Se a transa\u00e7\u00e3o foi processada, voc\u00ea tamb\u00e9m receber\u00e1 a resposta da transa\u00e7\u00e3o original, indicando o resultado.<\/p>\n Se voc\u00ea estiver solicitando com frequ\u00eancia o status da transa\u00e7\u00e3o, poder\u00e1 ter um problema de conectividade de rede. Verifique se o seu terminal est\u00e1 conectado \u00e0 Internet<\/a>, e verifique se a sua integra\u00e7\u00e3o atende aos nossos requisitos funcionais<\/a>.<\/p>\n<\/div>\n Antes de verificar o status de uma transa\u00e7\u00e3o com nossa API de terminais, certifique-se de:<\/p>\n Recomendamos que sua integra\u00e7\u00e3o solicite automaticamente o status de uma transa\u00e7\u00e3o, sempre que falhar em receber uma resposta da transa\u00e7\u00e3o.<\/p>\n As solicita\u00e7\u00f5es de pagamento expiram ap\u00f3s 120 segundos. Se voc\u00ea n\u00e3o receber uma resposta de pagamento (ou uma resposta indicando um tempo limite) ap\u00f3s 150 segundos e a conex\u00e3o de rede n\u00e3o cair, sua integra\u00e7\u00e3o dever\u00e1 solicitar automaticamente o status da transa\u00e7\u00e3o.<\/p>\n Para solicitar o status de uma transa\u00e7\u00e3o, sua caixa registradora deve:<\/p>\n Fazer uma solicita\u00e7\u00e3o POST para um endpoint da API de terminais<\/a>, especificando:<\/p>\n O objeto TransactionStatusRequest<\/a>:<\/p>\n CustomerReceipt<\/strong>: Recibo do cliente.<\/p>\n\n<\/li>\n<\/ul>\n<\/li>\n O exemplo abaixo mostra como voc\u00ea solicitaria o status de um pagamento com o A resposta cont\u00e9m a \n Um exemplo de cada resultado \u00e9 fornecido abaixo.<\/p>\n A A resposta de exemplo abaixo indica que esta transa\u00e7\u00e3o, um pagamento, foi processada. O objeto Para obter uma lista completa dos campos que voc\u00ea pode receber em uma resposta de status de transa\u00e7\u00e3o, consulte a TransactionStatusResponse<\/a>.<\/p>\n<\/div>\n Um Recomendamos que voc\u00ea continue solicitando o status<\/a> desta transa\u00e7\u00e3o novamente a cada 5 segundos, at\u00e9 receber uma resposta indicando que a transa\u00e7\u00e3o foi processada<\/a>.<\/p>\n A resposta de exemplo abaixo indica que esta transa\u00e7\u00e3o ainda est\u00e1 em andamento.<\/p>\n Para obter uma lista completa dos campos que voc\u00ea pode receber em uma resposta de status de transa\u00e7\u00e3o, consulte a TransactionStatusResponse<\/a>.<\/p>\n<\/div>\n Um A resposta de exemplo abaixo indica que esta transa\u00e7\u00e3o n\u00e3o foi encontrada.<\/p>\n tsresponse_processed_transaction.json<\/p>"}}
\n
Antes de come\u00e7ar<\/h2>\n
\n
Solicitar status da transa\u00e7\u00e3o<\/h2>\n
\n
\n
MessageHeader<\/code>. Este segue a estrutura MessageHeader<\/code> padr\u00e3o, explicada nos fundamentos da API de terminais<\/a>:<\/p>\n\n
ProtocolVersion<\/code>: 3.0<\/strong><\/li>\nMessageClass<\/code>: Service<\/strong><\/li>\nMessageCategory<\/code>: TransactionStatus<\/strong><\/li>\nMessageType<\/code>: Request<\/strong><\/li>\nSaleID<\/code>: Seu ID exclusivo para a caixa registradora que faz a solicita\u00e7\u00e3o de status da transa\u00e7\u00e3o.<\/li>\nServiceID<\/code>: Seu ID exclusivo para esta tentativa de transa\u00e7\u00e3o, consistindo em 1 a 10 caracteres alfanum\u00e9ricos. Esse valor deve ser exclusivo nas \u00faltimas 48 horas.<\/li>\nPOIID<\/code>: ID exclusivo do terminal<\/p>\n\n<\/li>\n<\/ul>\n<\/li>\n\n
ReceiptReprintFlag<\/code>: true<\/strong><\/p>\n<\/li>\nDocumentQualifier<\/code>: Receba os dados que deseja receber na resposta. Pode ser um ou ambos:<\/p>\n\n\n
MessageReference<\/code>: Este objeto \u00e9 opcional. Se voc\u00ea n\u00e3o inclu\u00ed-lo, receber\u00e1 o status da transa\u00e7\u00e3o mais recente feita pelo terminal.<\/p>\n\n
SaleID<\/code>: A SaleID<\/code> da caixa registradora que fez a transa\u00e7\u00e3o original.<\/li>\nServiceID<\/code>: The ServiceID<\/code> of the original transaction.<\/li>\nMessageCategory<\/code>: O tipo da transa\u00e7\u00e3o original:<\/p>\n\n\n
ServiceID<\/code> 29235<\/strong>.<\/p>\n``` json\n{\n \"SaleToPOIRequest\": {\n \"MessageHeader\": {\n \"ProtocolVersion\": \"3.0\",\n \"MessageClass\": \"Service\",\n \"MessageCategory\": \"TransactionStatus\",\n \"MessageType\": \"Request\",\n \"SaleID\": \"POSSystemID12345\",\n \"ServiceID\": \"29245\",\n \"POIID\": \"V400m-324688179\"\n },\n \"TransactionStatusRequest\": {\n \"ReceiptReprintFlag\": true,\n \"DocumentQualifier\": [\n \"CashierReceipt\",\n \"CustomerReceipt\"\n ],\n \"MessageReference\": {\n \"SaleID\": \"POSSystemID12345\",\n \"ServiceID\": \"29235\",\n \"MessageCategory\": \"Payment\"\n }\n }\n }\n}\n```<\/code><\/pre>\nTransactionStatusResponse.Response.Result<\/code>, indicando se a transa\u00e7\u00e3o foi processada:<\/p>\n\n
Success<\/code>\n<\/a>: A transa\u00e7\u00e3o foi processada. A resposta da transa\u00e7\u00e3o original tamb\u00e9m \u00e9 fornecida.<\/li>\nFailure<\/code>: A transa\u00e7\u00e3o n\u00e3o foi processada. O motivo \u00e9 indicado pelo ErrorCondition<\/code>:<\/p>\n\n
InProgress<\/code>\n<\/a>: A transa\u00e7\u00e3o ainda est\u00e1 sendo processada.<\/li>\nNotFound<\/code>\n<\/a>: N\u00e3o conseguimos encontrar a transa\u00e7\u00e3o.<\/p>\n\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\nTransa\u00e7\u00e3o processada<\/h2>\n
TransactionStatusResponse.Response.Result<\/code> Success<\/strong> indica que a transa\u00e7\u00e3o foi processada. Use a resposta da transa\u00e7\u00e3o original, fornecida no objeto RepeatedResponseMessageBody<\/code>, para determinar como processar a transa\u00e7\u00e3o.<\/p>\nRepeatedResponseMessageBody<\/code> na resposta indica que o pagamento foi bem sucedido (PaymentResponse.Response.Result<\/code> Success<\/strong>).<\/p>\n{\n \"SaleToPOIResponse\":{\n \"TransactionStatusResponse\":{\n \"MessageReference\":{\n \"SaleID\":\"POSSystemID12345\",\n \"MessageCategory\":\"Payment\",\n \"ServiceID\":\"29235\"\n },\n \"Response\":{\n \"Result\":\"Success\"\n },\n \"RepeatedMessageResponse\":{\n \"RepeatedResponseMessageBody\":{\n \"PaymentResponse\":{\n \"POIData\":{\n \"POITransactionID\":{\n \"TimeStamp\":\"2019-03-07T10:11:04+00:00\",\n \"TransactionID\":\"4rVu001559643049000.981517998282382K\"\n },\n \"POIReconciliationID\":\"1000\"\n },\n \"SaleData\":{\n \"SaleTransactionID\":{\n \"TimeStamp\":\"2019-03-07T10:11:04+00:00\",\n \"TransactionID\":\"29235\"\n }\n },\n \"PaymentReceipt\":[...],\n \"PaymentResult\":{...},\n \"Response\":{\n \"Result\":\"Success\",\n \"AdditionalResponse\":\"...pspReference=981517998282382K...\"\n }\n }\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"MessageClass\":\"Service\",\n \"MessageCategory\":\"Payment\",\n \"ServiceID\":\"29235\",\n \"POIID\":\"V400m-324688179\",\n \"MessageType\":\"Response\"\n }\n }\n },\n \"MessageHeader\":{\n \"SaleID\":\"POSSystemID12345\",\n \"MessageClass\":\"Service\",\n \"MessageCategory\":\"TransactionStatus\",\n \"ServiceID\":\"29235status\",\n \"POIID\":\"V400m-324688179\",\n \"MessageType\":\"Response\"\n }\n }\n}<\/code><\/pre>\nTransa\u00e7\u00e3o em andamento<\/h2>\n
TransactionStatusResponse.Response.ErrorCondition<\/code> of InProgress<\/strong> indica que a transa\u00e7\u00e3o ainda est\u00e1 sendo processada. Geralmente, isso ocorre porque o terminal aguarda a entrada do cliente (por exemplo, uma solicita\u00e7\u00e3o de convers\u00e3o de moeda<\/a>), mas tamb\u00e9m pode resultar de um atraso com o emissor do cart\u00e3o.<\/p>\n{\n \"SaleToPOIResponse\":{\n \"MessageHeader\":{\n \"MessageType\":\"Response\",\n \"MessageCategory\":\"TransactionStatus\",\n \"MessageClass\":\"Service\",\n \"ProtocolVersion\":\"3.0\",\n \"POIID\":\"V400m-324688179\",\n \"SaleID\":\"POSSystemID12345\",\n \"ServiceID\":\"29235status\"\n },\n \"TransactionStatusResponse\":{\n \"Response\":{\n \"Result\":\"Failure\",\n \"ErrorCondition\":\"InProgress\",\n \"AdditionalResponse\":\"message=Uncompleted%20transaction\"\n }\n }\n }\n}<\/code><\/pre>\nTransa\u00e7\u00e3o n\u00e3o encontrada<\/h2>\n
TransactionStatusResponse.Response.ErrorCondition<\/code> NotFound<\/strong> indica que n\u00e3o conseguimos encontrar a transa\u00e7\u00e3o com o SaleID<\/code> e ServiceID<\/code> que voc\u00ea especificou. Isso significa que:<\/p>\n\n
POIID<\/code>, SaleID<\/code> ou ServiceID<\/code> especificou na solicita\u00e7\u00e3o de status da transa\u00e7\u00e3o<\/a> est\u00e3o incorretos. Verifique se voc\u00ea forneceu o POIID<\/code>, SaleID<\/code>, e ServiceID<\/code> a partir da transa\u00e7\u00e3o original<\/em> noTransactionStatusRequest.MessageReference<\/code>.<\/li>\n{\n \"SaleToPOIResponse\":{\n \"MessageHeader\":{\n \"POIID\":\"V400m-324688179\",\n \"SaleID\":\"POSSystemID12345\",\n \"ServiceID\":\"29235-status\",\n \"ProtocolVersion\":\"3.0\",\n \"MessageCategory\":\"TransactionStatus\",\n \"MessageType\":\"Response\",\n \"MessageClass\":\"Service\"\n },\n \"TransactionStatusResponse\":{\n \"Response\":{\n \"ErrorCondition\":\"NotFound\",\n \"Result\":\"Failure\",\n \"AdditionalResponse\":\"message=Message%20with%20category%2018%20not%20Found%2c%20last%20such%20Request%20has%20SaleID%3dPOSSystemID12344%20ServiceID%29233\"\n }\n }\n }\n}<\/code><\/pre>\nVeja tamb\u00e9m<\/h2>\n