{"__v":0,"_id":"58459567ba4f1c0f0096932e","api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"body":"Apresentaremos aqui, tudo o que você precisa para se conectar com a nossa estrutura de pagamento virtual (E-commerce).\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"INTRODUÇÃO\"\n}\n[/block]\nTodas as compras de e-commerce têm inicio com o cliente ( portador do cartão ) escolhendo um ou mais produtos, adicionando-os ao carrinho, revisando os itens escolhidos, até chegar à etapa de pagamento.\n\nUma vez que o portador do cartão efetua o pagamento através de cartão de crédito, voucher, etc, dois novos participantes passam a ser comunicar através de trocas de mensagens, para autorizar a transação e fazer a sua captura:\n\n1. Adquirente STONE\n\n2. Banco emissor do cartão\n\nAdquirente é a empresa responsável por fazer a comunicação com o emissor ( banco ). Cada emissor possui seu próprio fluxo, meio de comunicação, tecnologia de segurança, protocolo, etc. Quando um e-commerce faz a integração através de um adquirente, está se beneficiando de todo um investimento em tecnologias e segurança, além de um mecanismo único para se comunicar com o banco emissor, independentemente da tecnologia utilizada pelo banco.\n\nPor exemplo, se um e-commerce precisa aceitar pagamentos através de três bandeiras de cartão de crédito diferentes, seriam necessários três processos de integração diferentes. Como o adquirente já fez esse investimento no processo de integração, o custo de integração através da adquirente é muito menor para a loja, do que se a integração fosse feita diretamente com as bandeiras.","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:27:19.513Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":0,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"bem-vindo-à-stone-online","sync_unique":"","title":"Bem vindo à Stone Online","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Bem vindo à Stone Online


Apresentaremos aqui, tudo o que você precisa para se conectar com a nossa estrutura de pagamento virtual (E-commerce). [block:api-header] { "type": "basic", "title": "INTRODUÇÃO" } [/block] Todas as compras de e-commerce têm inicio com o cliente ( portador do cartão ) escolhendo um ou mais produtos, adicionando-os ao carrinho, revisando os itens escolhidos, até chegar à etapa de pagamento. Uma vez que o portador do cartão efetua o pagamento através de cartão de crédito, voucher, etc, dois novos participantes passam a ser comunicar através de trocas de mensagens, para autorizar a transação e fazer a sua captura: 1. Adquirente STONE 2. Banco emissor do cartão Adquirente é a empresa responsável por fazer a comunicação com o emissor ( banco ). Cada emissor possui seu próprio fluxo, meio de comunicação, tecnologia de segurança, protocolo, etc. Quando um e-commerce faz a integração através de um adquirente, está se beneficiando de todo um investimento em tecnologias e segurança, além de um mecanismo único para se comunicar com o banco emissor, independentemente da tecnologia utilizada pelo banco. Por exemplo, se um e-commerce precisa aceitar pagamentos através de três bandeiras de cartão de crédito diferentes, seriam necessários três processos de integração diferentes. Como o adquirente já fez esse investimento no processo de integração, o custo de integração através da adquirente é muito menor para a loja, do que se a integração fosse feita diretamente com as bandeiras.
Apresentaremos aqui, tudo o que você precisa para se conectar com a nossa estrutura de pagamento virtual (E-commerce). [block:api-header] { "type": "basic", "title": "INTRODUÇÃO" } [/block] Todas as compras de e-commerce têm inicio com o cliente ( portador do cartão ) escolhendo um ou mais produtos, adicionando-os ao carrinho, revisando os itens escolhidos, até chegar à etapa de pagamento. Uma vez que o portador do cartão efetua o pagamento através de cartão de crédito, voucher, etc, dois novos participantes passam a ser comunicar através de trocas de mensagens, para autorizar a transação e fazer a sua captura: 1. Adquirente STONE 2. Banco emissor do cartão Adquirente é a empresa responsável por fazer a comunicação com o emissor ( banco ). Cada emissor possui seu próprio fluxo, meio de comunicação, tecnologia de segurança, protocolo, etc. Quando um e-commerce faz a integração através de um adquirente, está se beneficiando de todo um investimento em tecnologias e segurança, além de um mecanismo único para se comunicar com o banco emissor, independentemente da tecnologia utilizada pelo banco. Por exemplo, se um e-commerce precisa aceitar pagamentos através de três bandeiras de cartão de crédito diferentes, seriam necessários três processos de integração diferentes. Como o adquirente já fez esse investimento no processo de integração, o custo de integração através da adquirente é muito menor para a loja, do que se a integração fosse feita diretamente com as bandeiras.
{"__v":0,"_id":"584595be9f6fbb1b004307a7","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"Toda a comunicação começa com o portador optando por fazer o pagamento com um cartão aceito pelo e-commerce. O e-commerce, por sua vez, envia uma mensagem para o adquirente, solicitando o processamento do pagamento. Assim como ocorre com pagamentos nas maquininhas, o cliente precisará informar seus dados de autenticação e o pagamento poderá ser autorizado ou negado, seja por informações incorretas, ou algum eventual problema.\n\nA integração com a Stone ocorrerá através do uso (consumo) de um webservice REST através de requisições HTTP.\n\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5223cc6-fluxo.png\",\n        \"fluxo.png\",\n        903,\n        1343,\n        \"#9a9a9a\"\n      ],\n      \"sizing\": \"full\",\n      \"border\": true\n    }\n  ]\n}\n[/block]","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:28:46.226Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":1,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"fluxo-de-comunicação","sync_unique":"","title":"Fluxo de Comunicação","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Fluxo de Comunicação


Toda a comunicação começa com o portador optando por fazer o pagamento com um cartão aceito pelo e-commerce. O e-commerce, por sua vez, envia uma mensagem para o adquirente, solicitando o processamento do pagamento. Assim como ocorre com pagamentos nas maquininhas, o cliente precisará informar seus dados de autenticação e o pagamento poderá ser autorizado ou negado, seja por informações incorretas, ou algum eventual problema. A integração com a Stone ocorrerá através do uso (consumo) de um webservice REST através de requisições HTTP. [block:image] { "images": [ { "image": [ "https://files.readme.io/5223cc6-fluxo.png", "fluxo.png", 903, 1343, "#9a9a9a" ], "sizing": "full", "border": true } ] } [/block]
Toda a comunicação começa com o portador optando por fazer o pagamento com um cartão aceito pelo e-commerce. O e-commerce, por sua vez, envia uma mensagem para o adquirente, solicitando o processamento do pagamento. Assim como ocorre com pagamentos nas maquininhas, o cliente precisará informar seus dados de autenticação e o pagamento poderá ser autorizado ou negado, seja por informações incorretas, ou algum eventual problema. A integração com a Stone ocorrerá através do uso (consumo) de um webservice REST através de requisições HTTP. [block:image] { "images": [ { "image": [ "https://files.readme.io/5223cc6-fluxo.png", "fluxo.png", 903, 1343, "#9a9a9a" ], "sizing": "full", "border": true } ] } [/block]
{"__v":0,"_id":"584595c99f6fbb1b004307a8","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:28:57.700Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":2,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"credenciais-de-acesso","sync_unique":"","title":"Credenciais de Acesso","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Credenciais de Acesso


{"__v":0,"_id":"584595d6ba4f1c0f0096932f","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"Para iniciar a integração com o nosso webservice solicite sua credencial de acesso ao nosso time de integrações pelo e-mail[ integracoes@stone.com.br.](mailto: integracoes@stone.com.br) \n\nVocê deve encaminhar um e-mail com as seguintes informações:\n\n* **O nome da empresa parceira que realizará transações na Stone**\n* **O CNPJ da empresa**\n* **Uma descrição sucinta do negócio parceiro (em uma frase)**\n* **E-mail para onde a credencial deve ser enviada**\n\nVocê receberá um e-mail com uma SAK (SaleAffiliationKey) com um formato como este: **EF1CC1A4FECE40EB8B29CA7328955C88**","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:29:10.812Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":3,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"homologação","sync_unique":"","title":"Homologação","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Homologação


Para iniciar a integração com o nosso webservice solicite sua credencial de acesso ao nosso time de integrações pelo e-mail[ integracoes@stone.com.br.](mailto: integracoes@stone.com.br) Você deve encaminhar um e-mail com as seguintes informações: * **O nome da empresa parceira que realizará transações na Stone** * **O CNPJ da empresa** * **Uma descrição sucinta do negócio parceiro (em uma frase)** * **E-mail para onde a credencial deve ser enviada** Você receberá um e-mail com uma SAK (SaleAffiliationKey) com um formato como este: **EF1CC1A4FECE40EB8B29CA7328955C88**
Para iniciar a integração com o nosso webservice solicite sua credencial de acesso ao nosso time de integrações pelo e-mail[ integracoes@stone.com.br.](mailto: integracoes@stone.com.br) Você deve encaminhar um e-mail com as seguintes informações: * **O nome da empresa parceira que realizará transações na Stone** * **O CNPJ da empresa** * **Uma descrição sucinta do negócio parceiro (em uma frase)** * **E-mail para onde a credencial deve ser enviada** Você receberá um e-mail com uma SAK (SaleAffiliationKey) com um formato como este: **EF1CC1A4FECE40EB8B29CA7328955C88**
{"__v":0,"_id":"584595df2c0fc019001635df","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"Uma vez que a etapa de homologação for concluída você precisará de uma credencial de PRODUÇÃO que será encaminhada após o seu cadastro com a Stone.\n\nPara solicitar seu cadastro encaminhe um e-mail para o nosso time comercial [ecommerce@stone.com.br](mailto:ecommerce@stone.com.br) lhe auxiliar no processo de credenciamento.","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:29:19.264Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":4,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"produção","sync_unique":"","title":"Em Produção","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Em Produção


Uma vez que a etapa de homologação for concluída você precisará de uma credencial de PRODUÇÃO que será encaminhada após o seu cadastro com a Stone. Para solicitar seu cadastro encaminhe um e-mail para o nosso time comercial [ecommerce@stone.com.br](mailto:ecommerce@stone.com.br) lhe auxiliar no processo de credenciamento.
Uma vez que a etapa de homologação for concluída você precisará de uma credencial de PRODUÇÃO que será encaminhada após o seu cadastro com a Stone. Para solicitar seu cadastro encaminhe um e-mail para o nosso time comercial [ecommerce@stone.com.br](mailto:ecommerce@stone.com.br) lhe auxiliar no processo de credenciamento.
{"__v":0,"_id":"58459605e055290f00c029d2","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"Todas as mensagens serão enviadas através do protocolo HTTP. Todas as mensagens são enviadas utilizando o método POST para os seguintes endpoints:\n\n\n* Para o ambiente de produção [https://e-commerce.stone.com.br](https://e-commerce.stone.com.br)\n\n* Para o ambiente de homologação [https://sandbox-auth-integration.stone.com.br](https://sandbox-auth-integration.stone.com.br) \n\nAs funcionalidades disponíveis para as requisições são:\n\n* Autorização (**AUTHORIZE**)\n\n* Captura posterior (**COMPLETIONADVICE**)\n\n* Cancelamento (**CANCELLATION**)\n\n* Consulta de Transações(**TRANSACTIONSTATUSREPORT**)\n\n* Ajuda (**HELP**)\n\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Tipos das TAGs XML\",\n  \"body\": \"Para mais informações sobre o tipo de dados das tags XML [clique aqui](doc:tipo-das-tags-xml)\\n\\nAtualmente os tipos definidos são:\\n\\n* Container\\n\\n* CodeSet\\n\\n* Text\\n\\n* Amount \\n\\n* DateTime\\n\\n* Quantity\"\n}\n[/block]","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:29:57.725Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":5,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"requisições-e-funcionalidades","sync_unique":"","title":"Requisições e funcionalidades","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Requisições e funcionalidades


Todas as mensagens serão enviadas através do protocolo HTTP. Todas as mensagens são enviadas utilizando o método POST para os seguintes endpoints: * Para o ambiente de produção [https://e-commerce.stone.com.br](https://e-commerce.stone.com.br) * Para o ambiente de homologação [https://sandbox-auth-integration.stone.com.br](https://sandbox-auth-integration.stone.com.br) As funcionalidades disponíveis para as requisições são: * Autorização (**AUTHORIZE**) * Captura posterior (**COMPLETIONADVICE**) * Cancelamento (**CANCELLATION**) * Consulta de Transações(**TRANSACTIONSTATUSREPORT**) * Ajuda (**HELP**) [block:callout] { "type": "info", "title": "Tipos das TAGs XML", "body": "Para mais informações sobre o tipo de dados das tags XML [clique aqui](doc:tipo-das-tags-xml)\n\nAtualmente os tipos definidos são:\n\n* Container\n\n* CodeSet\n\n* Text\n\n* Amount \n\n* DateTime\n\n* Quantity" } [/block]
Todas as mensagens serão enviadas através do protocolo HTTP. Todas as mensagens são enviadas utilizando o método POST para os seguintes endpoints: * Para o ambiente de produção [https://e-commerce.stone.com.br](https://e-commerce.stone.com.br) * Para o ambiente de homologação [https://sandbox-auth-integration.stone.com.br](https://sandbox-auth-integration.stone.com.br) As funcionalidades disponíveis para as requisições são: * Autorização (**AUTHORIZE**) * Captura posterior (**COMPLETIONADVICE**) * Cancelamento (**CANCELLATION**) * Consulta de Transações(**TRANSACTIONSTATUSREPORT**) * Ajuda (**HELP**) [block:callout] { "type": "info", "title": "Tipos das TAGs XML", "body": "Para mais informações sobre o tipo de dados das tags XML [clique aqui](doc:tipo-das-tags-xml)\n\nAtualmente os tipos definidos são:\n\n* Container\n\n* CodeSet\n\n* Text\n\n* Amount \n\n* DateTime\n\n* Quantity" } [/block]
{"__v":0,"_id":"58459612ba4f1c0f00969330","api":{"auth":"required","examples":{"codes":[{"code":"<Document xmlns=\"urn:AcceptorAuthorisationRequestV02.1\">\n    <AccptrAuthstnReq>\n        <!-- Cabeçalho da requisição -->\n        <Hdr>\n            <!-- Identifica o tipo de processo em que a mensagem se propõe. -->\n            <MsgFctn>AUTQ</MsgFctn>\n            <!-- Versão do protocolo utilizado na mensagem. -->\n            <PrtcolVrsn>2.0</PrtcolVrsn>\n        </Hdr>\n        <!-- Dados da requisição de autorização. -->\n        <AuthstnReq>\n            <!-- Ambiente da transação. -->\n            <Envt>\n                <!-- Dados do estabelecimento. -->\n                <Mrchnt>\n                    <!-- Identificação do estabelecimento. -->\n                    <Id>\n                        <!-- Identificação do estabelecimento comercial no adquirente.\n                             Também conhecido internamente como “SaleAffiliationKey”. -->\n                        <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n                        <!-- O nome que aparecerá na fatura.\n                             - se a transação for mastercard, o limite é 22 caracteres;\n                             - se a transação for visa, o limite é 25 caracteres;\n                             - se for parcelado, a visa usa os 8 primeiros caracteres do\n                               nome do lojista pra passar a informação de parcelamento,\n                               sobrando 17 caracteres. -->\n                        <ShrtNm>Nome da fatura</ShrtNm>\n                    </Id>\n                </Mrchnt>\n                <!-- Dados do ponto de interação -->\n                <POI>\n                    <!-- Identificação do ponto de interação -->\n                    <Id>\n                        <!-- Código de identificação do ponto de interação\n                             atribuído pelo estabelecimento. -->\n                        <Id>2FB4C89A</Id>\n                    </Id>\n                </POI>\n                <!-- Dados do cartão utilizado na transação. -->\n                <Card>\n                    <!-- Dados não criptografados do cartão utilizado na transação. -->\n                    <PlainCardData>\n                        <!-- Número do cartão. (Primary Account Number) -->\n                        <PAN>4066559930861909</PAN>\n                        <!-- Data de validade do cartão no formato “yyyy-MM”. -->\n                        <XpryDt>2017-10</XpryDt>\n                        <!-- Código de segurança do cartão -->\n                        <CardSctyCd>\n                            <!-- CVV estampado no verso do cartão -->\n                            <CSCVal>123</CSCVal>\n                        </CardSctyCd>\n                    </PlainCardData>\n                </Card>\n            </Envt>\n            <!-- Informações da transação a ser realizada. -->\n            <Cntxt>\n                <!-- Informações sobre o pagamento. -->\n                <PmtCntxt>\n                    <!-- Modo da entrada dos dados do cartão.\n                         PHYS = Ecommerce ou Digitada; -->\n                    <CardDataNtryMd>PHYS</CardDataNtryMd>\n                    <!-- Tipo do canal de comunicação utilizado na transação.\n                         ECOM = Ecommerce ou Digitada -->\n                    <TxChanl>ECOM</TxChanl>\n                </PmtCntxt>\n            </Cntxt>\n            <!-- Informações da transação. -->\n            <Tx>\n                <!-- Identificação da transação definida pelo sistema que se\n                     comunica com o Host Stone.(ITK) -->\n                <InitrTxId>123123123</InitrTxId>\n                <!-- Indica se os dados da transação devem ser capturados (true)\n                     ou não (false) imediatamente. -->\n                <TxCaptr>false</TxCaptr>\n                <!-- Dados de identificação da transação atribuída pelo POI. -->\n                <TxId>\n                    <!-- Data local e hora da transação atribuídas pelo POI. -->\n                    <TxDtTm>2014-03-12T15:11:06</TxDtTm>\n                    <!-- Identificação da transação definida pelo ponto de interação (POI,\n                         estabelecimento, lojista, etc). O formato é livre contendo no\n                         máximo 32 caracteres. -->\n                    <TxRef>06064f516a50483da7f189243c95ccca</TxRef>\n                </TxId>\n                <!-- Detalhes da transação. -->\n                <TxDtls>\n                    <!-- Moeda utilizada na transação em conformidade com a ISO 4217.-->\n                    <Ccy>986</Ccy>\n                    <!-- Valor total da transação em centavos. -->\n                    <TtlAmt>100</TtlAmt>\n                    <!-- Modalidade do cartão utilizado na transação.FIXO 'CRDT' -->\n                    <AcctTp>CRDT</AcctTp>\n                    <!-- Os dados relativos à(s) parcela(s) ou a uma transação recorrente. -->\n                    <RcrngTx>\n                        <!-- Tipo de parcelamento. -->\n                        <InstlmtTp>NONE</InstlmtTp>\n                        <!-- Número do total de parcelas. -->\n                        <TtlNbOfPmts>0</TtlNbOfPmts>\n                    </RcrngTx>\n                </TxDtls>\n            </Tx>\n        </AuthstnReq>\n    </AccptrAuthstnReq>\n</Document>","language":"xml"}]},"params":[],"results":{"codes":[{"status":200,"language":"xml","code":"<Document xmlns=\"urn:AcceptorAuthorisationResponseV02.1\">\n    <AccptrAuthstnRspn>\n        <!-- Cabeçalho da mensagem -->\n        <Hdr>\n            <!-- Identifica o tipo de processo em que a mensagem se propõe.\n                 AUTP = AuthorisationResponse. -->\n            <MsgFctn>AUTP</MsgFctn>\n            <!-- Versão do protocolo utilizado na mensagem. -->\n            <PrtcolVrsn>2.0</PrtcolVrsn>\n            <!-- Dados para rastreamento da mensagem. -->\n            <Tracblt>\n                <!-- Data e hora da saída da mensagem no Host Stone. -->\n                <TracDtTmOut>2014-03-12T18:10:58</TracDtTmOut>\n            </Tracblt>\n        </Hdr>\n        <!-- Informações relacionadas à resposta da autorização. -->\n        <AuthstnRspn>\n            <!-- Ambiente da transação. -->\n            <Envt>\n                <!-- Dados do estabelecimento. -->\n                <MrchntId>\n                    <!-- dentificação do estabelecimento comercial no adquirente. Também\n                         conhecido internamente como “SaleAffiliationKey”. -->\n                    <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\n                </MrchntId>\n                <!-- Dados do ponto de interação. -->\n                <PoiId>\n                    <!-- Identificador do ponto de interação -->\n                    <Id>2FB4C89A</Id>\n                </PoiId>\n            </Envt>\n            <!-- Informações da transação. -->\n            <Tx>\n                <!--- Dados de identificação da transação atribuída pelo POI -->\n                <TxId>\n                    <!-- Data local e hora da transação atribuído pelo POI.\n                         Este campo será ecoado pelo adquirente. -->\n                    <TxDtTm>2014-03-12T15:11:06</TxDtTm>\n                    <!-- Identificação da transação atribuída pelo POI.\n                         Este campo será ecoado pelo adquirente. -->\n                    <TxRef>06064f516a50483da7f189243c95ccca</TxRef>\n                </TxId>\n                <!-- Identificação da transação definida pela Stone. (ATK)-->\n                <RcptTxId>00000034071000000215353</RcptTxId>\n                <!-- Detalhes da transação. -->\n                <TxDtls>\n                    <!-- Moeda utilizada na transação em conformidade com a ISO 4217.\n                         986 = BRL = Real Brasileiro\n                         http://pt.wikipedia.org/wiki/ISO_4217 -->\n                    <Ccy>986</Ccy>\n                    <!-- Valor total autorizado em centavos. -->\n                    <TtlAmt>100</TtlAmt>\n                    <!-- Modalidade do cartão utilizado na transação.\n                          FIXO: 'CRDT' = Crédito. -->\n                    <AcctTp>CRDT</AcctTp>\n                </TxDtls>\n            </Tx>\n            <!-- Dados de resposta da transação. -->\n            <TxRspn>\n                <!-- Resultado da autorização. -->\n                <AuthstnRslt>\n                    <!-- Dados da resposta da autorização. -->\n                    <RspnToAuthstn>\n                        <!-- Resposta da transação. -->\n                        <Rspn>APPR</Rspn>\n                        <!-- Código de resposta da autorização\n                             (equivalente ao campo 39 da ISO 8583 de 2003). -->\n                        <RspnRsn>0000</RspnRsn>\n                    </RspnToAuthstn>\n                    <!-- Código de autorização retornado pelo emissor. -->\n                    <AuthstnCd>007091</AuthstnCd>\n                    <!-- Indica se a mensagem precisa ser capturada posteriormente. -->\n                    <CmpltnReqrd>false</CmpltnReqrd>\n                </AuthstnRslt>\n            </TxRspn>\n        </AuthstnRspn>\n    </AccptrAuthstnRspn>\n</Document>","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/Authorize"},"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"O que é Autorização ?\"\n}\n[/block]\nA Autorização de uma transação consiste na confirmação advinda do banco emissor do cartão de crédito/débito de que o cliente possui saldo suficiente para realizar a transação em questão.\n\nNa prática, a partir deste momento, parte do saldo do cliente portador do cartão é sensibilizado \n( impedido de ser utilizado ) até que seja realizada a captura ou até que resposta de autorização informando que o cliente não possui saldo suficiente para realizar a transação seja recebida.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"O que é Captura ?\"\n}\n[/block]\nA captura de uma transação é o reconhecimento da autorização da transação pelo sistema de captura do lojista ( E-commerce, POS, Pindpad ). Feito isso, a mensagem de captura é enviada para a adquirente ( STONE ) que, por sua vez, liquida o saldo do cliente.\n\nHá dois tipos de captura:\n\n* **CAPTURA AUTOMÁTICA**\n\nÉ a captura que é configurada para ocorrer automaticamente pelo sistema do cliente assim que a resposta de autorização é recebida \n\n* **CAPTURA POSTERIOR**\n\nOcorre quando a mensagem de captura não é configurada pelo sistema do cliente para ser enviada imediatamente após o recebimento da resposta de autorização. Também é conhecida como captura \"manual\"\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Prazo captura posterior\",\n  \"body\": \"O prazo para realizar a captura posterior é de até **5 DIAS** após o recebimento da mensagem de autorização\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"O que é a Liquidação ?\"\n}\n[/block]\nDe acordo com suas vendas, o cliente gera saldo com a adquirente no valor total de suas vendas. Como a adquirente paga seus clientes ( lojistas ) **LIQUIDANDO O SALDO ACUMULADO DELES ( DEPOSITANDO O SALDO ACUMULADO NA CONTA DO CLIENTE )** o processo de pagamento ao cliente é denominado liquidação.\n\n**TIPOS DE TRANSAÇÃO**\n\n* Débito : \n\nEm geral, a liquidação para transações de débito ocorre em D + 2, ou seja, dois dias depois da captura da transação. \n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Nota\",\n  \"body\": \"Transações de **Débito** não são válidas para o ambiente eletrônico (**Ecommerce**).\"\n}\n[/block]\n* Crédito : \n\nEm geral, a liquidação para transações de débito ocorre em D + 30 para a primeira parcela ( única parcela em caso de crédito à vista ) e em D + 30 x n para a n-ésima parcela.\n\nExemplo : \n\nO cliente realiza uma transação de crédito no valor de R$ 300,00 em 3 vezes. Assumindo que o cliente possui saldo positivo com a adquirente ( STONE ) em todo o período até receber a última parcela, o cliente recebe o valor associado à primeira parcela 30 dias depois da captura da transação, recebe a segunda parcela 60 (2 x 30) dias depois da captura da transação e recebe a última parcela 90 (3 x 30 ) depois da captura da transação. \n\n**EXEMPLOS**\n\nPara esclarecer a liquidação vejamos dois exemplos:\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Nos exemplos abaixo o MDR e juros serão desconsiderados para facilitar o entendimento.\"\n}\n[/block]\n1. **Cliente com saldo positivo** : \n\nCaso o cliente ( lojista ) possua saldo maior ou igual a R$0,00 e realize uma transação de R$ 30,00 ele receberá na data devida de liquidação, caso continue com o saldo de R$ 0,00 ou maior quando a liquidação ocorrer, o valor de R$ 30,00.\n\n2. **Cliente com saldo negativo mesmo após realizar transações** :\n\nUm cliente ( lojista ) realiza uma transação no valor de $50,00 porém como não havia transacionado com frequência, não conseguiu transacionar o suficiente para suprir o valor do aluguel da maquininha e possui atualmente um saldo ACUMULADO NEGATIVO COM A STONE de R$ -  51,00. Quando a liquidação ocorrer o cliente receberá NADA ! \n\nPorque seu saldo se tornará : \n\nSALDO = SALDO ANTERIOR + VALOR DA TRANSAÇÃO = R$ - 51,00 + 50,00 =  R$ -1,00. \n\nEntão, como apenas liquidamos saldo, não iremos retirar esse R$ -1,00 da conta do cliente, esse valor é \"cobrado\" quando a liquidação ocorre, e é deduzido do valor positivo que entra na conta do cliente conforme ocorreu nesse exemplo.\n\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"SALDO COM A ADQUIRENTE VS SALDO COM O BANCO EMISSOR\",\n  \"body\": \"O saldo que foi mencionado no exemplo acima é o saldo do lojista ( cliente ) com o banco emissor, não confundi-lo com o saldo do lojista com o banco emissor ( Itaú, Banco do Brasil, Santander, Bradesco, Caixa, etc ) que é o significado de saldo mais utilizado no dia a dia e que NÃO INFLUENCIA diretamente no valor do saldo do lojista com a STONE.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"AUTORIZAÇÃO COM CAPTURA\"\n}\n[/block]\nA autorização com captura é, provavelmente, um dos casos mais comuns de integração. O cliente chega à loja, escolhe seus produtos, adiciona-os ao carrinho, finaliza o pedido e faz o pagamento. A loja, ao receber a solicitação de finalização do pedido, faz a integração com a Stone, solicita a autorização e faz a captura do valor autorizado automaticamente. É o processo normal da maioria dos ecommerces.\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/78e1d47-autorizacao-e-captura.png\",\n        \"autorizacao-e-captura.png\",\n        732,\n        353,\n        \"#6bc333\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n1. O estabelecimento envia uma mensagem AcceptorAuthorisationRequest para o adquirente solicitando autorização, informando que deseja realizar a captura financeira atribuindo o valor da tag <TxCaptr> como true\n\n2. AcceptorAuthorisationResponse é devolvido pelo adquirente, informando ao estabelecimento sobre o êxito do pedido, uma vez que o adquirente tenha autorizado a transação sem a necessidade de envio de captura.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"A tag TxCaptr deve ser enviada com valor TRUE\"\n}\n[/block]\n**QUANDO ENVIAR?**\n\nEssa operação é utilizada quando o cliente realiza uma compra com o cartão. A seguir, estão as possíveis modalidades de pagamento:\n\n* **À vista** - Consiste no pagamento do valor total da compra\n\n* **Parcelado** - é o pagamento mensal do valor da compra, dividido pelo número escolhido de parcelas. O pagamento é realizado de acordo com a data de faturamento acordadada entre o portador do cartão e o emissor, nos meses subsequentes a compra, até que o valor integral devido seja quitado. É o adquirente ( STONE ) quem controla o número máximo de parcelas desta transação. Deve-se explicitar, porém que existem dois tipos de parcelamentos e ambos possuem juros, a diferença é de quem os juros são cobrados : Do portador do cartão ou lojista.\n\n\n**Tipos de parcelamento**\n\nDurante o credenciamento com a STONE é possível optar pelas seguintes formas de parcelamento de transações:\n\n* **Parcelado emissor** ( Com juros para o portador do cartão ) - Compras realizadas com cartão de crédito, em que o emissor financia o portador do cartão, isto é, o lojista recebe o valor integral 30 dias depois da compra, mas o portador do cartão paga por ela em até 12 vezes. Para o lojista é como uma transação de crédito à vista. Os emissores cobram do portador do cartão os juros e IOF pelo financiamento.\n\n* **Parcelado lojista** ( Sem juros para o portador do cartão ) - Compras realizadas com cartão de crédito, em que a loja financia o portador do cartão. Não são cobrados do portador juros nessa transação. A Stone e o lojista recebem de forma parcelada a cada 30 dias.\n\n\n[block:api-header]\n{\n  \"type\": \"post\",\n  \"title\": \"Authorize\"\n}\n[/block]\nA autorização é o processo de troca de mensagens entre o estabelecimento e o adquirente onde é verificado se portador do cartão possui ou não saldo suficiente para a realização de um pagamento. A diferença entre a mensagem de autorização com captura automática e com captura posterior, está no elemento TxCaptr que deve ser informado true para Autorização com Captura, ou false para Autorização com Captura posterior.\n\n\n**REQUISIÇÃO DE AUTORIZAÇÃO**\n\nA mensagem de AcceptorAuthorisationRequest é enviada pelo estabelecimento para a url [https://e-commerce.stone.com.br/Authorize](https://e-commerce.stone.com.br/Authorize) (produção) ou [https://sandbox-auth-integration.stone.com.br/Authorize](https://sandbox-auth-integration.stone.com.br/Authorize) (homologação) para o adquirente, para checar junto ao banco que a conta associada ao cartão possui recursos para financiar o pagamento. Este controle inclui a validação dos dados do cartão e todos os dados adicionais previstos.\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Campo\",\n    \"h-1\": \"Ocorrência\",\n    \"h-2\": \"Tipo\",\n    \"h-3\": \"Descrição\",\n    \"h-4\": \"Obrigatório\",\n    \"0-1\": \"1\",\n    \"1-1\": \"1\",\n    \"2-1\": \"1\",\n    \"3-1\": \"1\",\n    \"4-1\": \"1\",\n    \"5-1\": \"1\",\n    \"6-1\": \"1\",\n    \"7-1\": \"0 à 1\",\n    \"8-1\": \"1\",\n    \"9-1\": \"1\",\n    \"10-1\": \"1\",\n    \"11-1\": \"1\",\n    \"12-1\": \"0 à 1\",\n    \"13-1\": \"1\",\n    \"14-1\": \"1\",\n    \"15-1\": \"1\",\n    \"16-1\": \"1\",\n    \"17-1\": \"1\",\n    \"18-1\": \"1\",\n    \"19-1\": \"1\",\n    \"20-1\": \"0 à 1\",\n    \"21-1\": \"1\",\n    \"22-1\": \"0 à 1\",\n    \"23-1\": \"1\",\n    \"24-1\": \"1\",\n    \"25-1\": \"1\",\n    \"26-1\": \"1\",\n    \"27-1\": \"1\",\n    \"28-1\": \"1\",\n    \"29-1\": \"1\",\n    \"30-1\": \"0 à 1\",\n    \"31-1\": \"0 à 1\",\n    \"32-1\": \"1\",\n    \"33-1\": \"1\",\n    \"0-0\": \"Header<Hdr>\",\n    \"1-0\": \"ProtocolVersion<PrtcolVrsn>\",\n    \"2-0\": \"AuthorisationRequest<AuthstnReq>\",\n    \"3-0\": \"Environment<Envt>\",\n    \"4-0\": \"Merchant <Mrchnt>\",\n    \"5-0\": \"Identification<ID>\",\n    \"6-0\": \"Identification<ID>\",\n    \"7-0\": \"ShrtNm\",\n    \"8-0\": \"Poi<POI>\",\n    \"9-0\": \"Identification<ID>\",\n    \"10-0\": \"Identification<ID>\",\n    \"11-0\": \"Card<Card>\",\n    \"12-0\": \"PlainCardData<PlainCardData>\",\n    \"13-0\": \"PAN<PAN>\",\n    \"14-0\": \"ExpiryDate<XpryDt>\",\n    \"15-0\": \"CardSctyCd<CardSctyCd>\",\n    \"16-0\": \"CSCVal<CSCVal>\",\n    \"17-0\": \"Context<Cntxt>\",\n    \"18-0\": \"PaymentContext<PmtCntxt>\",\n    \"19-0\": \"CardDataEntryMode<CardDataNtryMd>\",\n    \"20-0\": \"TransactionChannel<TxChanl>\",\n    \"21-0\": \"Transaction<Tx>\",\n    \"22-0\": \"InitiatorTransactionIdentification<InitrTxId>\",\n    \"23-0\": \"TransactionCapture<TxCaptr>\",\n    \"24-0\": \"TransactionIdentification<TxId>\",\n    \"25-0\": \"TransactionDateTime<TxDtTm>\",\n    \"26-0\": \"TransactionReference<TxRef>\",\n    \"27-0\": \"TransactionDetails<TxDtls>\",\n    \"28-0\": \"Currency<Ccy>\",\n    \"29-0\": \"TotalAmount<TtlAmt>\",\n    \"30-0\": \"AccountType<AcctTp>\",\n    \"31-0\": \"RecurringTransaction<RcrngTx>\",\n    \"32-0\": \"InstalmentType<InstlmtTp>\",\n    \"33-0\": \"InstalmentType<InstlmtTp>\",\n    \"0-2\": \"Container\",\n    \"1-2\": \"Text\",\n    \"2-2\": \"Container\",\n    \"3-2\": \"Container\",\n    \"4-2\": \"Container\",\n    \"5-2\": \"Container\",\n    \"6-2\": \"Text\",\n    \"7-2\": \"Text\",\n    \"8-2\": \"Container\",\n    \"9-2\": \"Container\",\n    \"10-2\": \"Text\",\n    \"11-2\": \"Container\",\n    \"12-2\": \"Container\",\n    \"13-2\": \"Text\",\n    \"14-2\": \"Text\",\n    \"15-2\": \"Container\",\n    \"16-2\": \"Text\",\n    \"17-2\": \"Container\",\n    \"18-2\": \"Container\",\n    \"19-2\": \"CodeSet\",\n    \"20-2\": \"CodeSet\",\n    \"21-2\": \"Container\",\n    \"22-2\": \"Text\",\n    \"23-2\": \"Boolean\",\n    \"24-2\": \"Container\",\n    \"25-2\": \"DateTime\",\n    \"26-2\": \"Text\",\n    \"27-2\": \"Container\",\n    \"28-2\": \"CodeSet\",\n    \"29-2\": \"Amount\",\n    \"30-2\": \"CodeSet\",\n    \"31-2\": \"Container\",\n    \"32-2\": \"CodeSet\",\n    \"33-2\": \"Quantity\",\n    \"0-3\": \"Cabeçalho da mensagem.\",\n    \"0-4\": \"Sim\",\n    \"1-4\": \"Sim\",\n    \"2-4\": \"Sim\",\n    \"3-4\": \"Sim\",\n    \"4-4\": \"Sim\",\n    \"5-4\": \"Sim\",\n    \"6-4\": \"Sim\",\n    \"7-4\": \"Não\",\n    \"8-4\": \"Sim\",\n    \"9-4\": \"Sim\",\n    \"10-4\": \"Sim\",\n    \"11-4\": \"Sim\",\n    \"12-4\": \"Não\",\n    \"13-4\": \"Sim\",\n    \"14-4\": \"Sim\",\n    \"15-4\": \"Sim\",\n    \"16-4\": \"Sim\",\n    \"17-4\": \"Sim\",\n    \"18-4\": \"Sim\",\n    \"19-4\": \"Sim\",\n    \"20-4\": \"Sim\",\n    \"21-4\": \"Sim\",\n    \"22-4\": \"Não\",\n    \"23-4\": \"Sim\",\n    \"24-4\": \"Sim\",\n    \"25-4\": \"Sim\",\n    \"26-4\": \"Sim\",\n    \"27-4\": \"Sim\",\n    \"28-4\": \"Sim\",\n    \"29-4\": \"Sim\",\n    \"30-4\": \"Não\",\n    \"31-4\": \"Não\",\n    \"32-4\": \"Sim\",\n    \"33-4\": \"Sim\",\n    \"1-3\": \"Versão do protocolo utilizado na mensagem.\",\n    \"2-3\": \"Dados da requisição de autorização.\",\n    \"3-3\": \"Ambiente da transação.\",\n    \"4-3\": \"Dados do estabelecimento.\",\n    \"5-3\": \"Identificação do estabelecimento comercial.\",\n    \"6-3\": \"Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.\",\n    \"7-3\": \"O nome que aparecerá na fatura. Se a transação for mastercard, o limite é 22 caracteres; Se a transação for visa, o limite é 25 caracteres; Se for parcelado, a visa usa os 8 primeiros caracteres do nome do lojista pra passar a informação de parcelamento, sobrando 17 caracteres.\",\n    \"8-3\": \"Dados do ponto de interação\",\n    \"9-3\": \"Identificação do ponto de interação\",\n    \"10-3\": \"Código de identificação do ponto de interação atribuído pelo estabelecimento.\",\n    \"11-3\": \"Dados do cartão utilizado na transação.\",\n    \"12-3\": \"Dados não criptografados do cartão utilizado na transação.\",\n    \"13-3\": \"Número do cartão. (Primary Account Number)\",\n    \"14-3\": \"Data de validade do cartão no formato “yyyy-MM”.\",\n    \"15-3\": \"Código de segurança do cartão\",\n    \"16-3\": \"CVV estampado no verso do cartão\",\n    \"17-3\": \"Informações da transação a ser realizada.\",\n    \"18-3\": \"Informações sobre o pagamento.\",\n    \"19-3\": \"Modo da entrada dos dados do cartão: PHYS = Ecommerce ou Digitada;\",\n    \"20-3\": \"Tipo do canal de comunicação utilizado na transação. Obs.: Preencher esta tag apenas se CardDataNtryMd = PHYS ou ECOM = Ecommerce ou Digitada\",\n    \"21-3\": \"Informações da transação.\",\n    \"22-3\": \"Identificação da transação definida pelo sistema que se comunica com o Host Stone.\\n\\nTamanho máximo : \\n32 caracteres.\\n\\nEste campo é conhecido internamente na Stone como **ITK** \",\n    \"23-3\": \"Indica se os dados da transação devem ser capturados - true - ou não false - imediatamente.\",\n    \"24-3\": \"Dados de identificação da transação atribuída pelo POI (Ponto de interação).\",\n    \"25-3\": \"Data local e hora da transação atribuídas pelo POI (ponto de interação).\",\n    \"26-3\": \"Identificação da transação definida pelo ponto de interação (POI, estabelecimento, lojista, etc). O formato é livre contendo no máximo 32 caracteres.\",\n    \"27-3\": \"Detalhes da transação.\",\n    \"28-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.\",\n    \"29-3\": \"Valor total da transação em centavos.\",\n    \"30-3\": \"Modalidade do cartão utilizado na transação. \\n**Fixo**: **CRDT **= Crédito.\",\n    \"31-3\": \"Os dados relativos à(s) parcela(s) ou a uma transação recorrente.\",\n    \"32-3\": \"Tipo de parcelamento. \\nNONE = Nenhum e\\nMCHT = Lojista\",\n    \"33-3\": \"Número do total de parcelas.\",\n    \"h-5\": \"Tamanho\",\n    \"0-5\": \"-\",\n    \"1-5\": \"an ... 6\",\n    \"2-5\": \"-\",\n    \"3-5\": \"-\",\n    \"4-5\": \"-\",\n    \"5-5\": \"an 32\"\n  },\n  \"cols\": 5,\n  \"rows\": 34\n}\n[/block]\n**RESPOSTA DE AUTORIZAÇÃO**\n\nA mensagem AcceptorAuthorisationResponse é enviada pelo adquirente, para retornar o resultado da validação realizada pelo emissor sobre a operação de pagamento.\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Campo\",\n    \"h-1\": \"Ocorrência\",\n    \"h-2\": \"Tipo\",\n    \"h-3\": \"Descrição\",\n    \"h-4\": \"Obrigatório\",\n    \"0-0\": \"Header<Hdr>\",\n    \"1-0\": \"MessageFunction<MsgFctn>\",\n    \"2-0\": \"ProtocolVersion<PrtcolVrsn>\",\n    \"3-0\": \"CreationDateTime<CreDtTm>\",\n    \"4-0\": \"TraceDateTimeOut<TracDtTmOut>\",\n    \"5-0\": \"AuthorisationResponse<AuthstnRspn>\",\n    \"6-0\": \"Environment<Envt>\",\n    \"7-0\": \"Merchant Identification<MrchntId>\",\n    \"8-0\": \"Identification<Id>\",\n    \"9-0\": \"POIId<POIId>\",\n    \"10-0\": \"Identification<Id>\",\n    \"11-0\": \"Transaction<Tx>\",\n    \"12-0\": \"TransactionIdentification<TxId>\",\n    \"13-0\": \"TransactionDateTime<TxDtTm>\",\n    \"14-0\": \"TransactionReference<TxRef>\",\n    \"15-0\": \"RecipientTransactionIdentification<RcptTxId>\",\n    \"16-0\": \"TransactionDetails<TxDtls>\",\n    \"17-0\": \"Currency<Ccy>\",\n    \"18-0\": \"TotalAmount<TtlAmt>\",\n    \"19-0\": \"AccountType<AcctTp>\",\n    \"20-0\": \"TransactionResponse<TxRspn>\",\n    \"21-0\": \"AuthorisationResult<AuthstnRslt>\",\n    \"22-0\": \"ResponseToAuthorisation<RspnToAuthstn>\",\n    \"23-0\": \"Response<Rspn>\",\n    \"24-0\": \"ResponseReason<RspnRsn>\",\n    \"25-0\": \"AuthorisationCode<AuthstnCd>\",\n    \"26-0\": \"CompletionRequired<CmpltnReqrd>\",\n    \"0-1\": \"1\",\n    \"1-1\": \"1\",\n    \"2-1\": \"1\",\n    \"3-1\": \"1\",\n    \"4-1\": \"1\",\n    \"5-1\": \"1\",\n    \"6-1\": \"1\",\n    \"7-1\": \"1\",\n    \"8-1\": \"1\",\n    \"9-1\": \"0 à 1\",\n    \"10-1\": \"1\",\n    \"11-1\": \"1\",\n    \"12-1\": \"1\",\n    \"13-1\": \"1\",\n    \"14-1\": \"1\",\n    \"15-1\": \"1\",\n    \"16-1\": \"1\",\n    \"17-1\": \"1\",\n    \"18-1\": \"1\",\n    \"19-1\": \"0 à 1\",\n    \"20-1\": \"1\",\n    \"21-1\": \"1\",\n    \"22-1\": \"1\",\n    \"23-1\": \"1\",\n    \"24-1\": \"1\",\n    \"25-1\": \"0 à 1\",\n    \"26-1\": \"0 à 1\",\n    \"0-4\": \"Sim\",\n    \"1-4\": \"Sim\",\n    \"2-4\": \"Sim\",\n    \"3-4\": \"Sim\",\n    \"5-4\": \"Sim\",\n    \"4-4\": \"Sim\",\n    \"6-4\": \"Sim\",\n    \"7-4\": \"Sim\",\n    \"8-4\": \"Sim\",\n    \"9-4\": \"Não\",\n    \"10-4\": \"Sim\",\n    \"11-4\": \"Sim\",\n    \"12-4\": \"Sim\",\n    \"13-4\": \"Sim\",\n    \"14-4\": \"Sim\",\n    \"15-4\": \"Sim\",\n    \"16-4\": \"Sim\",\n    \"17-4\": \"Sim\",\n    \"18-4\": \"Sim\",\n    \"19-4\": \"Não\",\n    \"20-4\": \"Sim\",\n    \"21-4\": \"Sim\",\n    \"22-4\": \"Sim\",\n    \"23-4\": \"Sim\",\n    \"24-4\": \"Sim\",\n    \"25-4\": \"Não\",\n    \"26-4\": \"Não\",\n    \"0-2\": \"Container\",\n    \"1-2\": \"CodeSet\",\n    \"2-2\": \"Text\",\n    \"3-2\": \"Text\",\n    \"4-2\": \"DateTime\",\n    \"5-2\": \"Container\",\n    \"6-2\": \"Container\",\n    \"7-2\": \"Container\",\n    \"8-2\": \"Text\",\n    \"9-2\": \"Container\",\n    \"10-2\": \"Text\",\n    \"11-2\": \"Container\",\n    \"12-2\": \"Container\",\n    \"13-2\": \"DateTime\",\n    \"14-2\": \"Text\",\n    \"15-2\": \"Text\",\n    \"16-2\": \"Container\",\n    \"17-2\": \"CodeSet\",\n    \"18-2\": \"Amount\",\n    \"19-2\": \"CodeSet\",\n    \"20-2\": \"Container\",\n    \"21-2\": \"Container\",\n    \"22-2\": \"Container\",\n    \"23-2\": \"CodeSet\",\n    \"24-2\": \"Text\",\n    \"25-2\": \"Text\",\n    \"26-2\": \"Boolean\",\n    \"0-3\": \"Cabeçalho da mensagem\",\n    \"1-3\": \"Identifica o tipo de processo em que a mensagem se propõe. Fixo: AUTP = AuthorisationResponse.\",\n    \"2-3\": \"Versão do protocolo utilizado na mensagem.\",\n    \"3-3\": \"Data de criação da mensagem\",\n    \"4-3\": \"Data e hora da saída da mensagem no Host Stone.\",\n    \"5-3\": \"Informações relacionadas à resposta da autorização.\",\n    \"6-3\": \"Ambiente da transação.\",\n    \"7-3\": \"Dados do estabelecimento.\",\n    \"8-3\": \"Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.\",\n    \"9-3\": \"Dados do ponto de interação.\",\n    \"10-3\": \"Identificação do POI.\",\n    \"11-3\": \"Informações da transação.\",\n    \"12-3\": \"Dados de identificação da transação atribuída pelo POI (Ponto de interação).\",\n    \"13-3\": \"Data local e hora da transação atribuído pelo POI (ponto de interação). Este campo será ecoado pelo adquirente.\",\n    \"14-3\": \"Identificação da transação atribuída pelo POI (Ponto de interação). Este campo será ecoado pelo adquirente.\",\n    \"15-3\": \"Identificação da transação definida pela Stone.\\n\\nEste campo é conhecido internamente na Stone como **ATK** \",\n    \"16-3\": \"Detalhes da transação.\",\n    \"17-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.\",\n    \"18-3\": \"Valor total autorizado em centavos.\",\n    \"19-3\": \"Modalidade do cartão utilizado na transação. CRDT = Crédito.\",\n    \"20-3\": \"Dados de resposta da transação.\",\n    \"21-3\": \"Resultado da autorização.\",\n    \"22-3\": \"Dados da resposta da autorização.\",\n    \"23-3\": \"Resposta da transação: DECL: Declined, APPR: Aproved, PART: PartialApproved e TECH: TechinicalError.\",\n    \"24-3\": \"Código de resposta da autorização (equivalente ao campo 39 da ISO 8583 de 2003).\",\n    \"25-3\": \"Código de autorização retornado pelo emissor.\",\n    \"26-3\": \"Indica se a mensagem precisa ser capturada posteriormente.\"\n  },\n  \"cols\": 4,\n  \"rows\": 27\n}\n[/block]","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:30:10.779Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":6,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"mensagens-de-autorização","sync_unique":"","title":"Mensagens de Autorização","type":"post","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

postMensagens de Autorização


[block:api-header] { "type": "basic", "title": "O que é Autorização ?" } [/block] A Autorização de uma transação consiste na confirmação advinda do banco emissor do cartão de crédito/débito de que o cliente possui saldo suficiente para realizar a transação em questão. Na prática, a partir deste momento, parte do saldo do cliente portador do cartão é sensibilizado ( impedido de ser utilizado ) até que seja realizada a captura ou até que resposta de autorização informando que o cliente não possui saldo suficiente para realizar a transação seja recebida. [block:api-header] { "type": "basic", "title": "O que é Captura ?" } [/block] A captura de uma transação é o reconhecimento da autorização da transação pelo sistema de captura do lojista ( E-commerce, POS, Pindpad ). Feito isso, a mensagem de captura é enviada para a adquirente ( STONE ) que, por sua vez, liquida o saldo do cliente. Há dois tipos de captura: * **CAPTURA AUTOMÁTICA** É a captura que é configurada para ocorrer automaticamente pelo sistema do cliente assim que a resposta de autorização é recebida * **CAPTURA POSTERIOR** Ocorre quando a mensagem de captura não é configurada pelo sistema do cliente para ser enviada imediatamente após o recebimento da resposta de autorização. Também é conhecida como captura "manual" [block:callout] { "type": "warning", "title": "Prazo captura posterior", "body": "O prazo para realizar a captura posterior é de até **5 DIAS** após o recebimento da mensagem de autorização" } [/block] [block:api-header] { "type": "basic", "title": "O que é a Liquidação ?" } [/block] De acordo com suas vendas, o cliente gera saldo com a adquirente no valor total de suas vendas. Como a adquirente paga seus clientes ( lojistas ) **LIQUIDANDO O SALDO ACUMULADO DELES ( DEPOSITANDO O SALDO ACUMULADO NA CONTA DO CLIENTE )** o processo de pagamento ao cliente é denominado liquidação. **TIPOS DE TRANSAÇÃO** * Débito : Em geral, a liquidação para transações de débito ocorre em D + 2, ou seja, dois dias depois da captura da transação. [block:callout] { "type": "danger", "title": "Nota", "body": "Transações de **Débito** não são válidas para o ambiente eletrônico (**Ecommerce**)." } [/block] * Crédito : Em geral, a liquidação para transações de débito ocorre em D + 30 para a primeira parcela ( única parcela em caso de crédito à vista ) e em D + 30 x n para a n-ésima parcela. Exemplo : O cliente realiza uma transação de crédito no valor de R$ 300,00 em 3 vezes. Assumindo que o cliente possui saldo positivo com a adquirente ( STONE ) em todo o período até receber a última parcela, o cliente recebe o valor associado à primeira parcela 30 dias depois da captura da transação, recebe a segunda parcela 60 (2 x 30) dias depois da captura da transação e recebe a última parcela 90 (3 x 30 ) depois da captura da transação. **EXEMPLOS** Para esclarecer a liquidação vejamos dois exemplos: [block:callout] { "type": "warning", "body": "Nos exemplos abaixo o MDR e juros serão desconsiderados para facilitar o entendimento." } [/block] 1. **Cliente com saldo positivo** : Caso o cliente ( lojista ) possua saldo maior ou igual a R$0,00 e realize uma transação de R$ 30,00 ele receberá na data devida de liquidação, caso continue com o saldo de R$ 0,00 ou maior quando a liquidação ocorrer, o valor de R$ 30,00. 2. **Cliente com saldo negativo mesmo após realizar transações** : Um cliente ( lojista ) realiza uma transação no valor de $50,00 porém como não havia transacionado com frequência, não conseguiu transacionar o suficiente para suprir o valor do aluguel da maquininha e possui atualmente um saldo ACUMULADO NEGATIVO COM A STONE de R$ - 51,00. Quando a liquidação ocorrer o cliente receberá NADA ! Porque seu saldo se tornará : SALDO = SALDO ANTERIOR + VALOR DA TRANSAÇÃO = R$ - 51,00 + 50,00 = R$ -1,00. Então, como apenas liquidamos saldo, não iremos retirar esse R$ -1,00 da conta do cliente, esse valor é "cobrado" quando a liquidação ocorre, e é deduzido do valor positivo que entra na conta do cliente conforme ocorreu nesse exemplo. [block:callout] { "type": "danger", "title": "SALDO COM A ADQUIRENTE VS SALDO COM O BANCO EMISSOR", "body": "O saldo que foi mencionado no exemplo acima é o saldo do lojista ( cliente ) com o banco emissor, não confundi-lo com o saldo do lojista com o banco emissor ( Itaú, Banco do Brasil, Santander, Bradesco, Caixa, etc ) que é o significado de saldo mais utilizado no dia a dia e que NÃO INFLUENCIA diretamente no valor do saldo do lojista com a STONE." } [/block] [block:api-header] { "type": "basic", "title": "AUTORIZAÇÃO COM CAPTURA" } [/block] A autorização com captura é, provavelmente, um dos casos mais comuns de integração. O cliente chega à loja, escolhe seus produtos, adiciona-os ao carrinho, finaliza o pedido e faz o pagamento. A loja, ao receber a solicitação de finalização do pedido, faz a integração com a Stone, solicita a autorização e faz a captura do valor autorizado automaticamente. É o processo normal da maioria dos ecommerces. [block:image] { "images": [ { "image": [ "https://files.readme.io/78e1d47-autorizacao-e-captura.png", "autorizacao-e-captura.png", 732, 353, "#6bc333" ], "sizing": "full" } ] } [/block] 1. O estabelecimento envia uma mensagem AcceptorAuthorisationRequest para o adquirente solicitando autorização, informando que deseja realizar a captura financeira atribuindo o valor da tag <TxCaptr> como true 2. AcceptorAuthorisationResponse é devolvido pelo adquirente, informando ao estabelecimento sobre o êxito do pedido, uma vez que o adquirente tenha autorizado a transação sem a necessidade de envio de captura. [block:callout] { "type": "info", "body": "A tag TxCaptr deve ser enviada com valor TRUE" } [/block] **QUANDO ENVIAR?** Essa operação é utilizada quando o cliente realiza uma compra com o cartão. A seguir, estão as possíveis modalidades de pagamento: * **À vista** - Consiste no pagamento do valor total da compra * **Parcelado** - é o pagamento mensal do valor da compra, dividido pelo número escolhido de parcelas. O pagamento é realizado de acordo com a data de faturamento acordadada entre o portador do cartão e o emissor, nos meses subsequentes a compra, até que o valor integral devido seja quitado. É o adquirente ( STONE ) quem controla o número máximo de parcelas desta transação. Deve-se explicitar, porém que existem dois tipos de parcelamentos e ambos possuem juros, a diferença é de quem os juros são cobrados : Do portador do cartão ou lojista. **Tipos de parcelamento** Durante o credenciamento com a STONE é possível optar pelas seguintes formas de parcelamento de transações: * **Parcelado emissor** ( Com juros para o portador do cartão ) - Compras realizadas com cartão de crédito, em que o emissor financia o portador do cartão, isto é, o lojista recebe o valor integral 30 dias depois da compra, mas o portador do cartão paga por ela em até 12 vezes. Para o lojista é como uma transação de crédito à vista. Os emissores cobram do portador do cartão os juros e IOF pelo financiamento. * **Parcelado lojista** ( Sem juros para o portador do cartão ) - Compras realizadas com cartão de crédito, em que a loja financia o portador do cartão. Não são cobrados do portador juros nessa transação. A Stone e o lojista recebem de forma parcelada a cada 30 dias. [block:api-header] { "type": "post", "title": "Authorize" } [/block] A autorização é o processo de troca de mensagens entre o estabelecimento e o adquirente onde é verificado se portador do cartão possui ou não saldo suficiente para a realização de um pagamento. A diferença entre a mensagem de autorização com captura automática e com captura posterior, está no elemento TxCaptr que deve ser informado true para Autorização com Captura, ou false para Autorização com Captura posterior. **REQUISIÇÃO DE AUTORIZAÇÃO** A mensagem de AcceptorAuthorisationRequest é enviada pelo estabelecimento para a url [https://e-commerce.stone.com.br/Authorize](https://e-commerce.stone.com.br/Authorize) (produção) ou [https://sandbox-auth-integration.stone.com.br/Authorize](https://sandbox-auth-integration.stone.com.br/Authorize) (homologação) para o adquirente, para checar junto ao banco que a conta associada ao cartão possui recursos para financiar o pagamento. Este controle inclui a validação dos dados do cartão e todos os dados adicionais previstos. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "0 à 1", "8-1": "1", "9-1": "1", "10-1": "1", "11-1": "1", "12-1": "0 à 1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "1", "20-1": "0 à 1", "21-1": "1", "22-1": "0 à 1", "23-1": "1", "24-1": "1", "25-1": "1", "26-1": "1", "27-1": "1", "28-1": "1", "29-1": "1", "30-1": "0 à 1", "31-1": "0 à 1", "32-1": "1", "33-1": "1", "0-0": "Header<Hdr>", "1-0": "ProtocolVersion<PrtcolVrsn>", "2-0": "AuthorisationRequest<AuthstnReq>", "3-0": "Environment<Envt>", "4-0": "Merchant <Mrchnt>", "5-0": "Identification<ID>", "6-0": "Identification<ID>", "7-0": "ShrtNm", "8-0": "Poi<POI>", "9-0": "Identification<ID>", "10-0": "Identification<ID>", "11-0": "Card<Card>", "12-0": "PlainCardData<PlainCardData>", "13-0": "PAN<PAN>", "14-0": "ExpiryDate<XpryDt>", "15-0": "CardSctyCd<CardSctyCd>", "16-0": "CSCVal<CSCVal>", "17-0": "Context<Cntxt>", "18-0": "PaymentContext<PmtCntxt>", "19-0": "CardDataEntryMode<CardDataNtryMd>", "20-0": "TransactionChannel<TxChanl>", "21-0": "Transaction<Tx>", "22-0": "InitiatorTransactionIdentification<InitrTxId>", "23-0": "TransactionCapture<TxCaptr>", "24-0": "TransactionIdentification<TxId>", "25-0": "TransactionDateTime<TxDtTm>", "26-0": "TransactionReference<TxRef>", "27-0": "TransactionDetails<TxDtls>", "28-0": "Currency<Ccy>", "29-0": "TotalAmount<TtlAmt>", "30-0": "AccountType<AcctTp>", "31-0": "RecurringTransaction<RcrngTx>", "32-0": "InstalmentType<InstlmtTp>", "33-0": "InstalmentType<InstlmtTp>", "0-2": "Container", "1-2": "Text", "2-2": "Container", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Text", "7-2": "Text", "8-2": "Container", "9-2": "Container", "10-2": "Text", "11-2": "Container", "12-2": "Container", "13-2": "Text", "14-2": "Text", "15-2": "Container", "16-2": "Text", "17-2": "Container", "18-2": "Container", "19-2": "CodeSet", "20-2": "CodeSet", "21-2": "Container", "22-2": "Text", "23-2": "Boolean", "24-2": "Container", "25-2": "DateTime", "26-2": "Text", "27-2": "Container", "28-2": "CodeSet", "29-2": "Amount", "30-2": "CodeSet", "31-2": "Container", "32-2": "CodeSet", "33-2": "Quantity", "0-3": "Cabeçalho da mensagem.", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Não", "8-4": "Sim", "9-4": "Sim", "10-4": "Sim", "11-4": "Sim", "12-4": "Não", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "17-4": "Sim", "18-4": "Sim", "19-4": "Sim", "20-4": "Sim", "21-4": "Sim", "22-4": "Não", "23-4": "Sim", "24-4": "Sim", "25-4": "Sim", "26-4": "Sim", "27-4": "Sim", "28-4": "Sim", "29-4": "Sim", "30-4": "Não", "31-4": "Não", "32-4": "Sim", "33-4": "Sim", "1-3": "Versão do protocolo utilizado na mensagem.", "2-3": "Dados da requisição de autorização.", "3-3": "Ambiente da transação.", "4-3": "Dados do estabelecimento.", "5-3": "Identificação do estabelecimento comercial.", "6-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.", "7-3": "O nome que aparecerá na fatura. Se a transação for mastercard, o limite é 22 caracteres; Se a transação for visa, o limite é 25 caracteres; Se for parcelado, a visa usa os 8 primeiros caracteres do nome do lojista pra passar a informação de parcelamento, sobrando 17 caracteres.", "8-3": "Dados do ponto de interação", "9-3": "Identificação do ponto de interação", "10-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento.", "11-3": "Dados do cartão utilizado na transação.", "12-3": "Dados não criptografados do cartão utilizado na transação.", "13-3": "Número do cartão. (Primary Account Number)", "14-3": "Data de validade do cartão no formato “yyyy-MM”.", "15-3": "Código de segurança do cartão", "16-3": "CVV estampado no verso do cartão", "17-3": "Informações da transação a ser realizada.", "18-3": "Informações sobre o pagamento.", "19-3": "Modo da entrada dos dados do cartão: PHYS = Ecommerce ou Digitada;", "20-3": "Tipo do canal de comunicação utilizado na transação. Obs.: Preencher esta tag apenas se CardDataNtryMd = PHYS ou ECOM = Ecommerce ou Digitada", "21-3": "Informações da transação.", "22-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n\nTamanho máximo : \n32 caracteres.\n\nEste campo é conhecido internamente na Stone como **ITK** ", "23-3": "Indica se os dados da transação devem ser capturados - true - ou não false - imediatamente.", "24-3": "Dados de identificação da transação atribuída pelo POI (Ponto de interação).", "25-3": "Data local e hora da transação atribuídas pelo POI (ponto de interação).", "26-3": "Identificação da transação definida pelo ponto de interação (POI, estabelecimento, lojista, etc). O formato é livre contendo no máximo 32 caracteres.", "27-3": "Detalhes da transação.", "28-3": "Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.", "29-3": "Valor total da transação em centavos.", "30-3": "Modalidade do cartão utilizado na transação. \n**Fixo**: **CRDT **= Crédito.", "31-3": "Os dados relativos à(s) parcela(s) ou a uma transação recorrente.", "32-3": "Tipo de parcelamento. \nNONE = Nenhum e\nMCHT = Lojista", "33-3": "Número do total de parcelas.", "h-5": "Tamanho", "0-5": "-", "1-5": "an ... 6", "2-5": "-", "3-5": "-", "4-5": "-", "5-5": "an 32" }, "cols": 5, "rows": 34 } [/block] **RESPOSTA DE AUTORIZAÇÃO** A mensagem AcceptorAuthorisationResponse é enviada pelo adquirente, para retornar o resultado da validação realizada pelo emissor sobre a operação de pagamento. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "ProtocolVersion<PrtcolVrsn>", "3-0": "CreationDateTime<CreDtTm>", "4-0": "TraceDateTimeOut<TracDtTmOut>", "5-0": "AuthorisationResponse<AuthstnRspn>", "6-0": "Environment<Envt>", "7-0": "Merchant Identification<MrchntId>", "8-0": "Identification<Id>", "9-0": "POIId<POIId>", "10-0": "Identification<Id>", "11-0": "Transaction<Tx>", "12-0": "TransactionIdentification<TxId>", "13-0": "TransactionDateTime<TxDtTm>", "14-0": "TransactionReference<TxRef>", "15-0": "RecipientTransactionIdentification<RcptTxId>", "16-0": "TransactionDetails<TxDtls>", "17-0": "Currency<Ccy>", "18-0": "TotalAmount<TtlAmt>", "19-0": "AccountType<AcctTp>", "20-0": "TransactionResponse<TxRspn>", "21-0": "AuthorisationResult<AuthstnRslt>", "22-0": "ResponseToAuthorisation<RspnToAuthstn>", "23-0": "Response<Rspn>", "24-0": "ResponseReason<RspnRsn>", "25-0": "AuthorisationCode<AuthstnCd>", "26-0": "CompletionRequired<CmpltnReqrd>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "8-1": "1", "9-1": "0 à 1", "10-1": "1", "11-1": "1", "12-1": "1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "0 à 1", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "1", "24-1": "1", "25-1": "0 à 1", "26-1": "0 à 1", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "5-4": "Sim", "4-4": "Sim", "6-4": "Sim", "7-4": "Sim", "8-4": "Sim", "9-4": "Não", "10-4": "Sim", "11-4": "Sim", "12-4": "Sim", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "17-4": "Sim", "18-4": "Sim", "19-4": "Não", "20-4": "Sim", "21-4": "Sim", "22-4": "Sim", "23-4": "Sim", "24-4": "Sim", "25-4": "Não", "26-4": "Não", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Text", "4-2": "DateTime", "5-2": "Container", "6-2": "Container", "7-2": "Container", "8-2": "Text", "9-2": "Container", "10-2": "Text", "11-2": "Container", "12-2": "Container", "13-2": "DateTime", "14-2": "Text", "15-2": "Text", "16-2": "Container", "17-2": "CodeSet", "18-2": "Amount", "19-2": "CodeSet", "20-2": "Container", "21-2": "Container", "22-2": "Container", "23-2": "CodeSet", "24-2": "Text", "25-2": "Text", "26-2": "Boolean", "0-3": "Cabeçalho da mensagem", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. Fixo: AUTP = AuthorisationResponse.", "2-3": "Versão do protocolo utilizado na mensagem.", "3-3": "Data de criação da mensagem", "4-3": "Data e hora da saída da mensagem no Host Stone.", "5-3": "Informações relacionadas à resposta da autorização.", "6-3": "Ambiente da transação.", "7-3": "Dados do estabelecimento.", "8-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.", "9-3": "Dados do ponto de interação.", "10-3": "Identificação do POI.", "11-3": "Informações da transação.", "12-3": "Dados de identificação da transação atribuída pelo POI (Ponto de interação).", "13-3": "Data local e hora da transação atribuído pelo POI (ponto de interação). Este campo será ecoado pelo adquirente.", "14-3": "Identificação da transação atribuída pelo POI (Ponto de interação). Este campo será ecoado pelo adquirente.", "15-3": "Identificação da transação definida pela Stone.\n\nEste campo é conhecido internamente na Stone como **ATK** ", "16-3": "Detalhes da transação.", "17-3": "Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.", "18-3": "Valor total autorizado em centavos.", "19-3": "Modalidade do cartão utilizado na transação. CRDT = Crédito.", "20-3": "Dados de resposta da transação.", "21-3": "Resultado da autorização.", "22-3": "Dados da resposta da autorização.", "23-3": "Resposta da transação: DECL: Declined, APPR: Aproved, PART: PartialApproved e TECH: TechinicalError.", "24-3": "Código de resposta da autorização (equivalente ao campo 39 da ISO 8583 de 2003).", "25-3": "Código de autorização retornado pelo emissor.", "26-3": "Indica se a mensagem precisa ser capturada posteriormente." }, "cols": 4, "rows": 27 } [/block]

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



[block:api-header] { "type": "basic", "title": "O que é Autorização ?" } [/block] A Autorização de uma transação consiste na confirmação advinda do banco emissor do cartão de crédito/débito de que o cliente possui saldo suficiente para realizar a transação em questão. Na prática, a partir deste momento, parte do saldo do cliente portador do cartão é sensibilizado ( impedido de ser utilizado ) até que seja realizada a captura ou até que resposta de autorização informando que o cliente não possui saldo suficiente para realizar a transação seja recebida. [block:api-header] { "type": "basic", "title": "O que é Captura ?" } [/block] A captura de uma transação é o reconhecimento da autorização da transação pelo sistema de captura do lojista ( E-commerce, POS, Pindpad ). Feito isso, a mensagem de captura é enviada para a adquirente ( STONE ) que, por sua vez, liquida o saldo do cliente. Há dois tipos de captura: * **CAPTURA AUTOMÁTICA** É a captura que é configurada para ocorrer automaticamente pelo sistema do cliente assim que a resposta de autorização é recebida * **CAPTURA POSTERIOR** Ocorre quando a mensagem de captura não é configurada pelo sistema do cliente para ser enviada imediatamente após o recebimento da resposta de autorização. Também é conhecida como captura "manual" [block:callout] { "type": "warning", "title": "Prazo captura posterior", "body": "O prazo para realizar a captura posterior é de até **5 DIAS** após o recebimento da mensagem de autorização" } [/block] [block:api-header] { "type": "basic", "title": "O que é a Liquidação ?" } [/block] De acordo com suas vendas, o cliente gera saldo com a adquirente no valor total de suas vendas. Como a adquirente paga seus clientes ( lojistas ) **LIQUIDANDO O SALDO ACUMULADO DELES ( DEPOSITANDO O SALDO ACUMULADO NA CONTA DO CLIENTE )** o processo de pagamento ao cliente é denominado liquidação. **TIPOS DE TRANSAÇÃO** * Débito : Em geral, a liquidação para transações de débito ocorre em D + 2, ou seja, dois dias depois da captura da transação. [block:callout] { "type": "danger", "title": "Nota", "body": "Transações de **Débito** não são válidas para o ambiente eletrônico (**Ecommerce**)." } [/block] * Crédito : Em geral, a liquidação para transações de débito ocorre em D + 30 para a primeira parcela ( única parcela em caso de crédito à vista ) e em D + 30 x n para a n-ésima parcela. Exemplo : O cliente realiza uma transação de crédito no valor de R$ 300,00 em 3 vezes. Assumindo que o cliente possui saldo positivo com a adquirente ( STONE ) em todo o período até receber a última parcela, o cliente recebe o valor associado à primeira parcela 30 dias depois da captura da transação, recebe a segunda parcela 60 (2 x 30) dias depois da captura da transação e recebe a última parcela 90 (3 x 30 ) depois da captura da transação. **EXEMPLOS** Para esclarecer a liquidação vejamos dois exemplos: [block:callout] { "type": "warning", "body": "Nos exemplos abaixo o MDR e juros serão desconsiderados para facilitar o entendimento." } [/block] 1. **Cliente com saldo positivo** : Caso o cliente ( lojista ) possua saldo maior ou igual a R$0,00 e realize uma transação de R$ 30,00 ele receberá na data devida de liquidação, caso continue com o saldo de R$ 0,00 ou maior quando a liquidação ocorrer, o valor de R$ 30,00. 2. **Cliente com saldo negativo mesmo após realizar transações** : Um cliente ( lojista ) realiza uma transação no valor de $50,00 porém como não havia transacionado com frequência, não conseguiu transacionar o suficiente para suprir o valor do aluguel da maquininha e possui atualmente um saldo ACUMULADO NEGATIVO COM A STONE de R$ - 51,00. Quando a liquidação ocorrer o cliente receberá NADA ! Porque seu saldo se tornará : SALDO = SALDO ANTERIOR + VALOR DA TRANSAÇÃO = R$ - 51,00 + 50,00 = R$ -1,00. Então, como apenas liquidamos saldo, não iremos retirar esse R$ -1,00 da conta do cliente, esse valor é "cobrado" quando a liquidação ocorre, e é deduzido do valor positivo que entra na conta do cliente conforme ocorreu nesse exemplo. [block:callout] { "type": "danger", "title": "SALDO COM A ADQUIRENTE VS SALDO COM O BANCO EMISSOR", "body": "O saldo que foi mencionado no exemplo acima é o saldo do lojista ( cliente ) com o banco emissor, não confundi-lo com o saldo do lojista com o banco emissor ( Itaú, Banco do Brasil, Santander, Bradesco, Caixa, etc ) que é o significado de saldo mais utilizado no dia a dia e que NÃO INFLUENCIA diretamente no valor do saldo do lojista com a STONE." } [/block] [block:api-header] { "type": "basic", "title": "AUTORIZAÇÃO COM CAPTURA" } [/block] A autorização com captura é, provavelmente, um dos casos mais comuns de integração. O cliente chega à loja, escolhe seus produtos, adiciona-os ao carrinho, finaliza o pedido e faz o pagamento. A loja, ao receber a solicitação de finalização do pedido, faz a integração com a Stone, solicita a autorização e faz a captura do valor autorizado automaticamente. É o processo normal da maioria dos ecommerces. [block:image] { "images": [ { "image": [ "https://files.readme.io/78e1d47-autorizacao-e-captura.png", "autorizacao-e-captura.png", 732, 353, "#6bc333" ], "sizing": "full" } ] } [/block] 1. O estabelecimento envia uma mensagem AcceptorAuthorisationRequest para o adquirente solicitando autorização, informando que deseja realizar a captura financeira atribuindo o valor da tag <TxCaptr> como true 2. AcceptorAuthorisationResponse é devolvido pelo adquirente, informando ao estabelecimento sobre o êxito do pedido, uma vez que o adquirente tenha autorizado a transação sem a necessidade de envio de captura. [block:callout] { "type": "info", "body": "A tag TxCaptr deve ser enviada com valor TRUE" } [/block] **QUANDO ENVIAR?** Essa operação é utilizada quando o cliente realiza uma compra com o cartão. A seguir, estão as possíveis modalidades de pagamento: * **À vista** - Consiste no pagamento do valor total da compra * **Parcelado** - é o pagamento mensal do valor da compra, dividido pelo número escolhido de parcelas. O pagamento é realizado de acordo com a data de faturamento acordadada entre o portador do cartão e o emissor, nos meses subsequentes a compra, até que o valor integral devido seja quitado. É o adquirente ( STONE ) quem controla o número máximo de parcelas desta transação. Deve-se explicitar, porém que existem dois tipos de parcelamentos e ambos possuem juros, a diferença é de quem os juros são cobrados : Do portador do cartão ou lojista. **Tipos de parcelamento** Durante o credenciamento com a STONE é possível optar pelas seguintes formas de parcelamento de transações: * **Parcelado emissor** ( Com juros para o portador do cartão ) - Compras realizadas com cartão de crédito, em que o emissor financia o portador do cartão, isto é, o lojista recebe o valor integral 30 dias depois da compra, mas o portador do cartão paga por ela em até 12 vezes. Para o lojista é como uma transação de crédito à vista. Os emissores cobram do portador do cartão os juros e IOF pelo financiamento. * **Parcelado lojista** ( Sem juros para o portador do cartão ) - Compras realizadas com cartão de crédito, em que a loja financia o portador do cartão. Não são cobrados do portador juros nessa transação. A Stone e o lojista recebem de forma parcelada a cada 30 dias. [block:api-header] { "type": "post", "title": "Authorize" } [/block] A autorização é o processo de troca de mensagens entre o estabelecimento e o adquirente onde é verificado se portador do cartão possui ou não saldo suficiente para a realização de um pagamento. A diferença entre a mensagem de autorização com captura automática e com captura posterior, está no elemento TxCaptr que deve ser informado true para Autorização com Captura, ou false para Autorização com Captura posterior. **REQUISIÇÃO DE AUTORIZAÇÃO** A mensagem de AcceptorAuthorisationRequest é enviada pelo estabelecimento para a url [https://e-commerce.stone.com.br/Authorize](https://e-commerce.stone.com.br/Authorize) (produção) ou [https://sandbox-auth-integration.stone.com.br/Authorize](https://sandbox-auth-integration.stone.com.br/Authorize) (homologação) para o adquirente, para checar junto ao banco que a conta associada ao cartão possui recursos para financiar o pagamento. Este controle inclui a validação dos dados do cartão e todos os dados adicionais previstos. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "0 à 1", "8-1": "1", "9-1": "1", "10-1": "1", "11-1": "1", "12-1": "0 à 1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "1", "20-1": "0 à 1", "21-1": "1", "22-1": "0 à 1", "23-1": "1", "24-1": "1", "25-1": "1", "26-1": "1", "27-1": "1", "28-1": "1", "29-1": "1", "30-1": "0 à 1", "31-1": "0 à 1", "32-1": "1", "33-1": "1", "0-0": "Header<Hdr>", "1-0": "ProtocolVersion<PrtcolVrsn>", "2-0": "AuthorisationRequest<AuthstnReq>", "3-0": "Environment<Envt>", "4-0": "Merchant <Mrchnt>", "5-0": "Identification<ID>", "6-0": "Identification<ID>", "7-0": "ShrtNm", "8-0": "Poi<POI>", "9-0": "Identification<ID>", "10-0": "Identification<ID>", "11-0": "Card<Card>", "12-0": "PlainCardData<PlainCardData>", "13-0": "PAN<PAN>", "14-0": "ExpiryDate<XpryDt>", "15-0": "CardSctyCd<CardSctyCd>", "16-0": "CSCVal<CSCVal>", "17-0": "Context<Cntxt>", "18-0": "PaymentContext<PmtCntxt>", "19-0": "CardDataEntryMode<CardDataNtryMd>", "20-0": "TransactionChannel<TxChanl>", "21-0": "Transaction<Tx>", "22-0": "InitiatorTransactionIdentification<InitrTxId>", "23-0": "TransactionCapture<TxCaptr>", "24-0": "TransactionIdentification<TxId>", "25-0": "TransactionDateTime<TxDtTm>", "26-0": "TransactionReference<TxRef>", "27-0": "TransactionDetails<TxDtls>", "28-0": "Currency<Ccy>", "29-0": "TotalAmount<TtlAmt>", "30-0": "AccountType<AcctTp>", "31-0": "RecurringTransaction<RcrngTx>", "32-0": "InstalmentType<InstlmtTp>", "33-0": "InstalmentType<InstlmtTp>", "0-2": "Container", "1-2": "Text", "2-2": "Container", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Text", "7-2": "Text", "8-2": "Container", "9-2": "Container", "10-2": "Text", "11-2": "Container", "12-2": "Container", "13-2": "Text", "14-2": "Text", "15-2": "Container", "16-2": "Text", "17-2": "Container", "18-2": "Container", "19-2": "CodeSet", "20-2": "CodeSet", "21-2": "Container", "22-2": "Text", "23-2": "Boolean", "24-2": "Container", "25-2": "DateTime", "26-2": "Text", "27-2": "Container", "28-2": "CodeSet", "29-2": "Amount", "30-2": "CodeSet", "31-2": "Container", "32-2": "CodeSet", "33-2": "Quantity", "0-3": "Cabeçalho da mensagem.", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Não", "8-4": "Sim", "9-4": "Sim", "10-4": "Sim", "11-4": "Sim", "12-4": "Não", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "17-4": "Sim", "18-4": "Sim", "19-4": "Sim", "20-4": "Sim", "21-4": "Sim", "22-4": "Não", "23-4": "Sim", "24-4": "Sim", "25-4": "Sim", "26-4": "Sim", "27-4": "Sim", "28-4": "Sim", "29-4": "Sim", "30-4": "Não", "31-4": "Não", "32-4": "Sim", "33-4": "Sim", "1-3": "Versão do protocolo utilizado na mensagem.", "2-3": "Dados da requisição de autorização.", "3-3": "Ambiente da transação.", "4-3": "Dados do estabelecimento.", "5-3": "Identificação do estabelecimento comercial.", "6-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.", "7-3": "O nome que aparecerá na fatura. Se a transação for mastercard, o limite é 22 caracteres; Se a transação for visa, o limite é 25 caracteres; Se for parcelado, a visa usa os 8 primeiros caracteres do nome do lojista pra passar a informação de parcelamento, sobrando 17 caracteres.", "8-3": "Dados do ponto de interação", "9-3": "Identificação do ponto de interação", "10-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento.", "11-3": "Dados do cartão utilizado na transação.", "12-3": "Dados não criptografados do cartão utilizado na transação.", "13-3": "Número do cartão. (Primary Account Number)", "14-3": "Data de validade do cartão no formato “yyyy-MM”.", "15-3": "Código de segurança do cartão", "16-3": "CVV estampado no verso do cartão", "17-3": "Informações da transação a ser realizada.", "18-3": "Informações sobre o pagamento.", "19-3": "Modo da entrada dos dados do cartão: PHYS = Ecommerce ou Digitada;", "20-3": "Tipo do canal de comunicação utilizado na transação. Obs.: Preencher esta tag apenas se CardDataNtryMd = PHYS ou ECOM = Ecommerce ou Digitada", "21-3": "Informações da transação.", "22-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n\nTamanho máximo : \n32 caracteres.\n\nEste campo é conhecido internamente na Stone como **ITK** ", "23-3": "Indica se os dados da transação devem ser capturados - true - ou não false - imediatamente.", "24-3": "Dados de identificação da transação atribuída pelo POI (Ponto de interação).", "25-3": "Data local e hora da transação atribuídas pelo POI (ponto de interação).", "26-3": "Identificação da transação definida pelo ponto de interação (POI, estabelecimento, lojista, etc). O formato é livre contendo no máximo 32 caracteres.", "27-3": "Detalhes da transação.", "28-3": "Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.", "29-3": "Valor total da transação em centavos.", "30-3": "Modalidade do cartão utilizado na transação. \n**Fixo**: **CRDT **= Crédito.", "31-3": "Os dados relativos à(s) parcela(s) ou a uma transação recorrente.", "32-3": "Tipo de parcelamento. \nNONE = Nenhum e\nMCHT = Lojista", "33-3": "Número do total de parcelas.", "h-5": "Tamanho", "0-5": "-", "1-5": "an ... 6", "2-5": "-", "3-5": "-", "4-5": "-", "5-5": "an 32" }, "cols": 5, "rows": 34 } [/block] **RESPOSTA DE AUTORIZAÇÃO** A mensagem AcceptorAuthorisationResponse é enviada pelo adquirente, para retornar o resultado da validação realizada pelo emissor sobre a operação de pagamento. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "ProtocolVersion<PrtcolVrsn>", "3-0": "CreationDateTime<CreDtTm>", "4-0": "TraceDateTimeOut<TracDtTmOut>", "5-0": "AuthorisationResponse<AuthstnRspn>", "6-0": "Environment<Envt>", "7-0": "Merchant Identification<MrchntId>", "8-0": "Identification<Id>", "9-0": "POIId<POIId>", "10-0": "Identification<Id>", "11-0": "Transaction<Tx>", "12-0": "TransactionIdentification<TxId>", "13-0": "TransactionDateTime<TxDtTm>", "14-0": "TransactionReference<TxRef>", "15-0": "RecipientTransactionIdentification<RcptTxId>", "16-0": "TransactionDetails<TxDtls>", "17-0": "Currency<Ccy>", "18-0": "TotalAmount<TtlAmt>", "19-0": "AccountType<AcctTp>", "20-0": "TransactionResponse<TxRspn>", "21-0": "AuthorisationResult<AuthstnRslt>", "22-0": "ResponseToAuthorisation<RspnToAuthstn>", "23-0": "Response<Rspn>", "24-0": "ResponseReason<RspnRsn>", "25-0": "AuthorisationCode<AuthstnCd>", "26-0": "CompletionRequired<CmpltnReqrd>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "8-1": "1", "9-1": "0 à 1", "10-1": "1", "11-1": "1", "12-1": "1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "0 à 1", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "1", "24-1": "1", "25-1": "0 à 1", "26-1": "0 à 1", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "5-4": "Sim", "4-4": "Sim", "6-4": "Sim", "7-4": "Sim", "8-4": "Sim", "9-4": "Não", "10-4": "Sim", "11-4": "Sim", "12-4": "Sim", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "17-4": "Sim", "18-4": "Sim", "19-4": "Não", "20-4": "Sim", "21-4": "Sim", "22-4": "Sim", "23-4": "Sim", "24-4": "Sim", "25-4": "Não", "26-4": "Não", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Text", "4-2": "DateTime", "5-2": "Container", "6-2": "Container", "7-2": "Container", "8-2": "Text", "9-2": "Container", "10-2": "Text", "11-2": "Container", "12-2": "Container", "13-2": "DateTime", "14-2": "Text", "15-2": "Text", "16-2": "Container", "17-2": "CodeSet", "18-2": "Amount", "19-2": "CodeSet", "20-2": "Container", "21-2": "Container", "22-2": "Container", "23-2": "CodeSet", "24-2": "Text", "25-2": "Text", "26-2": "Boolean", "0-3": "Cabeçalho da mensagem", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. Fixo: AUTP = AuthorisationResponse.", "2-3": "Versão do protocolo utilizado na mensagem.", "3-3": "Data de criação da mensagem", "4-3": "Data e hora da saída da mensagem no Host Stone.", "5-3": "Informações relacionadas à resposta da autorização.", "6-3": "Ambiente da transação.", "7-3": "Dados do estabelecimento.", "8-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.", "9-3": "Dados do ponto de interação.", "10-3": "Identificação do POI.", "11-3": "Informações da transação.", "12-3": "Dados de identificação da transação atribuída pelo POI (Ponto de interação).", "13-3": "Data local e hora da transação atribuído pelo POI (ponto de interação). Este campo será ecoado pelo adquirente.", "14-3": "Identificação da transação atribuída pelo POI (Ponto de interação). Este campo será ecoado pelo adquirente.", "15-3": "Identificação da transação definida pela Stone.\n\nEste campo é conhecido internamente na Stone como **ATK** ", "16-3": "Detalhes da transação.", "17-3": "Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.", "18-3": "Valor total autorizado em centavos.", "19-3": "Modalidade do cartão utilizado na transação. CRDT = Crédito.", "20-3": "Dados de resposta da transação.", "21-3": "Resultado da autorização.", "22-3": "Dados da resposta da autorização.", "23-3": "Resposta da transação: DECL: Declined, APPR: Aproved, PART: PartialApproved e TECH: TechinicalError.", "24-3": "Código de resposta da autorização (equivalente ao campo 39 da ISO 8583 de 2003).", "25-3": "Código de autorização retornado pelo emissor.", "26-3": "Indica se a mensagem precisa ser capturada posteriormente." }, "cols": 4, "rows": 27 } [/block]
{"__v":0,"_id":"5845961c9f6fbb1b004307a9","api":{"auth":"required","examples":{"codes":[{"code":"<Document xmlns=\"urn:AcceptorCompletionAdviceV02.1\">\n    <AccptrCmpltnAdvc>\n        <!-- Cabeçalho da mensagem. -->\n        <Hdr>\n            <!-- Identifica o tipo de processo em que a mensagem se propõe. -->\n            <MsgFctn>CMPV</MsgFctn>\n            <!-- Versão do protocolo utilizado na mensagem. -->\n            <PrtcolVrsn>2.0</PrtcolVrsn>\n        </Hdr>\n        <!-- Informações relacionadas ao processo de captura ou desfazimento de uma autorização. -->\n        <CmpltnAdvc>\n            <!-- Ambiente da transação. -->\n            <Envt>\n                <!-- Dados do estabelecimento. -->\n                <Mrchnt>\n                    <!-- Identificação do estabelecimento comercial no adquirente. -->\n                    <Id>\n                        <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n                    </Id>\n                </Mrchnt>\n            </Envt>\n            <!-- Dados da transação. -->\n            <Tx>\n                <!-- Dados de identificação da transação atribuída pelo POI. -->\n                <TxId>\n                    <!-- Data local e hora da transação atribuído pelo POI. -->\n                    <TxDtTm>2014-06-11T17:15:44</TxDtTm>\n                    <!-- Identificação da transação atribuída pelo POI. -->\n                    <TxRef>1111</TxRef>\n                </TxId>\n                <!-- Identificação da transação original -->\n                <OrgnlTx>\n                    <!-- Identificação da transação definida pelo adquirente. -->\n                    <RcptTxId>9CDF257AQKR</RcptTxId>\n                </OrgnlTx>\n                <!-- Detalhes da transação. -->\n                <TxDtls>\n                    <!-- Moeda utilizada na transação em conformidade com a ISO 4217. -->\n                    <Ccy>986</Ccy>\n                    <!-- Valor total da transação em centavos. -->\n                    <TtlAmt>100</TtlAmt>\n                </TxDtls>\n            </Tx>\n        </CmpltnAdvc>\n    </AccptrCmpltnAdvc>\n</Document>","language":"xml"}]},"params":[],"results":{"codes":[{"name":"","code":"<Document xmlns=\"urn:AcceptorCompletionAdviceResponseV02.1\">\n    <AccptrCmpltnAdvcRspn>\n        <!-- Cabeçalho da mensagem. -->\n        <Hdr>\n            <!-- Identifica o tipo de processo em que a mensagem se propõe.\n                 CMPK = CompletionAdviceResponse ou\n                 RVRR = ReversalAdviceResponse. -->\n            <MsgFctn>CMPK</MsgFctn>\n            <!-- Versão do protocolo utilizado na mensagem. -->\n            <PrtcolVrsn>2.0</PrtcolVrsn>\n        </Hdr>\n        <!-- Informações sobre a resposta da captura ou desfazimento de uma autorização. -->\n        <CmpltnAdvcRspn>\n            <!-- Ambiente da transação. -->\n            <Envt>\n                <!-- Dados do estabelecimento. -->\n                <Mrchnt>\n                    <!-- Identificação do estabelecimento comercial no adquirente.\n                         Também conhecido internamente como “SaleAffiliationKey”. -->\n                    <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\n                </Mrchnt>\n            </Envt>\n            <!-- Dados da transação. -->\n            <Tx>\n                <!-- Dados da identificação da transação definida pelo POI. -->\n                <TxId>\n                    <!-- Data e hora da transação -->\n                    <TxDtTm>2014-03-12T15:17:59</TxDtTm>\n                    <!-- Identificação da transação definida pelo ponto de interação (POI,\n                         estabelecimento, lojista, etc). Este campo será ecoado pelo adquirente. -->\n                    <TxRef>7ca686eb242b4c0482c58961f5d3aac7</TxRef>\n                </TxId>\n                <!-- Resultado da transação.\n                     DECL = Declined,\n                     APPR = Approved,\n                     PART = Partial Approved,\n                     TECH = Technical Error. -->\n                <Rspn>APPR</Rspn>\n            </Tx>\n        </CmpltnAdvcRspn>\n    </AccptrCmpltnAdvcRspn>\n</Document>","language":"xml","status":200},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","url":"/CompletionAdvice"},"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"AUTORIZAÇÃO COM CAPTURA POSTERIOR\"\n}\n[/block]\nOcorre quando o estabelecimento decide autorizar a transção e capturá-la de forma manual posteriormente. Um exemplo recorrente de captura posterior ocorre no caso de reservas em hotéis, em que o cliente acessa o site, escolhe o hotel, quarto, total de diárias e faz a reserva. O site do hotel, ao receber a solicitação de reserva, solicita à Stone que autorize o valor da reserva, mas não faz a captura até que o cliente faça o checkin no hotel.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Uma mensagem específica para a captura deve ser enviada no momento oportuno\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/cc24748-autorizacao-com-captura-posterior.png\",\n        \"autorizacao-com-captura-posterior.png\",\n        747,\n        434,\n        \"#6bc334\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n1. O estabelecimento envia uma AcceptorAuthorisationRequest ao adquirente solicitando a autorização da transação.\n\n2. Uma AcceptorAuthorisationResponse é devolvida pelo adquirente, informando ao estabelecimento sobre o êxito da autorização.\n\n3. Se a transação tiver sido concluída com êxito no lado do estabelecimento, o estabelecimento envia uma AcceptorCompletionAdvice para capturar a transação.\n\n4. O adquirente retorna uma AcceptorCompletionAdviceResponse, reconhecendo o resultado e captura financeira da transação.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"A tag TxCaptr deve ser enviada com valor FALSE\"\n}\n[/block]\n**QUANDO ENVIAR ?**\n\nA captura posterior deve ser efetuada quando o cliente realiza uma compra com o cartão ( mesmo caso da autorização ), porém o lojista deseja que a captura não ocorra automáticamente e prefere efetuar a captura manualmente em alguma data futura (como é o caso de reservas em hotéis explicitado acima).\n\n\n[block:api-header]\n{\n  \"type\": \"post\",\n  \"title\": \"CompletionAdvice\"\n}\n[/block]\n**XML DE REQUISIÇÃO DE CAPTURA COMENTADO**\n\nCaso você deseje criar uma transação com captura posterior o campo deve TxCaptr deve ser preenchido como false na requisição de Autorização. Então, mensagem AcceptorCompletionAdvice deve ser enviada pelo estabelecimento para confirmar uma transação previamente autorizada. Esta mensagem também é utilizada como um pedido de desfazimento de transações. A url da requisição é [https://e-commerce.stone.com.br/CompletionAdvice](https://e-commerce.stone.com.br/CompletionAdvice) (produção) ou https://sandox-auth-integration.stone.com.br/CompletionAdvice (homologação).\n\n\n\n\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Campo\",\n    \"h-1\": \"Ocorrência\",\n    \"h-2\": \"Tipo\",\n    \"h-3\": \"Descrição\",\n    \"h-4\": \"Obrigatório\",\n    \"0-0\": \"Header<Hdr>\",\n    \"1-0\": \"MessageFunction<MsgFctn>\",\n    \"2-0\": \"ProtocolVersion<PrtcolVrsn>\",\n    \"3-0\": \"CompletionAdvice<CmpltnAdvc>\",\n    \"4-0\": \"Environment<Envt>\",\n    \"5-0\": \"Merchant<Mrchnt>\",\n    \"6-0\": \"Identification<Id>\",\n    \"7-0\": \"Transaction<Tx>\",\n    \"8-0\": \"TransactionIdentification<TxId>\",\n    \"9-0\": \"TransactionDateTime<TxDtTm>\",\n    \"10-0\": \"TransactionReference<TxRef>\",\n    \"11-0\": \"OriginalTransaction<OrgnlTx>\",\n    \"12-0\": \"RecipientTransactionIdentification<RcptTxId>\",\n    \"13-0\": \"TransactionDetails<TxDtls>\",\n    \"14-0\": \"Currency<Ccy>\",\n    \"15-0\": \"TotalAmount<TtlAmt>\",\n    \"0-1\": \"1\",\n    \"1-1\": \"1\",\n    \"2-1\": \"1\",\n    \"3-1\": \"1\",\n    \"4-1\": \"1\",\n    \"5-1\": \"1\",\n    \"6-1\": \"1\",\n    \"7-1\": \"1\",\n    \"8-1\": \"1\",\n    \"9-1\": \"1\",\n    \"15-1\": \"1\",\n    \"14-1\": \"1\",\n    \"13-1\": \"1\",\n    \"12-1\": \"0 à 1\",\n    \"11-1\": \"0 à 1\",\n    \"10-1\": \"1\",\n    \"15-4\": \"Sim\",\n    \"14-4\": \"Sim\",\n    \"13-4\": \"Sim\",\n    \"12-4\": \"Não\",\n    \"11-4\": \"Não\",\n    \"0-4\": \"Sim\",\n    \"1-4\": \"Sim\",\n    \"2-4\": \"Sim\",\n    \"3-4\": \"Sim\",\n    \"4-4\": \"Sim\",\n    \"5-4\": \"Sim\",\n    \"6-4\": \"Sim\",\n    \"7-4\": \"Sim\",\n    \"8-4\": \"Sim\",\n    \"9-4\": \"Sim\",\n    \"10-4\": \"Sim\",\n    \"0-2\": \"Container\",\n    \"1-2\": \"CodeSet\",\n    \"2-2\": \"Text\",\n    \"3-2\": \"Container\",\n    \"4-2\": \"Container\",\n    \"5-2\": \"Container\",\n    \"6-2\": \"Text\",\n    \"7-2\": \"Container\",\n    \"8-2\": \"Container\",\n    \"9-2\": \"DateTime\",\n    \"10-2\": \"Text\",\n    \"11-2\": \"Container\",\n    \"12-2\": \"Text\",\n    \"13-2\": \"Container\",\n    \"14-2\": \"CodeSet\",\n    \"15-2\": \"Amount\",\n    \"0-3\": \"Cabeçalho da mensagem.\",\n    \"1-3\": \"Identifica o tipo de processo em que a mensagem se propõe. CMPV = Completion Advice ou RVRA = ReversalAdvice.\",\n    \"2-3\": \"Versão atual: “2.0”.\",\n    \"3-3\": \"Informações relacionadas ao processo de captura ou desfazimento de uma autorização.\",\n    \"4-3\": \"Ambiente da transação.\",\n    \"5-3\": \"Dados do estabelecimento.\",\n    \"6-3\": \"Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.\",\n    \"7-3\": \"Dados da transação.\",\n    \"8-3\": \"Dados de identificação da transação atribuída pelo POI.\",\n    \"9-3\": \"Data local e hora da transação atribuído pelo POI. Este campo será ecoado pelo adquirente.\",\n    \"10-3\": \"Identificação da transação atribuída pelo POI. Este campo será ecoado pelo adquirente.\",\n    \"11-3\": \"Identificação da transação original\",\n    \"12-3\": \"Identificação da transação definida pelo adquirente.\",\n    \"13-3\": \"Detalhes da transação.\",\n    \"14-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217.\",\n    \"15-3\": \"Valor total da transação em centavos.\"\n  },\n  \"cols\": 5,\n  \"rows\": 16\n}\n[/block]\n\n**XML DE RESPOSTA DE CAPTURA COMENTADO**\n\nA mensagem AcceptorCompletionAdviceResponse é enviada pelo adquirente para avisar o estabelecimento sobre o reconhecimento do resultado da operação de pagamento, bem como a transferência dos dados financeiros da transação contidas no AcceptorCompletionAdvice. Esta mensagem também é utilizada como resposta para o processo de “desfazimento de transações”.\n\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Campo\",\n    \"h-1\": \"Ocorrência\",\n    \"h-2\": \"Tipo\",\n    \"h-3\": \"Descrição\",\n    \"h-4\": \"Obrigatório\",\n    \"0-0\": \"Header<Hdr>\",\n    \"1-0\": \"MessageFunction<MsgFctn>\",\n    \"2-0\": \"CreationDateTime<CreDtTm>\",\n    \"3-0\": \"ProtocolVersion<PrtcolVrsn>\",\n    \"4-0\": \"CompletionAdviceResponse<CmpltnAdvcRspn>\",\n    \"5-0\": \"Environment<Envt>\",\n    \"6-0\": \"Merchant Identification<MrchntId>\",\n    \"7-0\": \"Identification<Id>\",\n    \"8-0\": \"POIId<POIId>\",\n    \"9-0\": \"Transaction<Tx>\",\n    \"10-0\": \"TransactionIdentification<TxId>\",\n    \"11-0\": \"TransactionDateTime<TxDtTm>\",\n    \"12-0\": \"TransactionReference<TxRef>\",\n    \"13-0\": \"Response<Rspn>\",\n    \"0-1\": \"1\",\n    \"1-1\": \"1\",\n    \"2-1\": \"0 à 1\",\n    \"8-1\": \"0 à 1\",\n    \"3-1\": \"1\",\n    \"4-1\": \"1\",\n    \"5-1\": \"1\",\n    \"6-1\": \"1\",\n    \"7-1\": \"1\",\n    \"9-1\": \"1\",\n    \"10-1\": \"1\",\n    \"11-1\": \"1\",\n    \"12-1\": \"1\",\n    \"13-1\": \"1\",\n    \"8-4\": \"Não\",\n    \"2-4\": \"Não\",\n    \"0-4\": \"Sim\",\n    \"1-4\": \"Sim\",\n    \"3-4\": \"Sim\",\n    \"4-4\": \"Sim\",\n    \"5-4\": \"Sim\",\n    \"6-4\": \"Sim\",\n    \"7-4\": \"Sim\",\n    \"9-4\": \"Sim\",\n    \"10-4\": \"Sim\",\n    \"11-4\": \"Sim\",\n    \"12-4\": \"Sim\",\n    \"13-4\": \"Sim\",\n    \"0-2\": \"Container\",\n    \"1-2\": \"CodeSet\",\n    \"2-2\": \"Text\",\n    \"3-2\": \"Text\",\n    \"4-2\": \"Container\",\n    \"5-2\": \"Container\",\n    \"6-2\": \"Container\",\n    \"8-2\": \"Container\",\n    \"9-2\": \"Container\",\n    \"10-2\": \"Container\",\n    \"7-2\": \"Text\",\n    \"12-2\": \"Text\",\n    \"11-2\": \"DateTime\",\n    \"13-2\": \"CodeSet\",\n    \"0-3\": \"Cabeçalho da mensagem.\",\n    \"1-3\": \"Identifica o tipo de processo em que a mensagem se propõe. “CMPK” = CompletionAdviceResponse ou “RVRR” = ReversalAdviceResponse.\",\n    \"2-3\": \"Data de criação da mensagem\",\n    \"3-3\": \"Versão do protocolo utilizado na mensagem.\",\n    \"4-3\": \"Informações sobre a resposta da captura ou desfazimento de uma autorização.\",\n    \"5-3\": \"Ambiente da transação.\",\n    \"6-3\": \"Dados do estabelecimento.\",\n    \"7-3\": \"Identificação do estabelecimento comercial no adquirente. Também conhecido como “SaleAffiliationKey”.\",\n    \"8-3\": \"Dados do ponto de interação.\",\n    \"9-3\": \"Dados da transação.\",\n    \"10-3\": \"Dados da identificação da transação definida pelo POI.\",\n    \"11-3\": \"Data e hora da transação\",\n    \"12-3\": \"Identificação da transação definida pelo ponto de interação. Este campo será ecoado pelo adquirente.\",\n    \"13-3\": \"Resultado da transação. DECL = Declined, APPR = Approved, PART = Partial Approved, TECH = Technical Error.\"\n  },\n  \"cols\": 4,\n  \"rows\": 14\n}\n[/block]","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:30:20.617Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":7,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"captura-posterior","sync_unique":"","title":"Captura Posterior","type":"post","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

postCaptura Posterior


[block:api-header] { "type": "basic", "title": "AUTORIZAÇÃO COM CAPTURA POSTERIOR" } [/block] Ocorre quando o estabelecimento decide autorizar a transção e capturá-la de forma manual posteriormente. Um exemplo recorrente de captura posterior ocorre no caso de reservas em hotéis, em que o cliente acessa o site, escolhe o hotel, quarto, total de diárias e faz a reserva. O site do hotel, ao receber a solicitação de reserva, solicita à Stone que autorize o valor da reserva, mas não faz a captura até que o cliente faça o checkin no hotel. [block:callout] { "type": "info", "body": "Uma mensagem específica para a captura deve ser enviada no momento oportuno" } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/cc24748-autorizacao-com-captura-posterior.png", "autorizacao-com-captura-posterior.png", 747, 434, "#6bc334" ], "sizing": "full" } ] } [/block] 1. O estabelecimento envia uma AcceptorAuthorisationRequest ao adquirente solicitando a autorização da transação. 2. Uma AcceptorAuthorisationResponse é devolvida pelo adquirente, informando ao estabelecimento sobre o êxito da autorização. 3. Se a transação tiver sido concluída com êxito no lado do estabelecimento, o estabelecimento envia uma AcceptorCompletionAdvice para capturar a transação. 4. O adquirente retorna uma AcceptorCompletionAdviceResponse, reconhecendo o resultado e captura financeira da transação. [block:callout] { "type": "info", "body": "A tag TxCaptr deve ser enviada com valor FALSE" } [/block] **QUANDO ENVIAR ?** A captura posterior deve ser efetuada quando o cliente realiza uma compra com o cartão ( mesmo caso da autorização ), porém o lojista deseja que a captura não ocorra automáticamente e prefere efetuar a captura manualmente em alguma data futura (como é o caso de reservas em hotéis explicitado acima). [block:api-header] { "type": "post", "title": "CompletionAdvice" } [/block] **XML DE REQUISIÇÃO DE CAPTURA COMENTADO** Caso você deseje criar uma transação com captura posterior o campo deve TxCaptr deve ser preenchido como false na requisição de Autorização. Então, mensagem AcceptorCompletionAdvice deve ser enviada pelo estabelecimento para confirmar uma transação previamente autorizada. Esta mensagem também é utilizada como um pedido de desfazimento de transações. A url da requisição é [https://e-commerce.stone.com.br/CompletionAdvice](https://e-commerce.stone.com.br/CompletionAdvice) (produção) ou https://sandox-auth-integration.stone.com.br/CompletionAdvice (homologação). [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "ProtocolVersion<PrtcolVrsn>", "3-0": "CompletionAdvice<CmpltnAdvc>", "4-0": "Environment<Envt>", "5-0": "Merchant<Mrchnt>", "6-0": "Identification<Id>", "7-0": "Transaction<Tx>", "8-0": "TransactionIdentification<TxId>", "9-0": "TransactionDateTime<TxDtTm>", "10-0": "TransactionReference<TxRef>", "11-0": "OriginalTransaction<OrgnlTx>", "12-0": "RecipientTransactionIdentification<RcptTxId>", "13-0": "TransactionDetails<TxDtls>", "14-0": "Currency<Ccy>", "15-0": "TotalAmount<TtlAmt>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "8-1": "1", "9-1": "1", "15-1": "1", "14-1": "1", "13-1": "1", "12-1": "0 à 1", "11-1": "0 à 1", "10-1": "1", "15-4": "Sim", "14-4": "Sim", "13-4": "Sim", "12-4": "Não", "11-4": "Não", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Sim", "8-4": "Sim", "9-4": "Sim", "10-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Text", "7-2": "Container", "8-2": "Container", "9-2": "DateTime", "10-2": "Text", "11-2": "Container", "12-2": "Text", "13-2": "Container", "14-2": "CodeSet", "15-2": "Amount", "0-3": "Cabeçalho da mensagem.", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. CMPV = Completion Advice ou RVRA = ReversalAdvice.", "2-3": "Versão atual: “2.0”.", "3-3": "Informações relacionadas ao processo de captura ou desfazimento de uma autorização.", "4-3": "Ambiente da transação.", "5-3": "Dados do estabelecimento.", "6-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.", "7-3": "Dados da transação.", "8-3": "Dados de identificação da transação atribuída pelo POI.", "9-3": "Data local e hora da transação atribuído pelo POI. Este campo será ecoado pelo adquirente.", "10-3": "Identificação da transação atribuída pelo POI. Este campo será ecoado pelo adquirente.", "11-3": "Identificação da transação original", "12-3": "Identificação da transação definida pelo adquirente.", "13-3": "Detalhes da transação.", "14-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "15-3": "Valor total da transação em centavos." }, "cols": 5, "rows": 16 } [/block] **XML DE RESPOSTA DE CAPTURA COMENTADO** A mensagem AcceptorCompletionAdviceResponse é enviada pelo adquirente para avisar o estabelecimento sobre o reconhecimento do resultado da operação de pagamento, bem como a transferência dos dados financeiros da transação contidas no AcceptorCompletionAdvice. Esta mensagem também é utilizada como resposta para o processo de “desfazimento de transações”. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "CreationDateTime<CreDtTm>", "3-0": "ProtocolVersion<PrtcolVrsn>", "4-0": "CompletionAdviceResponse<CmpltnAdvcRspn>", "5-0": "Environment<Envt>", "6-0": "Merchant Identification<MrchntId>", "7-0": "Identification<Id>", "8-0": "POIId<POIId>", "9-0": "Transaction<Tx>", "10-0": "TransactionIdentification<TxId>", "11-0": "TransactionDateTime<TxDtTm>", "12-0": "TransactionReference<TxRef>", "13-0": "Response<Rspn>", "0-1": "1", "1-1": "1", "2-1": "0 à 1", "8-1": "0 à 1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "9-1": "1", "10-1": "1", "11-1": "1", "12-1": "1", "13-1": "1", "8-4": "Não", "2-4": "Não", "0-4": "Sim", "1-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Sim", "9-4": "Sim", "10-4": "Sim", "11-4": "Sim", "12-4": "Sim", "13-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Text", "4-2": "Container", "5-2": "Container", "6-2": "Container", "8-2": "Container", "9-2": "Container", "10-2": "Container", "7-2": "Text", "12-2": "Text", "11-2": "DateTime", "13-2": "CodeSet", "0-3": "Cabeçalho da mensagem.", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. “CMPK” = CompletionAdviceResponse ou “RVRR” = ReversalAdviceResponse.", "2-3": "Data de criação da mensagem", "3-3": "Versão do protocolo utilizado na mensagem.", "4-3": "Informações sobre a resposta da captura ou desfazimento de uma autorização.", "5-3": "Ambiente da transação.", "6-3": "Dados do estabelecimento.", "7-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido como “SaleAffiliationKey”.", "8-3": "Dados do ponto de interação.", "9-3": "Dados da transação.", "10-3": "Dados da identificação da transação definida pelo POI.", "11-3": "Data e hora da transação", "12-3": "Identificação da transação definida pelo ponto de interação. Este campo será ecoado pelo adquirente.", "13-3": "Resultado da transação. DECL = Declined, APPR = Approved, PART = Partial Approved, TECH = Technical Error." }, "cols": 4, "rows": 14 } [/block]

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



[block:api-header] { "type": "basic", "title": "AUTORIZAÇÃO COM CAPTURA POSTERIOR" } [/block] Ocorre quando o estabelecimento decide autorizar a transção e capturá-la de forma manual posteriormente. Um exemplo recorrente de captura posterior ocorre no caso de reservas em hotéis, em que o cliente acessa o site, escolhe o hotel, quarto, total de diárias e faz a reserva. O site do hotel, ao receber a solicitação de reserva, solicita à Stone que autorize o valor da reserva, mas não faz a captura até que o cliente faça o checkin no hotel. [block:callout] { "type": "info", "body": "Uma mensagem específica para a captura deve ser enviada no momento oportuno" } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/cc24748-autorizacao-com-captura-posterior.png", "autorizacao-com-captura-posterior.png", 747, 434, "#6bc334" ], "sizing": "full" } ] } [/block] 1. O estabelecimento envia uma AcceptorAuthorisationRequest ao adquirente solicitando a autorização da transação. 2. Uma AcceptorAuthorisationResponse é devolvida pelo adquirente, informando ao estabelecimento sobre o êxito da autorização. 3. Se a transação tiver sido concluída com êxito no lado do estabelecimento, o estabelecimento envia uma AcceptorCompletionAdvice para capturar a transação. 4. O adquirente retorna uma AcceptorCompletionAdviceResponse, reconhecendo o resultado e captura financeira da transação. [block:callout] { "type": "info", "body": "A tag TxCaptr deve ser enviada com valor FALSE" } [/block] **QUANDO ENVIAR ?** A captura posterior deve ser efetuada quando o cliente realiza uma compra com o cartão ( mesmo caso da autorização ), porém o lojista deseja que a captura não ocorra automáticamente e prefere efetuar a captura manualmente em alguma data futura (como é o caso de reservas em hotéis explicitado acima). [block:api-header] { "type": "post", "title": "CompletionAdvice" } [/block] **XML DE REQUISIÇÃO DE CAPTURA COMENTADO** Caso você deseje criar uma transação com captura posterior o campo deve TxCaptr deve ser preenchido como false na requisição de Autorização. Então, mensagem AcceptorCompletionAdvice deve ser enviada pelo estabelecimento para confirmar uma transação previamente autorizada. Esta mensagem também é utilizada como um pedido de desfazimento de transações. A url da requisição é [https://e-commerce.stone.com.br/CompletionAdvice](https://e-commerce.stone.com.br/CompletionAdvice) (produção) ou https://sandox-auth-integration.stone.com.br/CompletionAdvice (homologação). [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "ProtocolVersion<PrtcolVrsn>", "3-0": "CompletionAdvice<CmpltnAdvc>", "4-0": "Environment<Envt>", "5-0": "Merchant<Mrchnt>", "6-0": "Identification<Id>", "7-0": "Transaction<Tx>", "8-0": "TransactionIdentification<TxId>", "9-0": "TransactionDateTime<TxDtTm>", "10-0": "TransactionReference<TxRef>", "11-0": "OriginalTransaction<OrgnlTx>", "12-0": "RecipientTransactionIdentification<RcptTxId>", "13-0": "TransactionDetails<TxDtls>", "14-0": "Currency<Ccy>", "15-0": "TotalAmount<TtlAmt>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "8-1": "1", "9-1": "1", "15-1": "1", "14-1": "1", "13-1": "1", "12-1": "0 à 1", "11-1": "0 à 1", "10-1": "1", "15-4": "Sim", "14-4": "Sim", "13-4": "Sim", "12-4": "Não", "11-4": "Não", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Sim", "8-4": "Sim", "9-4": "Sim", "10-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Text", "7-2": "Container", "8-2": "Container", "9-2": "DateTime", "10-2": "Text", "11-2": "Container", "12-2": "Text", "13-2": "Container", "14-2": "CodeSet", "15-2": "Amount", "0-3": "Cabeçalho da mensagem.", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. CMPV = Completion Advice ou RVRA = ReversalAdvice.", "2-3": "Versão atual: “2.0”.", "3-3": "Informações relacionadas ao processo de captura ou desfazimento de uma autorização.", "4-3": "Ambiente da transação.", "5-3": "Dados do estabelecimento.", "6-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.", "7-3": "Dados da transação.", "8-3": "Dados de identificação da transação atribuída pelo POI.", "9-3": "Data local e hora da transação atribuído pelo POI. Este campo será ecoado pelo adquirente.", "10-3": "Identificação da transação atribuída pelo POI. Este campo será ecoado pelo adquirente.", "11-3": "Identificação da transação original", "12-3": "Identificação da transação definida pelo adquirente.", "13-3": "Detalhes da transação.", "14-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "15-3": "Valor total da transação em centavos." }, "cols": 5, "rows": 16 } [/block] **XML DE RESPOSTA DE CAPTURA COMENTADO** A mensagem AcceptorCompletionAdviceResponse é enviada pelo adquirente para avisar o estabelecimento sobre o reconhecimento do resultado da operação de pagamento, bem como a transferência dos dados financeiros da transação contidas no AcceptorCompletionAdvice. Esta mensagem também é utilizada como resposta para o processo de “desfazimento de transações”. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "CreationDateTime<CreDtTm>", "3-0": "ProtocolVersion<PrtcolVrsn>", "4-0": "CompletionAdviceResponse<CmpltnAdvcRspn>", "5-0": "Environment<Envt>", "6-0": "Merchant Identification<MrchntId>", "7-0": "Identification<Id>", "8-0": "POIId<POIId>", "9-0": "Transaction<Tx>", "10-0": "TransactionIdentification<TxId>", "11-0": "TransactionDateTime<TxDtTm>", "12-0": "TransactionReference<TxRef>", "13-0": "Response<Rspn>", "0-1": "1", "1-1": "1", "2-1": "0 à 1", "8-1": "0 à 1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "9-1": "1", "10-1": "1", "11-1": "1", "12-1": "1", "13-1": "1", "8-4": "Não", "2-4": "Não", "0-4": "Sim", "1-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Sim", "9-4": "Sim", "10-4": "Sim", "11-4": "Sim", "12-4": "Sim", "13-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Text", "4-2": "Container", "5-2": "Container", "6-2": "Container", "8-2": "Container", "9-2": "Container", "10-2": "Container", "7-2": "Text", "12-2": "Text", "11-2": "DateTime", "13-2": "CodeSet", "0-3": "Cabeçalho da mensagem.", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. “CMPK” = CompletionAdviceResponse ou “RVRR” = ReversalAdviceResponse.", "2-3": "Data de criação da mensagem", "3-3": "Versão do protocolo utilizado na mensagem.", "4-3": "Informações sobre a resposta da captura ou desfazimento de uma autorização.", "5-3": "Ambiente da transação.", "6-3": "Dados do estabelecimento.", "7-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido como “SaleAffiliationKey”.", "8-3": "Dados do ponto de interação.", "9-3": "Dados da transação.", "10-3": "Dados da identificação da transação definida pelo POI.", "11-3": "Data e hora da transação", "12-3": "Identificação da transação definida pelo ponto de interação. Este campo será ecoado pelo adquirente.", "13-3": "Resultado da transação. DECL = Declined, APPR = Approved, PART = Partial Approved, TECH = Technical Error." }, "cols": 4, "rows": 14 } [/block]
{"__v":0,"_id":"5845963ee055290f00c029d3","api":{"auth":"required","examples":{"codes":[{"language":"xml","code":"<Document xmlns=\"urn:AcceptorCancellationRequestV02.1\">\n    <AccptrCxlReq>\n        <!-- Cabeçalho da mensagem -->\n        <Hdr>\n            <!-- Identifica o tipo de processo em que a mensagem se propõe. -->\n            <MsgFctn>CCAQ</MsgFctn>\n            <!-- Versão do protocolo utilizado na mensagem. -->\n            <PrtcolVrsn>2.0</PrtcolVrsn>\n        </Hdr>\n        <!-- Informações relacionadas à requisição de cancelamento. -->\n        <CxlReq>\n            <!-- Ambiente da transação. -->\n            <Envt>\n                <!-- Dados do estabelecimento. -->\n                <Mrchnt>\n                    <!-- Identificação do estabelecimento comercial. -->\n                    <Id>\n                        <!-- Identificação do estabelecimento comercial no adquirente. -->\n                        <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n                    </Id>\n                </Mrchnt>\n                <!-- Dados do Ponto de Interação. -->\n                <POI>\n                    <!-- Identificação do ponto de interação -->\n                    <Id>\n                        <!-- Código de identificação do POI atribuído pelo estabelecimento. -->\n                        <Id>2FB4C89A</Id>\n                    </Id>\n                </POI>\n            </Envt>\n            <!-- Dados da transação. -->\n            <Tx>\n                <!-- Indica se os dados da transação devem ser capturados `true` ou não\n                     `false` imediatamente. -->\n                <TxCaptr>true</TxCaptr>\n                <!-- Identificação da transação atribuída pelo POI. -->\n                <TxId>\n                    <!-- Data e hora local da transação definidas pelo ponto de interação. -->\n                    <TxDtTm>2014-03-12T15:09:00</TxDtTm>\n                    <!-- Identificação da transação definida pelo ponto de interação.\n                         O formato é livre contendo no máximo 32 caracteres. -->\n                    <TxRef>12345ABC</TxRef>\n                </TxId>\n                <!-- Detalhes da transação -->\n                <TxDtls>\n                    <!-- Moeda utilizada na transação em conformidade com a ISO 4217.-->\n                    <Ccy>986</Ccy>\n                    <!-- Valor total da transação em centavos. -->\n                    <TtlAmt>100</TtlAmt>\n                </TxDtls>\n                <!-- Dados da transação original -->\n                <OrgnlTx>\n                    <!-- Identificação da transação definida pelo sistema que se comunica\n                         com o Host Stone. -->\n                    <InitrTxId>123123123</InitrTxId>\n                    <!-- Identificação da transação definida pelo adquirente. -->\n                    <RcptTxId>00000034071000000215346</RcptTxId>\n                </OrgnlTx>\n            </Tx>\n        </CxlReq>\n    </AccptrCxlReq>\n</Document>"}]},"params":[],"results":{"codes":[{"name":"","code":"<Document xmlns=\"urn:AcceptorCancellationResponseV02.1\">\n    <AccptrCxlRspn>\n        <!-- Cabeçalho da mensagem -->\n        <Hdr>\n            <!-- Identifica o tipo de processo em que a mensagem se propõe.\n                 CCAP = Cancellation Response. -->\n            <MsgFctn>CCAP</MsgFctn>\n            <!-- Versão do protocolo utilizado na mensagem. -->\n            <PrtcolVrsn>2.0</PrtcolVrsn>\n        </Hdr>\n        <!-- Informações relacionadas à resposta de cancelamento. -->\n        <CxlRspn>\n            <!-- Ambiente da transação. -->\n            <Envt>\n                <!-- Dados do estabelecimento. -->\n                <MrchntId>\n                    <!-- Identificação do estabelecimento comercial no adquirente.\n                         Também conhecido internamente como “SaleAffiliationKey”. -->\n                    <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\n                </MrchntId>\n            </Envt>\n            <!-- Dados da transação. -->\n            <Tx>\n                <!-- Indica se os dados da transação devem ser capturados `true`\n                     ou não `false` imediatamente. -->\n                <TxCaptr>true</TxCaptr>\n                <!-- Identificação da transação atribuída pelo POI. -->\n                <TxId>\n                    <!-- Data e hora local da transação definidas pelo ponto de interação. -->\n                    <TxDtTm>2014-03-12T15:09:00</TxDtTm>\n                    <!-- Identificação da transação definida pelo ponto de interação.\n                         Este campo será ecoado pelo adquirente. -->\n                    <TxRef>123456798</TxRef>\n                </TxId>\n                <!-- Detalhes da transação -->\n                <TxDtls>\n                    <!-- Moeda utilizada na transação em conformidade com a ISO 4217. -->\n                    <Ccy>986</Ccy>\n                    <!-- Valor total da transação em centavos. -->\n                    <TtlAmt>100</TtlAmt>\n                </TxDtls>\n            </Tx>\n            <!-- Dados de resposta da transação. -->\n            <TxRspn>\n                <!-- Informações sobre o resultado da autorização a ser cancelada. -->\n                <AuthstnRslt>\n                    <!-- Dados de resposta da autorização a ser cancelada. -->\n                    <RspnToAuthstn>\n                        <!-- Resposta da transação.\n                             DECL: Declined\n                             APPR: Aproved\n                             PART: PartialApproved\n                             TECH: TechinicalError -->\n                        <Rspn>APPR</Rspn>\n                        <!-- Código de resposta da autorização\n                             equivalente ao campo 39 da ISO 8583 de 2003. -->\n                        <RspnRsn>0000</RspnRsn>\n                    </RspnToAuthstn>\n                </AuthstnRslt>\n            </TxRspn>\n        </CxlRspn>\n    </AccptrCxlRspn>\n</Document>","language":"xml","status":200},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","url":"/Cancellation"},"body":"O cancelamento/estorno ( desfazimento ) de uma autorização é outro caso comum, tanto para ecommerce, quanto para casos de reserva. Algumas vezes, por algum motivo, o cliente pode simplesmente desistir de uma compra. É importante lembrar que o cancelamento/estorno só pode ser efetuado caso o cliente possua saldo positivo no valor igual ou maior ao valor da venda a ser cancelada/estornada.\n\nDeve-se distinguir, porém, o cancelamento de uma transação de um estorno. Apesar de ambos serem dois tipos similares de desfazimento de transações as definições são diferentes:\n\n* **Cancelamento** : É o pedido de desfazimento de uma transação que ocorre quando o valor da transação ainda não foi liquidado pela Stone para o lojista. Nesse caso o valor é recebido pelo portador do cartão em até 5 dias.\n\n* **Estorno** : É o pedido de desfazimento de uma transação que ocorre quando o valor da transação já foi liquidado pela Stone para o lojista. Nesse caso o valor é recebido pelo portador do cartão na próxima fatura.\n\n**QUANDO CADA UM OCORRE**\n\nComo a Stone é uma adquirente, ela apenas liquida saldos dos seus clientes. Ao realizar transações o cliente gera recebíveis e, caso o total de recebíveis seja superior aos valores devidos por ele à Stone (por exemplo valor do aluguel de maquininhas e Pinpads), seu saldo será positivo. O momento em que os recebíveis do cliente são enviados para a conta dele é chamado de liquidação.\n\n\n* **Cancelamento** : Vendas desfeitas antes da liquidação;\n\n* **Cancelamento Parcial** : Vendas parcialmente desfeitas antes da liquidação;\n\n* **Estornos** : Vendas desfeitas após a liquidação;\n\n* **Estorno Parcial** : Vendas parcialmente desfeitas após a liquidação;\n\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4647d01-cancelamento-com-captura.png\",\n        \"cancelamento-com-captura.png\",\n        776,\n        623,\n        \"#040404\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n1. O estabelecimento envia uma AcceptorAuthorisationRequest para o adquirente para realizar um pedido de autorização;\n\n2. Uma AcceptorAuthorisationResponse é enviada pelo adquirente confirmando e aprovando o pedido de autorização;\n\n3. Uma AcceptorCompletionAdvice é utilizada para informar ao adquirente sobre a captura da transação;\n\n4. O adquirente envia uma AcceptorCompletionAdviceResponse reconhecendo o pedido de cancelamento por parte do estabelecimento;\n\nNesta transação o estabelecimento não necessita de nenhum pedido de cancelamento prévio pois supomos que ele já possui as informações de que o cancelamento pode realmente ser realizado.\n\n\n[block:api-header]\n{\n  \"type\": \"post\",\n  \"title\": \"Cancellation\"\n}\n[/block]\nO cancelamento é o serviço que permite que um estabelecimento cancele ( desfaça ) uma transação concluída com êxito. Também é conhecido como “desfazimento manual”. O prazo para que o cancelamento/estorno seja realizado é 180 dias após a data na qual a transação foi realizada.\n\n**QUANDO ENVIAR ?**\n\nQuando um cliente desiste de uma reserva ( no caso de hoteís e serviços correlatos ) ou desiste de um produto comprado ( e-commerces em geral ) o cliente pode entrar em contato direto com o lojista e solicitar o cancelamento/estorno da reserva/compra ou pode falar diretamente com o banco emissor de seu cartão e solicitar um chargeback ( ou contestação ) por diversos motivos. Nesses casos deve se enviar uma requisição de cancelamento conforme descrito abaixo.\n\n**XML DE REQUISIÇÃO DE CANCELAMENTO COMENTADO**\n\nA mensagem AcceptorCancellationRequest é utilizada para realizar um pedido de cancelamento de uma transação autorizada e deve ser enviada para a url [https://e-commerce.stone.com.br/Cancellation ](http://google.com)( produção ) ou [https://sandbox-auth-integration.stone.com.br/Cancellation](https://sandbox-auth-integration.stone.com.br/Cancellation) (homologação).\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Campo\",\n    \"h-1\": \"Ocorrência\",\n    \"h-2\": \"Tipo\",\n    \"h-3\": \"Descrição\",\n    \"h-4\": \"Obrigatório\",\n    \"0-0\": \"Header<Hdr>\",\n    \"1-0\": \"MessageFunction<MsgFctn>\",\n    \"2-0\": \"ProtocolVersion<PrtcolVrsn>\",\n    \"3-0\": \"CancellationRequest<CxlReq>\",\n    \"4-0\": \"Environment<Envt>\",\n    \"5-0\": \"Merchant<Mrchnt>\",\n    \"6-0\": \"Identification<Id>\",\n    \"7-0\": \"Identification<Id>\",\n    \"8-0\": \"Poi<POI>\",\n    \"9-0\": \"Identification<Id>\",\n    \"10-0\": \"Identification<Id>\",\n    \"11-0\": \"Capabilities\",\n    \"12-0\": \"PrintLineWidth<PrtLineWidth>\",\n    \"13-0\": \"Transaction<Tx>\",\n    \"14-0\": \"TransactionCapture<TxCaptr>\",\n    \"15-0\": \"TransactionIdentification<TxId>\",\n    \"16-0\": \"TransactionDateTime<TxDtTm>\",\n    \"17-0\": \"TransactionReference<TxRef>\",\n    \"18-0\": \"TransactionDetails<TxDtls>\",\n    \"19-0\": \"Currency<Ccy>\",\n    \"20-0\": \"TotalAmount<TtlAmt>\",\n    \"21-0\": \"OriginalTransaction<OrgnlTx>\",\n    \"22-0\": \"InitiatorTransactionIdentification<InitrTxId>\",\n    \"23-0\": \"RecipientTransactionIdentification<RcptTxId>\",\n    \"0-1\": \"1\",\n    \"1-1\": \"1\",\n    \"2-1\": \"1\",\n    \"3-1\": \"1\",\n    \"4-1\": \"1\",\n    \"5-1\": \"1\",\n    \"6-1\": \"1\",\n    \"7-1\": \"1\",\n    \"8-1\": \"1\",\n    \"9-1\": \"1\",\n    \"10-1\": \"1\",\n    \"11-1\": \"0 à 1\",\n    \"12-1\": \"0 à 1\",\n    \"13-1\": \"1\",\n    \"14-1\": \"1\",\n    \"15-1\": \"1\",\n    \"16-1\": \"1\",\n    \"17-1\": \"1\",\n    \"18-1\": \"1\",\n    \"19-1\": \"1\",\n    \"20-1\": \"1\",\n    \"21-1\": \"1\",\n    \"22-1\": \"1\",\n    \"23-1\": \"1\",\n    \"0-4\": \"Sim\",\n    \"1-4\": \"Sim\",\n    \"2-4\": \"Sim\",\n    \"3-4\": \"Sim\",\n    \"4-4\": \"Sim\",\n    \"5-4\": \"Sim\",\n    \"6-4\": \"Sim\",\n    \"7-4\": \"Sim\",\n    \"8-4\": \"Sim\",\n    \"9-4\": \"Sim\",\n    \"10-4\": \"Sim\",\n    \"11-4\": \"Não\",\n    \"12-4\": \"Não\",\n    \"13-4\": \"Sim\",\n    \"14-4\": \"Sim\",\n    \"15-4\": \"Sim\",\n    \"16-4\": \"Sim\",\n    \"17-4\": \"Sim\",\n    \"18-4\": \"Sim\",\n    \"19-4\": \"Sim\",\n    \"20-4\": \"Sim\",\n    \"21-4\": \"Sim\",\n    \"22-4\": \"Sim\",\n    \"23-4\": \"Sim\",\n    \"0-2\": \"Container\",\n    \"1-2\": \"CodeSet\",\n    \"2-2\": \"Text\",\n    \"3-2\": \"Container\",\n    \"4-2\": \"Container\",\n    \"5-2\": \"Container\",\n    \"6-2\": \"Container\",\n    \"8-2\": \"Container\",\n    \"9-2\": \"Container\",\n    \"7-2\": \"Text\",\n    \"11-2\": \"Container\",\n    \"10-2\": \"Text\",\n    \"12-2\": \"Text\",\n    \"13-2\": \"Container\",\n    \"14-2\": \"Bool\",\n    \"15-2\": \"Container\",\n    \"16-2\": \"DateTime\",\n    \"17-2\": \"Text\",\n    \"18-2\": \"Container\",\n    \"19-2\": \"CodeSet\",\n    \"20-2\": \"Amount\",\n    \"21-2\": \"Container\",\n    \"22-2\": \"Text\",\n    \"23-2\": \"Text\",\n    \"0-3\": \"Cabeçalho da mensagem\",\n    \"1-3\": \"Identifica o tipo de processo em que a mensagem se propõe. Fixo: “CCAQ” = Cancellation Request.\",\n    \"2-3\": \"Versão do protocolo utilizado na mensagem.\",\n    \"3-3\": \"Informações relacionadas à requisição de cancelamento.\",\n    \"4-3\": \"Ambiente da transação.\",\n    \"5-3\": \"Dados do estabelecimento.\",\n    \"6-3\": \"Identificação do estabelecimento comercial.\",\n    \"7-3\": \"Identificação do estabelecimento comercial no adquirente. Também conhecido como “SaleAffiliationKey”.\",\n    \"8-3\": \"Dados do Ponto de Interação.\",\n    \"9-3\": \"Identificação do ponto de interação\",\n    \"10-3\": \"Código de identificação do ponto de interação atribuído pelo estabelecimento.\",\n    \"11-3\": \"Capacidades do Ponto de interação.\",\n    \"12-3\": \"Número máximo de colunas de cada linha a ser impressa no cupom. A quantidade mínima de colunas é de 38. Se o POI enviar menos do que 38, o Host Stone não irá retornar os dados do recibo.\",\n    \"13-3\": \"Dados da transação.\",\n    \"14-3\": \"Indica se os dados da transação devem ser capturados true ou não false imediatamente.\",\n    \"15-3\": \"Identificação da transação atribuída pelo POI (Ponto de interação).\",\n    \"16-3\": \"Data e hora local da transação definidas pelo ponto de interação.\",\n    \"17-3\": \"Identificação da transação definida pelo ponto de interação. O formato é livre contendo no máximo 32 caracteres.\",\n    \"18-3\": \"Detalhes da transação\",\n    \"19-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217.\",\n    \"20-3\": \"Valor total da transação em centavos\",\n    \"21-3\": \"Dados da transação original\",\n    \"22-3\": \"Identificação da transação definida pelo sistema que se comunica com o Host Stone.\\n\\nTamanho máximo : \\n32 caracteres\",\n    \"23-3\": \"Identificação da transação definida pelo adquirente.\"\n  },\n  \"cols\": 5,\n  \"rows\": 24\n}\n[/block]\n**XML DE RESPOSTA DE CANCELAMENTO COMENTADO**\n\nA mensagem AcceptorCancellationResponse é respondida pelo adquirente com as informações sobre a requisição de cancelamento AcceptorCancellationRequest. Importante informar que os dados do recibo de cancelamento são enviados somente nesta mensagem.\n\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Campo\",\n    \"h-1\": \"Ocorrência\",\n    \"h-2\": \"Tipo\",\n    \"h-3\": \"Descrição\",\n    \"h-4\": \"Obrigatório\",\n    \"0-0\": \"Header<Hdr>\",\n    \"1-0\": \"MessageFunction<MsgFctn>\",\n    \"2-0\": \"ProtocolVersion<PrtcolVrsn>\",\n    \"3-0\": \"CreationDateTime<CreDtTm>\",\n    \"4-0\": \"CancellationResponse<CxlRspn>\",\n    \"5-0\": \"Environment<Envt>\",\n    \"6-0\": \"Merchant Identification<MrchntId>\",\n    \"7-0\": \"Identification<Id>\",\n    \"8-0\": \"POIId<POIId>\",\n    \"9-0\": \"Identification<Id>\",\n    \"10-0\": \"Transaction<Tx>\",\n    \"11-0\": \"TransactionCapture<TxCaptr>\",\n    \"12-0\": \"TransactionIdentification<TxId>\",\n    \"13-0\": \"TransactionDateTime<TxDtTm>\",\n    \"14-0\": \"TransactionReference<TxRef>\",\n    \"15-0\": \"TransactionDetails<TxDtls>\",\n    \"16-0\": \"Currency<Ccy>\",\n    \"17-0\": \"TotalAmount<TtlAmt>\",\n    \"18-0\": \"TransactionResponse<TxRspn>\",\n    \"19-0\": \"AuthorisationResult<AuthstnRslt>\",\n    \"20-0\": \"ResponseToAuthorisation<RspnToAuthstn>\",\n    \"21-0\": \"Response<Rspn>\",\n    \"22-0\": \"ResponseReason<RspnRsn>\",\n    \"23-0\": \"CompletionRequired<CmpltnReqrd>\",\n    \"0-1\": \"1\",\n    \"1-1\": \"1\",\n    \"2-1\": \"1\",\n    \"3-1\": \"0 à 1\",\n    \"4-1\": \"1\",\n    \"5-1\": \"1\",\n    \"6-1\": \"0 à 1\",\n    \"7-1\": \"1\",\n    \"8-1\": \"0 à 1\",\n    \"9-1\": \"1\",\n    \"10-1\": \"1\",\n    \"11-1\": \"1\",\n    \"12-1\": \"1\",\n    \"13-1\": \"1\",\n    \"14-1\": \"1\",\n    \"15-1\": \"1\",\n    \"16-1\": \"1\",\n    \"17-1\": \"1\",\n    \"18-1\": \"1\",\n    \"19-1\": \"1\",\n    \"20-1\": \"1\",\n    \"21-1\": \"1\",\n    \"22-1\": \"0 à 1\",\n    \"23-1\": \"0 à 1\",\n    \"0-4\": \"Sim\",\n    \"1-4\": \"Sim\",\n    \"2-4\": \"Sim\",\n    \"3-4\": \"Não\",\n    \"4-4\": \"Sim\",\n    \"5-4\": \"Sim\",\n    \"6-4\": \"Não\",\n    \"7-4\": \"Sim\",\n    \"8-4\": \"Não\",\n    \"9-4\": \"Sim\",\n    \"10-4\": \"Sim\",\n    \"11-4\": \"Sim\",\n    \"12-4\": \"Sim\",\n    \"13-4\": \"Sim\",\n    \"14-4\": \"Sim\",\n    \"15-4\": \"Sim\",\n    \"16-4\": \"Sim\",\n    \"17-4\": \"Sim\",\n    \"18-4\": \"Sim\",\n    \"19-4\": \"Sim\",\n    \"20-4\": \"Sim\",\n    \"21-4\": \"Sim\",\n    \"22-4\": \"Não\",\n    \"23-4\": \"Não\",\n    \"0-2\": \"Container\",\n    \"1-2\": \"CodeSet\",\n    \"2-2\": \"Text\",\n    \"3-2\": \"Text\",\n    \"4-2\": \"Container\",\n    \"5-2\": \"Container\",\n    \"6-2\": \"Container\",\n    \"7-2\": \"Text\",\n    \"8-2\": \"Container\",\n    \"9-2\": \"Text\",\n    \"10-2\": \"Container\",\n    \"11-2\": \"Bool\",\n    \"12-2\": \"Container\",\n    \"13-2\": \"DateTime\",\n    \"14-2\": \"Text\",\n    \"15-2\": \"Container\",\n    \"16-2\": \"CodeSet\",\n    \"17-2\": \"Amount\",\n    \"18-2\": \"Container\",\n    \"19-2\": \"Container\",\n    \"20-2\": \"Container\",\n    \"21-2\": \"CodeSet\",\n    \"22-2\": \"Text\",\n    \"23-2\": \"Bool\",\n    \"0-3\": \"Cabeçalho da mensagem\",\n    \"1-3\": \"Identifica o tipo de processo em que a mensagem se propõe. Fixo: “CCAP” = Cancellation Response.\",\n    \"2-3\": \"Versão do protocolo utilizado na mensagem.\",\n    \"3-3\": \"Data de criação da mensagem\",\n    \"4-3\": \"Informações relacionadas à resposta de cancelamento.\",\n    \"5-3\": \"Ambiente da transação.\",\n    \"6-3\": \"Dados do estabelecimento.\",\n    \"7-3\": \"Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.\",\n    \"8-3\": \"Dados do ponto de interação\",\n    \"9-3\": \"Código de identificação do ponto de interação atribuído pelo estabelecimento (Campo ecoado).\",\n    \"10-3\": \"Dados da transação.\",\n    \"11-3\": \"Indica se os dados da transação devem ser capturados true ou não false imediatamente.\",\n    \"12-3\": \"Identificação da transação atribuída pelo POI.\",\n    \"13-3\": \"Data e hora local da transação definidas pelo ponto de interação.\",\n    \"14-3\": \"Identificação da transação definida pelo ponto de interação. Este campo será ecoado pelo adquirente.\",\n    \"15-3\": \"Detalhes da transação\",\n    \"16-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217.\",\n    \"17-3\": \"Valor total da transação em centavos.\",\n    \"18-3\": \"Dados de resposta da transação.\",\n    \"19-3\": \"Informações sobre o resultado da autorização a ser cancelada.\",\n    \"20-3\": \"Dados de resposta da autorização a ser cancelada.\",\n    \"21-3\": \"Resposta da transação. DECL: Declined; APPR: Aproved; PART: PartialApproved; TECH: TechinicalError;\",\n    \"22-3\": \"Código de resposta da autorização.\",\n    \"23-3\": \"Indica se a mensagem precisa ser capturada posteriormente.\"\n  },\n  \"cols\": 4,\n  \"rows\": 24\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"OBSERVAÇÃO ADICIONAIS\"\n}\n[/block]\n**Chargeback e Reapresentação**\n\nO conceito de chargeback ( ou contestação ) é bem simples. Quando o portador do cartão entra em contato com o banco ( emissor ) e solicita o cancelamento da transação por algum dos diversos motivos:\n\n* ** Fraude** : O portador do cartão ( cliente consumidor final ) entra em contato com o banco informando que não reconhece a compra apesar de ter recebido a mercadoria corretamente e não ter sido cobrado de maneira indevida.\n\n* **Desacordo comercial** : O portador alega que sua mercadoria contém algum tipo de problema, não era aquilo que ele esperava ou foi entregue fora do prazo de recebimento estabelecido no momento da venda. Ex: O cliente pediu um tênis roxo tamanho 44 com prazo de entrega de 2 dias e o vendedor, na falta do produto, tenta vender um tênis preto no tamanho correto ou um tênis roxo no tamanho diferente do pedido pelo cliente ou entrega o tênis na cor e tamanho corretos porém em 5 dias.\n\n* **Erros no processamento** : Quando ocorre algum tipo de falha técnica que impede a captura correta da transação, nesses caso o banco pode solicitar chargeback.\n\nInfelizmente, o consumidor pode solicitar um chargeback de má fé, por exemplo, ele faz a compra pessoalmente e vê que mercadoria está como deveria ou mesmo após fazer a compra online e receber a mercadoria corretamente ele entra em contato com o banco emissor e solicita o chargeback. Nesses casos reapresentação que seria na realidade a contestação de um chargeback pode ser realizada com a ajuda da STONE. Para isso você deve enviar documentos que comprovem a efetividade da compra como : \n\n* Cópia legível do comprovante de venda.\n\n* Documentação de suporte de venda.\n\n* Alguma documentação comprobatória como: nota fiscal, algumas informações que o consumidor recebeu as mercadorias/serviços na data combinada,de maneira correta e sem defeitos.\n\n* Qualquer outra documentação que comprove que a venda é legítima.\n\nNesses casos você deve entrar em contato com o relacionamento com o cliente STONE no telefone 3004-9680 ou no email [meajuda@stone.com.br](mailto:meajuda@stone.com.br) para receber um atendimento pessoal e cheio de disposição da nossa equipe e enviá-los os documentos necessários.","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-05T16:30:54.921Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":8,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"cancelamentoestorno-desfazimento","sync_unique":"","title":"Cancelamento/Estorno ( Desfazimento )","type":"post","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

postCancelamento/Estorno ( Desfazimento )


O cancelamento/estorno ( desfazimento ) de uma autorização é outro caso comum, tanto para ecommerce, quanto para casos de reserva. Algumas vezes, por algum motivo, o cliente pode simplesmente desistir de uma compra. É importante lembrar que o cancelamento/estorno só pode ser efetuado caso o cliente possua saldo positivo no valor igual ou maior ao valor da venda a ser cancelada/estornada. Deve-se distinguir, porém, o cancelamento de uma transação de um estorno. Apesar de ambos serem dois tipos similares de desfazimento de transações as definições são diferentes: * **Cancelamento** : É o pedido de desfazimento de uma transação que ocorre quando o valor da transação ainda não foi liquidado pela Stone para o lojista. Nesse caso o valor é recebido pelo portador do cartão em até 5 dias. * **Estorno** : É o pedido de desfazimento de uma transação que ocorre quando o valor da transação já foi liquidado pela Stone para o lojista. Nesse caso o valor é recebido pelo portador do cartão na próxima fatura. **QUANDO CADA UM OCORRE** Como a Stone é uma adquirente, ela apenas liquida saldos dos seus clientes. Ao realizar transações o cliente gera recebíveis e, caso o total de recebíveis seja superior aos valores devidos por ele à Stone (por exemplo valor do aluguel de maquininhas e Pinpads), seu saldo será positivo. O momento em que os recebíveis do cliente são enviados para a conta dele é chamado de liquidação. * **Cancelamento** : Vendas desfeitas antes da liquidação; * **Cancelamento Parcial** : Vendas parcialmente desfeitas antes da liquidação; * **Estornos** : Vendas desfeitas após a liquidação; * **Estorno Parcial** : Vendas parcialmente desfeitas após a liquidação; [block:image] { "images": [ { "image": [ "https://files.readme.io/4647d01-cancelamento-com-captura.png", "cancelamento-com-captura.png", 776, 623, "#040404" ], "sizing": "full" } ] } [/block] 1. O estabelecimento envia uma AcceptorAuthorisationRequest para o adquirente para realizar um pedido de autorização; 2. Uma AcceptorAuthorisationResponse é enviada pelo adquirente confirmando e aprovando o pedido de autorização; 3. Uma AcceptorCompletionAdvice é utilizada para informar ao adquirente sobre a captura da transação; 4. O adquirente envia uma AcceptorCompletionAdviceResponse reconhecendo o pedido de cancelamento por parte do estabelecimento; Nesta transação o estabelecimento não necessita de nenhum pedido de cancelamento prévio pois supomos que ele já possui as informações de que o cancelamento pode realmente ser realizado. [block:api-header] { "type": "post", "title": "Cancellation" } [/block] O cancelamento é o serviço que permite que um estabelecimento cancele ( desfaça ) uma transação concluída com êxito. Também é conhecido como “desfazimento manual”. O prazo para que o cancelamento/estorno seja realizado é 180 dias após a data na qual a transação foi realizada. **QUANDO ENVIAR ?** Quando um cliente desiste de uma reserva ( no caso de hoteís e serviços correlatos ) ou desiste de um produto comprado ( e-commerces em geral ) o cliente pode entrar em contato direto com o lojista e solicitar o cancelamento/estorno da reserva/compra ou pode falar diretamente com o banco emissor de seu cartão e solicitar um chargeback ( ou contestação ) por diversos motivos. Nesses casos deve se enviar uma requisição de cancelamento conforme descrito abaixo. **XML DE REQUISIÇÃO DE CANCELAMENTO COMENTADO** A mensagem AcceptorCancellationRequest é utilizada para realizar um pedido de cancelamento de uma transação autorizada e deve ser enviada para a url [https://e-commerce.stone.com.br/Cancellation ](http://google.com)( produção ) ou [https://sandbox-auth-integration.stone.com.br/Cancellation](https://sandbox-auth-integration.stone.com.br/Cancellation) (homologação). [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "ProtocolVersion<PrtcolVrsn>", "3-0": "CancellationRequest<CxlReq>", "4-0": "Environment<Envt>", "5-0": "Merchant<Mrchnt>", "6-0": "Identification<Id>", "7-0": "Identification<Id>", "8-0": "Poi<POI>", "9-0": "Identification<Id>", "10-0": "Identification<Id>", "11-0": "Capabilities", "12-0": "PrintLineWidth<PrtLineWidth>", "13-0": "Transaction<Tx>", "14-0": "TransactionCapture<TxCaptr>", "15-0": "TransactionIdentification<TxId>", "16-0": "TransactionDateTime<TxDtTm>", "17-0": "TransactionReference<TxRef>", "18-0": "TransactionDetails<TxDtls>", "19-0": "Currency<Ccy>", "20-0": "TotalAmount<TtlAmt>", "21-0": "OriginalTransaction<OrgnlTx>", "22-0": "InitiatorTransactionIdentification<InitrTxId>", "23-0": "RecipientTransactionIdentification<RcptTxId>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "8-1": "1", "9-1": "1", "10-1": "1", "11-1": "0 à 1", "12-1": "0 à 1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "1", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "1", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Sim", "8-4": "Sim", "9-4": "Sim", "10-4": "Sim", "11-4": "Não", "12-4": "Não", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "17-4": "Sim", "18-4": "Sim", "19-4": "Sim", "20-4": "Sim", "21-4": "Sim", "22-4": "Sim", "23-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Container", "8-2": "Container", "9-2": "Container", "7-2": "Text", "11-2": "Container", "10-2": "Text", "12-2": "Text", "13-2": "Container", "14-2": "Bool", "15-2": "Container", "16-2": "DateTime", "17-2": "Text", "18-2": "Container", "19-2": "CodeSet", "20-2": "Amount", "21-2": "Container", "22-2": "Text", "23-2": "Text", "0-3": "Cabeçalho da mensagem", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. Fixo: “CCAQ” = Cancellation Request.", "2-3": "Versão do protocolo utilizado na mensagem.", "3-3": "Informações relacionadas à requisição de cancelamento.", "4-3": "Ambiente da transação.", "5-3": "Dados do estabelecimento.", "6-3": "Identificação do estabelecimento comercial.", "7-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido como “SaleAffiliationKey”.", "8-3": "Dados do Ponto de Interação.", "9-3": "Identificação do ponto de interação", "10-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento.", "11-3": "Capacidades do Ponto de interação.", "12-3": "Número máximo de colunas de cada linha a ser impressa no cupom. A quantidade mínima de colunas é de 38. Se o POI enviar menos do que 38, o Host Stone não irá retornar os dados do recibo.", "13-3": "Dados da transação.", "14-3": "Indica se os dados da transação devem ser capturados true ou não false imediatamente.", "15-3": "Identificação da transação atribuída pelo POI (Ponto de interação).", "16-3": "Data e hora local da transação definidas pelo ponto de interação.", "17-3": "Identificação da transação definida pelo ponto de interação. O formato é livre contendo no máximo 32 caracteres.", "18-3": "Detalhes da transação", "19-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "20-3": "Valor total da transação em centavos", "21-3": "Dados da transação original", "22-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n\nTamanho máximo : \n32 caracteres", "23-3": "Identificação da transação definida pelo adquirente." }, "cols": 5, "rows": 24 } [/block] **XML DE RESPOSTA DE CANCELAMENTO COMENTADO** A mensagem AcceptorCancellationResponse é respondida pelo adquirente com as informações sobre a requisição de cancelamento AcceptorCancellationRequest. Importante informar que os dados do recibo de cancelamento são enviados somente nesta mensagem. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "ProtocolVersion<PrtcolVrsn>", "3-0": "CreationDateTime<CreDtTm>", "4-0": "CancellationResponse<CxlRspn>", "5-0": "Environment<Envt>", "6-0": "Merchant Identification<MrchntId>", "7-0": "Identification<Id>", "8-0": "POIId<POIId>", "9-0": "Identification<Id>", "10-0": "Transaction<Tx>", "11-0": "TransactionCapture<TxCaptr>", "12-0": "TransactionIdentification<TxId>", "13-0": "TransactionDateTime<TxDtTm>", "14-0": "TransactionReference<TxRef>", "15-0": "TransactionDetails<TxDtls>", "16-0": "Currency<Ccy>", "17-0": "TotalAmount<TtlAmt>", "18-0": "TransactionResponse<TxRspn>", "19-0": "AuthorisationResult<AuthstnRslt>", "20-0": "ResponseToAuthorisation<RspnToAuthstn>", "21-0": "Response<Rspn>", "22-0": "ResponseReason<RspnRsn>", "23-0": "CompletionRequired<CmpltnReqrd>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "0 à 1", "4-1": "1", "5-1": "1", "6-1": "0 à 1", "7-1": "1", "8-1": "0 à 1", "9-1": "1", "10-1": "1", "11-1": "1", "12-1": "1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "1", "20-1": "1", "21-1": "1", "22-1": "0 à 1", "23-1": "0 à 1", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Não", "4-4": "Sim", "5-4": "Sim", "6-4": "Não", "7-4": "Sim", "8-4": "Não", "9-4": "Sim", "10-4": "Sim", "11-4": "Sim", "12-4": "Sim", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "17-4": "Sim", "18-4": "Sim", "19-4": "Sim", "20-4": "Sim", "21-4": "Sim", "22-4": "Não", "23-4": "Não", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Text", "4-2": "Container", "5-2": "Container", "6-2": "Container", "7-2": "Text", "8-2": "Container", "9-2": "Text", "10-2": "Container", "11-2": "Bool", "12-2": "Container", "13-2": "DateTime", "14-2": "Text", "15-2": "Container", "16-2": "CodeSet", "17-2": "Amount", "18-2": "Container", "19-2": "Container", "20-2": "Container", "21-2": "CodeSet", "22-2": "Text", "23-2": "Bool", "0-3": "Cabeçalho da mensagem", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. Fixo: “CCAP” = Cancellation Response.", "2-3": "Versão do protocolo utilizado na mensagem.", "3-3": "Data de criação da mensagem", "4-3": "Informações relacionadas à resposta de cancelamento.", "5-3": "Ambiente da transação.", "6-3": "Dados do estabelecimento.", "7-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.", "8-3": "Dados do ponto de interação", "9-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento (Campo ecoado).", "10-3": "Dados da transação.", "11-3": "Indica se os dados da transação devem ser capturados true ou não false imediatamente.", "12-3": "Identificação da transação atribuída pelo POI.", "13-3": "Data e hora local da transação definidas pelo ponto de interação.", "14-3": "Identificação da transação definida pelo ponto de interação. Este campo será ecoado pelo adquirente.", "15-3": "Detalhes da transação", "16-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "17-3": "Valor total da transação em centavos.", "18-3": "Dados de resposta da transação.", "19-3": "Informações sobre o resultado da autorização a ser cancelada.", "20-3": "Dados de resposta da autorização a ser cancelada.", "21-3": "Resposta da transação. DECL: Declined; APPR: Aproved; PART: PartialApproved; TECH: TechinicalError;", "22-3": "Código de resposta da autorização.", "23-3": "Indica se a mensagem precisa ser capturada posteriormente." }, "cols": 4, "rows": 24 } [/block] [block:api-header] { "type": "basic", "title": "OBSERVAÇÃO ADICIONAIS" } [/block] **Chargeback e Reapresentação** O conceito de chargeback ( ou contestação ) é bem simples. Quando o portador do cartão entra em contato com o banco ( emissor ) e solicita o cancelamento da transação por algum dos diversos motivos: * ** Fraude** : O portador do cartão ( cliente consumidor final ) entra em contato com o banco informando que não reconhece a compra apesar de ter recebido a mercadoria corretamente e não ter sido cobrado de maneira indevida. * **Desacordo comercial** : O portador alega que sua mercadoria contém algum tipo de problema, não era aquilo que ele esperava ou foi entregue fora do prazo de recebimento estabelecido no momento da venda. Ex: O cliente pediu um tênis roxo tamanho 44 com prazo de entrega de 2 dias e o vendedor, na falta do produto, tenta vender um tênis preto no tamanho correto ou um tênis roxo no tamanho diferente do pedido pelo cliente ou entrega o tênis na cor e tamanho corretos porém em 5 dias. * **Erros no processamento** : Quando ocorre algum tipo de falha técnica que impede a captura correta da transação, nesses caso o banco pode solicitar chargeback. Infelizmente, o consumidor pode solicitar um chargeback de má fé, por exemplo, ele faz a compra pessoalmente e vê que mercadoria está como deveria ou mesmo após fazer a compra online e receber a mercadoria corretamente ele entra em contato com o banco emissor e solicita o chargeback. Nesses casos reapresentação que seria na realidade a contestação de um chargeback pode ser realizada com a ajuda da STONE. Para isso você deve enviar documentos que comprovem a efetividade da compra como : * Cópia legível do comprovante de venda. * Documentação de suporte de venda. * Alguma documentação comprobatória como: nota fiscal, algumas informações que o consumidor recebeu as mercadorias/serviços na data combinada,de maneira correta e sem defeitos. * Qualquer outra documentação que comprove que a venda é legítima. Nesses casos você deve entrar em contato com o relacionamento com o cliente STONE no telefone 3004-9680 ou no email [meajuda@stone.com.br](mailto:meajuda@stone.com.br) para receber um atendimento pessoal e cheio de disposição da nossa equipe e enviá-los os documentos necessários.

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



O cancelamento/estorno ( desfazimento ) de uma autorização é outro caso comum, tanto para ecommerce, quanto para casos de reserva. Algumas vezes, por algum motivo, o cliente pode simplesmente desistir de uma compra. É importante lembrar que o cancelamento/estorno só pode ser efetuado caso o cliente possua saldo positivo no valor igual ou maior ao valor da venda a ser cancelada/estornada. Deve-se distinguir, porém, o cancelamento de uma transação de um estorno. Apesar de ambos serem dois tipos similares de desfazimento de transações as definições são diferentes: * **Cancelamento** : É o pedido de desfazimento de uma transação que ocorre quando o valor da transação ainda não foi liquidado pela Stone para o lojista. Nesse caso o valor é recebido pelo portador do cartão em até 5 dias. * **Estorno** : É o pedido de desfazimento de uma transação que ocorre quando o valor da transação já foi liquidado pela Stone para o lojista. Nesse caso o valor é recebido pelo portador do cartão na próxima fatura. **QUANDO CADA UM OCORRE** Como a Stone é uma adquirente, ela apenas liquida saldos dos seus clientes. Ao realizar transações o cliente gera recebíveis e, caso o total de recebíveis seja superior aos valores devidos por ele à Stone (por exemplo valor do aluguel de maquininhas e Pinpads), seu saldo será positivo. O momento em que os recebíveis do cliente são enviados para a conta dele é chamado de liquidação. * **Cancelamento** : Vendas desfeitas antes da liquidação; * **Cancelamento Parcial** : Vendas parcialmente desfeitas antes da liquidação; * **Estornos** : Vendas desfeitas após a liquidação; * **Estorno Parcial** : Vendas parcialmente desfeitas após a liquidação; [block:image] { "images": [ { "image": [ "https://files.readme.io/4647d01-cancelamento-com-captura.png", "cancelamento-com-captura.png", 776, 623, "#040404" ], "sizing": "full" } ] } [/block] 1. O estabelecimento envia uma AcceptorAuthorisationRequest para o adquirente para realizar um pedido de autorização; 2. Uma AcceptorAuthorisationResponse é enviada pelo adquirente confirmando e aprovando o pedido de autorização; 3. Uma AcceptorCompletionAdvice é utilizada para informar ao adquirente sobre a captura da transação; 4. O adquirente envia uma AcceptorCompletionAdviceResponse reconhecendo o pedido de cancelamento por parte do estabelecimento; Nesta transação o estabelecimento não necessita de nenhum pedido de cancelamento prévio pois supomos que ele já possui as informações de que o cancelamento pode realmente ser realizado. [block:api-header] { "type": "post", "title": "Cancellation" } [/block] O cancelamento é o serviço que permite que um estabelecimento cancele ( desfaça ) uma transação concluída com êxito. Também é conhecido como “desfazimento manual”. O prazo para que o cancelamento/estorno seja realizado é 180 dias após a data na qual a transação foi realizada. **QUANDO ENVIAR ?** Quando um cliente desiste de uma reserva ( no caso de hoteís e serviços correlatos ) ou desiste de um produto comprado ( e-commerces em geral ) o cliente pode entrar em contato direto com o lojista e solicitar o cancelamento/estorno da reserva/compra ou pode falar diretamente com o banco emissor de seu cartão e solicitar um chargeback ( ou contestação ) por diversos motivos. Nesses casos deve se enviar uma requisição de cancelamento conforme descrito abaixo. **XML DE REQUISIÇÃO DE CANCELAMENTO COMENTADO** A mensagem AcceptorCancellationRequest é utilizada para realizar um pedido de cancelamento de uma transação autorizada e deve ser enviada para a url [https://e-commerce.stone.com.br/Cancellation ](http://google.com)( produção ) ou [https://sandbox-auth-integration.stone.com.br/Cancellation](https://sandbox-auth-integration.stone.com.br/Cancellation) (homologação). [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "ProtocolVersion<PrtcolVrsn>", "3-0": "CancellationRequest<CxlReq>", "4-0": "Environment<Envt>", "5-0": "Merchant<Mrchnt>", "6-0": "Identification<Id>", "7-0": "Identification<Id>", "8-0": "Poi<POI>", "9-0": "Identification<Id>", "10-0": "Identification<Id>", "11-0": "Capabilities", "12-0": "PrintLineWidth<PrtLineWidth>", "13-0": "Transaction<Tx>", "14-0": "TransactionCapture<TxCaptr>", "15-0": "TransactionIdentification<TxId>", "16-0": "TransactionDateTime<TxDtTm>", "17-0": "TransactionReference<TxRef>", "18-0": "TransactionDetails<TxDtls>", "19-0": "Currency<Ccy>", "20-0": "TotalAmount<TtlAmt>", "21-0": "OriginalTransaction<OrgnlTx>", "22-0": "InitiatorTransactionIdentification<InitrTxId>", "23-0": "RecipientTransactionIdentification<RcptTxId>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "8-1": "1", "9-1": "1", "10-1": "1", "11-1": "0 à 1", "12-1": "0 à 1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "1", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "1", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Sim", "8-4": "Sim", "9-4": "Sim", "10-4": "Sim", "11-4": "Não", "12-4": "Não", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "17-4": "Sim", "18-4": "Sim", "19-4": "Sim", "20-4": "Sim", "21-4": "Sim", "22-4": "Sim", "23-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Container", "8-2": "Container", "9-2": "Container", "7-2": "Text", "11-2": "Container", "10-2": "Text", "12-2": "Text", "13-2": "Container", "14-2": "Bool", "15-2": "Container", "16-2": "DateTime", "17-2": "Text", "18-2": "Container", "19-2": "CodeSet", "20-2": "Amount", "21-2": "Container", "22-2": "Text", "23-2": "Text", "0-3": "Cabeçalho da mensagem", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. Fixo: “CCAQ” = Cancellation Request.", "2-3": "Versão do protocolo utilizado na mensagem.", "3-3": "Informações relacionadas à requisição de cancelamento.", "4-3": "Ambiente da transação.", "5-3": "Dados do estabelecimento.", "6-3": "Identificação do estabelecimento comercial.", "7-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido como “SaleAffiliationKey”.", "8-3": "Dados do Ponto de Interação.", "9-3": "Identificação do ponto de interação", "10-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento.", "11-3": "Capacidades do Ponto de interação.", "12-3": "Número máximo de colunas de cada linha a ser impressa no cupom. A quantidade mínima de colunas é de 38. Se o POI enviar menos do que 38, o Host Stone não irá retornar os dados do recibo.", "13-3": "Dados da transação.", "14-3": "Indica se os dados da transação devem ser capturados true ou não false imediatamente.", "15-3": "Identificação da transação atribuída pelo POI (Ponto de interação).", "16-3": "Data e hora local da transação definidas pelo ponto de interação.", "17-3": "Identificação da transação definida pelo ponto de interação. O formato é livre contendo no máximo 32 caracteres.", "18-3": "Detalhes da transação", "19-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "20-3": "Valor total da transação em centavos", "21-3": "Dados da transação original", "22-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n\nTamanho máximo : \n32 caracteres", "23-3": "Identificação da transação definida pelo adquirente." }, "cols": 5, "rows": 24 } [/block] **XML DE RESPOSTA DE CANCELAMENTO COMENTADO** A mensagem AcceptorCancellationResponse é respondida pelo adquirente com as informações sobre a requisição de cancelamento AcceptorCancellationRequest. Importante informar que os dados do recibo de cancelamento são enviados somente nesta mensagem. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "Header<Hdr>", "1-0": "MessageFunction<MsgFctn>", "2-0": "ProtocolVersion<PrtcolVrsn>", "3-0": "CreationDateTime<CreDtTm>", "4-0": "CancellationResponse<CxlRspn>", "5-0": "Environment<Envt>", "6-0": "Merchant Identification<MrchntId>", "7-0": "Identification<Id>", "8-0": "POIId<POIId>", "9-0": "Identification<Id>", "10-0": "Transaction<Tx>", "11-0": "TransactionCapture<TxCaptr>", "12-0": "TransactionIdentification<TxId>", "13-0": "TransactionDateTime<TxDtTm>", "14-0": "TransactionReference<TxRef>", "15-0": "TransactionDetails<TxDtls>", "16-0": "Currency<Ccy>", "17-0": "TotalAmount<TtlAmt>", "18-0": "TransactionResponse<TxRspn>", "19-0": "AuthorisationResult<AuthstnRslt>", "20-0": "ResponseToAuthorisation<RspnToAuthstn>", "21-0": "Response<Rspn>", "22-0": "ResponseReason<RspnRsn>", "23-0": "CompletionRequired<CmpltnReqrd>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "0 à 1", "4-1": "1", "5-1": "1", "6-1": "0 à 1", "7-1": "1", "8-1": "0 à 1", "9-1": "1", "10-1": "1", "11-1": "1", "12-1": "1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "1", "20-1": "1", "21-1": "1", "22-1": "0 à 1", "23-1": "0 à 1", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Não", "4-4": "Sim", "5-4": "Sim", "6-4": "Não", "7-4": "Sim", "8-4": "Não", "9-4": "Sim", "10-4": "Sim", "11-4": "Sim", "12-4": "Sim", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "17-4": "Sim", "18-4": "Sim", "19-4": "Sim", "20-4": "Sim", "21-4": "Sim", "22-4": "Não", "23-4": "Não", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Text", "4-2": "Container", "5-2": "Container", "6-2": "Container", "7-2": "Text", "8-2": "Container", "9-2": "Text", "10-2": "Container", "11-2": "Bool", "12-2": "Container", "13-2": "DateTime", "14-2": "Text", "15-2": "Container", "16-2": "CodeSet", "17-2": "Amount", "18-2": "Container", "19-2": "Container", "20-2": "Container", "21-2": "CodeSet", "22-2": "Text", "23-2": "Bool", "0-3": "Cabeçalho da mensagem", "1-3": "Identifica o tipo de processo em que a mensagem se propõe. Fixo: “CCAP” = Cancellation Response.", "2-3": "Versão do protocolo utilizado na mensagem.", "3-3": "Data de criação da mensagem", "4-3": "Informações relacionadas à resposta de cancelamento.", "5-3": "Ambiente da transação.", "6-3": "Dados do estabelecimento.", "7-3": "Identificação do estabelecimento comercial no adquirente. Também conhecido internamente como “SaleAffiliationKey”.", "8-3": "Dados do ponto de interação", "9-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento (Campo ecoado).", "10-3": "Dados da transação.", "11-3": "Indica se os dados da transação devem ser capturados true ou não false imediatamente.", "12-3": "Identificação da transação atribuída pelo POI.", "13-3": "Data e hora local da transação definidas pelo ponto de interação.", "14-3": "Identificação da transação definida pelo ponto de interação. Este campo será ecoado pelo adquirente.", "15-3": "Detalhes da transação", "16-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "17-3": "Valor total da transação em centavos.", "18-3": "Dados de resposta da transação.", "19-3": "Informações sobre o resultado da autorização a ser cancelada.", "20-3": "Dados de resposta da autorização a ser cancelada.", "21-3": "Resposta da transação. DECL: Declined; APPR: Aproved; PART: PartialApproved; TECH: TechinicalError;", "22-3": "Código de resposta da autorização.", "23-3": "Indica se a mensagem precisa ser capturada posteriormente." }, "cols": 4, "rows": 24 } [/block] [block:api-header] { "type": "basic", "title": "OBSERVAÇÃO ADICIONAIS" } [/block] **Chargeback e Reapresentação** O conceito de chargeback ( ou contestação ) é bem simples. Quando o portador do cartão entra em contato com o banco ( emissor ) e solicita o cancelamento da transação por algum dos diversos motivos: * ** Fraude** : O portador do cartão ( cliente consumidor final ) entra em contato com o banco informando que não reconhece a compra apesar de ter recebido a mercadoria corretamente e não ter sido cobrado de maneira indevida. * **Desacordo comercial** : O portador alega que sua mercadoria contém algum tipo de problema, não era aquilo que ele esperava ou foi entregue fora do prazo de recebimento estabelecido no momento da venda. Ex: O cliente pediu um tênis roxo tamanho 44 com prazo de entrega de 2 dias e o vendedor, na falta do produto, tenta vender um tênis preto no tamanho correto ou um tênis roxo no tamanho diferente do pedido pelo cliente ou entrega o tênis na cor e tamanho corretos porém em 5 dias. * **Erros no processamento** : Quando ocorre algum tipo de falha técnica que impede a captura correta da transação, nesses caso o banco pode solicitar chargeback. Infelizmente, o consumidor pode solicitar um chargeback de má fé, por exemplo, ele faz a compra pessoalmente e vê que mercadoria está como deveria ou mesmo após fazer a compra online e receber a mercadoria corretamente ele entra em contato com o banco emissor e solicita o chargeback. Nesses casos reapresentação que seria na realidade a contestação de um chargeback pode ser realizada com a ajuda da STONE. Para isso você deve enviar documentos que comprovem a efetividade da compra como : * Cópia legível do comprovante de venda. * Documentação de suporte de venda. * Alguma documentação comprobatória como: nota fiscal, algumas informações que o consumidor recebeu as mercadorias/serviços na data combinada,de maneira correta e sem defeitos. * Qualquer outra documentação que comprove que a venda é legítima. Nesses casos você deve entrar em contato com o relacionamento com o cliente STONE no telefone 3004-9680 ou no email [meajuda@stone.com.br](mailto:meajuda@stone.com.br) para receber um atendimento pessoal e cheio de disposição da nossa equipe e enviá-los os documentos necessários.
{"__v":0,"_id":"58540533e97784190069b9d4","api":{"auth":"required","examples":{"codes":[{"language":"xml","code":"<Document xmlns=\"urn:AcceptorTransactionStatusReportRequestV02.1\">\n\t<AccptrTxStsRptRq>\n\t\t\t<Hdr>\n\t\t\t\t<MsgFctn>TSRR</MsgFctn>\n\t\t\t\t<PrtcolVrsn>2.0</PrtcolVrsn>\n\t\t\t\t<InitgPty>\n\t\t\t\t\t<Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n\t\t\t\t</InitgPty>\n\t\t</Hdr>\n\t\t<TxStsRpt>\n\t\t\t<Tx>\n\t\t\t\t<TxRpt>OPRS</TxRpt>\n\t\t\t\t<TxRpt>SUMM</TxRpt>\n\t\t\t<OrgnlTx>\n\t\t\t\t<InitrTxId>2a42327648f644f4</InitrTxId>\n<\t\t\t\tRcptTxId>11350002663228</RcptTxId>\n\t\t\t</OrgnlTx>\n\t\t</Tx>\n\t\t</TxStsRpt>\n\t</AccptrTxStsRptRq>\n</Document>"}]},"params":[],"results":{"codes":[{"name":"","code":"<Document xmlns=\"urn:AcceptorTransactionStatusReporResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n\t<AccptrTxStsRptRspn>\n\t\t<Hdr>\n\t\t\t<MsgFctn>TSRP</MsgFctn>\n\t\t\t<PrtcolVrsn>2.0</PrtcolVrsn>\n\t\t\t<CreDtTm>2015-01-19T14:17:02</CreDtTm>\n\t\t\t<InitgPty>\n\t\t\t\t<Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n\t\t\t</InitgPty>\n\t\t</Hdr>\n\t\t<TxStsRptRspn>\n\t\t\t<Tx>\n\t\t\t\t<Summry>\n\t\t\t\t\t<RcptTxId>11350002663228</RcptTxId>\n\t\t\t\t\t<InitrTxId>2a42327648f644f4</InitrTxId>\n\t\t\t\t\t<AcqrrDtTm>2015-01-13T18:17:26</AcqrrDtTm>\n\t\t\t\t\t<LclDtTm>2015-01-13T18:17:25</LclDtTm>\n\t\t\t\t\t<FrstCaptrDtTm>2015-01-13T18:17:28</FrstCaptrDtTm>\n\t\t\t\t\t<TtlOrgnlAmt>622.00</TtlOrgnlAmt>\n\t\t\t\t\t<TtlAuthrsdAmt>622.00</TtlAuthrsdAmt>\n\t\t\t\t\t<TtlCaptrdAmt>622.00</TtlCaptrdAmt>\n\t\t\t\t\t<AuthrsdSts>FULL</AuthrsdSts>\n\t\t\t\t\t<CaptrdSts>FULL</CaptrdSts>\n\t\t\t\t\t<CancSts>NONE</CancSts>\n\t\t\t\t\t<Ccy>986</Ccy>\n\t\t\t\t\t<AcctTp>CRDT</AcctTp>\n\t\t\t\t\t<MrchntShrtNm>STONE TEST</MrchntShrtNm>\n\t\t\t\t\t<MrchntCtgyCd>5311</MrchntCtgyCd>\n\t\t\t\t\t<AddtlSvc>INSA</AddtlSvc>\n\t\t\t\t\t<Instlmt>\n\t\t\t\t\t\t<TtlNbOfPmts>8</TtlNbOfPmts>\n\t\t\t\t\t</Instlmt>\n\t\t\t\t</Summry>\n\t\t\t\t<Oprs>\n\t\t\t\t\t<Authstn>\n\t\t\t\t\t\t<RcptOprId>1135000002663228</RcptOprId>\n\t\t\t\t\t\t<AcqrrDtTm>2015-01-13T18:17:26</AcqrrDtTm>\n\t\t\t\t\t\t<LclDtTm>2015-01-13T18:17:25</LclDtTm>\n\t\t\t\t\t\t<OrgnlAmt>622.00</OrgnlAmt>\n\t\t\t\t\t\t<AuthrsdAmt>622.00</AuthrsdAmt>\n\t\t\t\t\t\t<Rspn>APPR</Rspn>\n\t\t\t\t\t\t<RspnRsn>0000</RspnRsn>\n\t\t\t\t\t\t<AuthstnCd>172675</AuthstnCd>\n\t\t\t\t\t</Authstn>\n\t\t\t\t\t<Captr>\n\t\t\t\t\t\t<RcptOprId>1135000002663232</RcptOprId>\n\t\t\t\t\t\t<AcqrrDtTm>2015-01-13T18:17:28</AcqrrDtTm>\n\t\t\t\t\t\t<LclDtTm>2015-01-13T18:17:28</LclDtTm>\n\t\t\t\t\t\t<Amt>622.00</Amt>\n\t\t\t\t\t\t<Rspn>APPR</Rspn>\n\t\t\t\t\t\t<RspnRsn>0000</RspnRsn>\n\t\t\t\t\t</Captr>\n\t\t\t\t\t<Cxl>\n\t\t\t\t\t\t<RcptOprId>1135000002663232</RcptOprId>\n\t\t\t\t\t\t<AcqrrDtTm>2015-01-13T18:17:28</AcqrrDtTm>\n\t\t\t\t\t\t<LclDtTm>2015-01-13T18:17:28</LclDtTm>\n\t\t\t\t\t\t<Amt>622.00</Amt>\n\t\t\t\t\t\t<Rspn>DECL</Rspn>\n\t\t\t\t\t\t<RspnRsn>0000</RspnRsn>\n\t\t\t\t\t</Cxl>\n\t\t\t\t</Oprs>\n\t\t\t</Tx>\n\t\t</TxStsRptRspn>\n\t</AccptrTxStsRptRspn>\n</Document>","language":"xml","status":200},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","url":"/TransactionStatusReport"},"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"O que é Consulta de Transação ?\"\n}\n[/block]\nA consulta de transação é uma mensagem enviada pelo sistema do cliente (lojista) para a adquirente com informações de uma transação para que ela envie ao cliente os dados acerca da transação em questão de a garantir acesso à informações mais detalhadas sobre a sua transação.  \n[block:api-header]\n{\n  \"type\": \"post\",\n  \"title\": \"TransactionStatusReport\"\n}\n[/block]\n**QUANDO ENVIAR ?**\n\n* Quando deseja-se confirmar se o valor correto de uma transação foi capturado e/ou autorizado\n\n* Quando deseja-se confirmar se uma transação foi cancelada ou não\n\n* Quando deseja-se confirmar algum tipo de erro nas requisições anteriores : Autorização, Captura ou Cancelamento\n\n**XML DE REQUISIÇÃO DE CONSULTA DE TRANSAÇÃO COMENTADO**\n\nA mensagem AcceptorTransactionStatusReportRequest é utilizada para realizar um pedido de consulta de uma transação e deve ser enviada para a url [https://e-commerce.stone.com.br/TransactionStatusReport](https://e-commerce.stone.com.br/TransactionStatusReport)( produção ) ou [https://sandbox-auth-integration.stone.com.br/TransactionStatusReport](https://sandbox-auth-integration.stone.com.br/TransactionStatusReport) (homologação).\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Campo\",\n    \"h-1\": \"Ocorrência\",\n    \"h-2\": \"Tipo\",\n    \"h-3\": \"Descrição\",\n    \"h-4\": \"Obrigatório\",\n    \"0-0\": \"AcceptorTransactionStatusReportRequest<AccptrTxStsRptRq>\",\n    \"1-0\": \"Header<Hdr>\",\n    \"2-0\": \"MessageFunction<MsgFctn>\",\n    \"3-0\": \"ProtocolVersion<PrtcolVrsn>\",\n    \"4-0\": \"InitialParty<InitgPty>\",\n    \"5-0\": \"Identification<Id>\",\n    \"6-0\": \"TransactionStatusReport<TxStsRpt>\",\n    \"7-0\": \"Transaction<Tx>\",\n    \"8-0\": \"TransactionReport<TxRpt>\",\n    \"9-0\": \"OriginalTransaction<OrgnlTx>\",\n    \"10-0\": \"RecipientTransactionIdentification<RcptTxId>\",\n    \"11-0\": \"InitiatorTransactionIdentificationi<InitrTxId>\",\n    \"0-1\": \"1\",\n    \"1-1\": \"1\",\n    \"2-1\": \"1\",\n    \"3-1\": \"1\",\n    \"4-1\": \"1\",\n    \"5-1\": \"1\",\n    \"6-1\": \"1\",\n    \"7-1\": \"1 ou mais\",\n    \"8-1\": \"1 ou mais\",\n    \"9-1\": \"1\",\n    \"10-1\": \"0 a 1\",\n    \"11-1\": \"0 a 1\",\n    \"0-2\": \"Container\",\n    \"0-4\": \"Sim\",\n    \"1-4\": \"Sim\",\n    \"2-4\": \"Sim\",\n    \"3-4\": \"Sim\",\n    \"4-4\": \"Sim\",\n    \"5-4\": \"Sim\",\n    \"6-4\": \"Sim\",\n    \"7-4\": \"Sim\",\n    \"8-4\": \"Sim\",\n    \"9-4\": \"Sim\",\n    \"10-4\": \"Não\",\n    \"11-4\": \"Não\",\n    \"1-2\": \"Container\",\n    \"2-2\": \"CodeSet\",\n    \"3-2\": \"Text\",\n    \"4-2\": \"Container\",\n    \"5-2\": \"Text\",\n    \"6-2\": \"Container\",\n    \"7-2\": \"Container\",\n    \"8-2\": \"Container\",\n    \"9-2\": \"Container\",\n    \"10-2\": \"Text\",\n    \"11-2\": \"Text\",\n    \"0-3\": \"Raiz da requisição de consulta de transação\",\n    \"1-3\": \"Cabeçalho da mensagem\",\n    \"2-3\": \"O valor deve ser TSRR para a mensagem de AcceptorTransactionStatusReportRequestV02.1\",\n    \"3-3\": \"O valor deve ser 2.0 para a esta mensagem\",\n    \"4-3\": \"Identificação unica da parte que iniciou a requisição ( cliente )\",\n    \"5-3\": \"Id do terminal ou id do lojista, mais conhecido como salleAffiliationKey ( SAK )\",\n    \"6-3\": \"Raiz das informações sobre a transação consultada\",\n    \"7-3\": \"Coleção de transações para pesquisa.\",\n    \"8-3\": \"Define o tipo de Resposta\\n\\nOPRS = Retorna os dados de todas as operações da transação.\\n\\nSUMM = Retorna um relatorio detalhado sobre a transação.\",\n    \"9-3\": \"Dados da transação original.\",\n    \"10-3\": \"Identificador da transação fornecido pelo adquirente na resposta da autorização.\",\n    \"11-3\": \"Identificação da transação definida pelo sistema que se comunica com o Host Stone.\\n\\nTamanho máximo : \\n 32 caracteres\"\n  },\n  \"cols\": 5,\n  \"rows\": 12\n}\n[/block]\n**XML DE RESPOSTA DE CONSULTA DE TRANSAÇÃO COMENTADO**\n\nA mensagem AcceptorTransactionStatusReportResponse é respondida pelo adquirente com as informações sobre a requisição de cancelamento AcceptorTransactionStatusReportRequest.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Campo\",\n    \"h-1\": \"Ocorrência\",\n    \"h-2\": \"Tipo\",\n    \"h-3\": \"Descrição\",\n    \"h-4\": \"Obrigatório\",\n    \"0-0\": \"TransactionStatusReportResponse<TxStsRptRspn>\",\n    \"1-0\": \"Transaction<Tx>\",\n    \"2-0\": \"Summary<Summry>\",\n    \"3-0\": \"RecipientTransactionIdentification<RcptTxId>\",\n    \"4-0\": \"InitiatorTransactionIdentification<InitrTxId>\",\n    \"5-0\": \"AcquirerDateTime<AcqrrDtTm>\",\n    \"6-0\": \"LocalDateTime<LclDtTm>\",\n    \"7-0\": \"FirstCaptureDateTime<FrstCaptrDtTm>\",\n    \"8-0\": \"FirstCancellationDateTime<FrstCxlDtTm>\",\n    \"9-0\": \"TotalOriginalAmount<TtlOrgnlAmt>\",\n    \"10-0\": \"TotalAuthorisedAmount<TtlAuthrsdAmt>\",\n    \"11-0\": \"TotalCapturedAmount<TtlCaptrdAmt>\",\n    \"12-0\": \"TotalCancelledAmount<TtlCancAmt>\",\n    \"13-0\": \"AuthorisedStatus<AuthrsdSts>\",\n    \"14-0\": \"CapturedStatus<CaptrdSts>\",\n    \"15-0\": \"CancelledStatus<CancSts>\",\n    \"16-0\": \"Currency<Ccy>\",\n    \"17-0\": \"AccountType<AcctTp>\",\n    \"18-0\": \"MerchantShortName<MrchntShrtNm>\",\n    \"19-0\": \"MerchantCategoryCode<MrchntCtgyCd>\",\n    \"20-0\": \"AdditionalService<AddtlSvc>\",\n    \"21-0\": \"Installment<Instlmt>\",\n    \"22-0\": \"TotalNumberOfPayments<TtlNbOfPmts>\",\n    \"23-0\": \"Operations<Oprs>\",\n    \"24-0\": \"Authorisation<Authstn>\",\n    \"25-0\": \"ReceptorOperationIdentification<RcptOprId>\",\n    \"26-0\": \"AcquirerDateTime<AcqrrDtTm>\",\n    \"27-0\": \"LocalDateTime<LclDtTm>\",\n    \"28-0\": \"OriginalAmount<OrgnAmt>\",\n    \"29-0\": \"Response<Rspn>\",\n    \"30-0\": \"ResponseReason<RspnRsn>\",\n    \"31-0\": \"AuthorisationCode<AuthstnCd>\",\n    \"32-0\": \"Capture<Cptr>\",\n    \"33-0\": \"Cancellation<Cxl>\",\n    \"0-1\": \"1\",\n    \"1-1\": \"1 ou mais\",\n    \"2-1\": \"1\",\n    \"3-1\": \"1\",\n    \"4-1\": \"1\",\n    \"5-1\": \"1\",\n    \"6-1\": \"1\",\n    \"7-1\": \"1\",\n    \"8-1\": \"1\",\n    \"9-1\": \"1\",\n    \"10-1\": \"1\",\n    \"11-1\": \"1\",\n    \"12-1\": \"1\",\n    \"13-1\": \"1\",\n    \"14-1\": \"1\",\n    \"15-1\": \"1\",\n    \"16-1\": \"1\",\n    \"17-1\": \"1\",\n    \"18-1\": \"1\",\n    \"19-1\": \"1\",\n    \"20-1\": \"1\",\n    \"21-1\": \"1\",\n    \"22-1\": \"1\",\n    \"23-1\": \"1\",\n    \"24-1\": \"1\",\n    \"25-1\": \"1\",\n    \"26-1\": \"1\",\n    \"27-1\": \"1\",\n    \"28-1\": \"1\",\n    \"29-1\": \"1\",\n    \"30-1\": \"1\",\n    \"31-1\": \"1\",\n    \"32-1\": \"1 ou mais\",\n    \"33-1\": \"1 ou mais\",\n    \"0-2\": \"Container\",\n    \"1-2\": \"Container\",\n    \"2-2\": \"Container\",\n    \"3-2\": \"Text\",\n    \"4-2\": \"Text\",\n    \"5-2\": \"DateTime\",\n    \"6-2\": \"DateTime\",\n    \"7-2\": \"DateTime\",\n    \"8-2\": \"DateTime\",\n    \"9-2\": \"Amount\",\n    \"10-2\": \"Amount\",\n    \"11-2\": \"Amount\",\n    \"12-2\": \"Amount\",\n    \"13-2\": \"CodeSet\",\n    \"14-2\": \"CodeSet\",\n    \"13-3\": \"Status da transação\\n\\nFULL : Indica que o valor integral da transação foi autorizado.\\n\\nPART : Indica que o valor original foi autorizado parcialmente\\n\\nNONE : Indica que a transação não foi autorizada\",\n    \"14-3\": \"Status da captura\\n\\nFULL : Indica que o valor total da transação foi capturado.\\n\\nPART : Indica que somente parte do valor autorizado foi capturado.\\n\\nNONE: Indica que a transação não foi capturada.\",\n    \"15-2\": \"Text\",\n    \"15-3\": \"Moeda da transação original\",\n    \"16-3\": \"Tipo de conta da transação original\\n\\nCRDT : Crédito\\n\\nCHCK : Debito\",\n    \"16-2\": \"CodeSet\",\n    \"17-3\": \"Nome do lojista usado na transação\\nSerá exibido o soft descriptor quando este for enviado, se não o nome padrão do lojista será retornado.\",\n    \"17-2\": \"Text\",\n    \"18-2\": \"Text\",\n    \"19-2\": \"Text\",\n    \"20-2\": \"CodeSet\",\n    \"21-2\": \"Container\",\n    \"22-2\": \"Quantity\",\n    \"23-2\": \"Container\",\n    \"24-2\": \"Container\",\n    \"25-2\": \"Text\",\n    \"26-2\": \"DateTime\",\n    \"27-2\": \"DateTime\",\n    \"28-2\": \"Amount\",\n    \"29-2\": \"CodeSet\",\n    \"30-2\": \"Text\",\n    \"31-2\": \"Text\",\n    \"32-2\": \"Container\",\n    \"33-2\": \"Container\",\n    \"0-3\": \"Conteudo da resposta da pesuisa\",\n    \"1-3\": \"Coleção de resultados de transações\",\n    \"2-3\": \"Parte detalhada de imformaçoes sobre a transação\",\n    \"3-3\": \"Identificador do adquirente para a transação\",\n    \"4-3\": \"Identificador único da transação para o cliente ( lojista )\",\n    \"5-3\": \"Data da transação no adquirente.\\nFormato: yyyy-MM-ddTHH:mm:ss\",\n    \"6-3\": \"Data do local da transação.\\nFormato: yyyy-MM-ddTHH:mm:ss.\",\n    \"7-3\": \"Data da primeira captura.\\nFormato: yyyy-MM-ddTHH:mm:ss\",\n    \"8-3\": \"Data do primeiro cancelamento\\nFormato: yyyy-MM-ddTHH:mm:ss\",\n    \"9-3\": \"Valor original da transação\\nFomato: {0.00}\",\n    \"10-3\": \"Valor autorizado da transação\\nFomato: {0.00}\",\n    \"11-3\": \"Valor capturado da transação\\nFomato: {0.00}\",\n    \"12-3\": \"Valor cancelado da transação\\nFomato: {0.00}\",\n    \"18-3\": \"Nome do lojista usado na transação\\nSerá exibido o soft descriptor quando este for enviado, se não o nome padrão do lojista será retornado.\",\n    \"19-3\": \"Sera retornado o Mcc usado na hora da transação, caso não tenha sido informado sera retornado o mcc padrão do lojista.\",\n    \"20-3\": \"Serviços adicionais:\\n\\nINSA:Indica que foi solicitado parcelamento tipo lojista “sem juros”.\\nINSI : Indica que foi solicitado parcelamento tipo emissor “com juros”\",\n    \"21-3\": \"Informações da parcela\",\n    \"22-3\": \"Numero de parcelas da transação\",\n    \"23-3\": \"Operações da transação\",\n    \"24-3\": \"Informações sobre a autorização\",\n    \"25-3\": \"Número da operação no adquirente.\",\n    \"26-3\": \"Data da transação no adquirente\\nFormato: yyyy-MM-ddTHH:mm:ss\",\n    \"27-3\": \"Data do local da transação\\nFormato: yyyy-MM-ddTHH:mm:ss\",\n    \"28-3\": \"Dados da transação original\\nFormato: {0.00}\",\n    \"29-3\": \"Resposta para a transação:\\n\\nDECL : A operação não foi autorizada\\nAPPR : A Operação foi autorizada\\nTECH : Ocorreu um erro na operação\",\n    \"30-3\": \"Codigo de resposta para a transação\",\n    \"31-3\": \"Codigo de autorização fornecido pelo banco\",\n    \"32-3\": \"Informações sobre as capturas\",\n    \"33-3\": \"Informações sobre as capturas\"\n  },\n  \"cols\": 4,\n  \"rows\": 34\n}\n[/block]","category":"583f0fb04828d50f00126d51","createdAt":"2016-12-16T15:16:03.249Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":9,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"consulta-de-transações-2","sync_unique":"","title":"Consulta de Transações","type":"post","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

postConsulta de Transações


[block:api-header] { "type": "basic", "title": "O que é Consulta de Transação ?" } [/block] A consulta de transação é uma mensagem enviada pelo sistema do cliente (lojista) para a adquirente com informações de uma transação para que ela envie ao cliente os dados acerca da transação em questão de a garantir acesso à informações mais detalhadas sobre a sua transação. [block:api-header] { "type": "post", "title": "TransactionStatusReport" } [/block] **QUANDO ENVIAR ?** * Quando deseja-se confirmar se o valor correto de uma transação foi capturado e/ou autorizado * Quando deseja-se confirmar se uma transação foi cancelada ou não * Quando deseja-se confirmar algum tipo de erro nas requisições anteriores : Autorização, Captura ou Cancelamento **XML DE REQUISIÇÃO DE CONSULTA DE TRANSAÇÃO COMENTADO** A mensagem AcceptorTransactionStatusReportRequest é utilizada para realizar um pedido de consulta de uma transação e deve ser enviada para a url [https://e-commerce.stone.com.br/TransactionStatusReport](https://e-commerce.stone.com.br/TransactionStatusReport)( produção ) ou [https://sandbox-auth-integration.stone.com.br/TransactionStatusReport](https://sandbox-auth-integration.stone.com.br/TransactionStatusReport) (homologação). [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "AcceptorTransactionStatusReportRequest<AccptrTxStsRptRq>", "1-0": "Header<Hdr>", "2-0": "MessageFunction<MsgFctn>", "3-0": "ProtocolVersion<PrtcolVrsn>", "4-0": "InitialParty<InitgPty>", "5-0": "Identification<Id>", "6-0": "TransactionStatusReport<TxStsRpt>", "7-0": "Transaction<Tx>", "8-0": "TransactionReport<TxRpt>", "9-0": "OriginalTransaction<OrgnlTx>", "10-0": "RecipientTransactionIdentification<RcptTxId>", "11-0": "InitiatorTransactionIdentificationi<InitrTxId>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1 ou mais", "8-1": "1 ou mais", "9-1": "1", "10-1": "0 a 1", "11-1": "0 a 1", "0-2": "Container", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Sim", "8-4": "Sim", "9-4": "Sim", "10-4": "Não", "11-4": "Não", "1-2": "Container", "2-2": "CodeSet", "3-2": "Text", "4-2": "Container", "5-2": "Text", "6-2": "Container", "7-2": "Container", "8-2": "Container", "9-2": "Container", "10-2": "Text", "11-2": "Text", "0-3": "Raiz da requisição de consulta de transação", "1-3": "Cabeçalho da mensagem", "2-3": "O valor deve ser TSRR para a mensagem de AcceptorTransactionStatusReportRequestV02.1", "3-3": "O valor deve ser 2.0 para a esta mensagem", "4-3": "Identificação unica da parte que iniciou a requisição ( cliente )", "5-3": "Id do terminal ou id do lojista, mais conhecido como salleAffiliationKey ( SAK )", "6-3": "Raiz das informações sobre a transação consultada", "7-3": "Coleção de transações para pesquisa.", "8-3": "Define o tipo de Resposta\n\nOPRS = Retorna os dados de todas as operações da transação.\n\nSUMM = Retorna um relatorio detalhado sobre a transação.", "9-3": "Dados da transação original.", "10-3": "Identificador da transação fornecido pelo adquirente na resposta da autorização.", "11-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n\nTamanho máximo : \n 32 caracteres" }, "cols": 5, "rows": 12 } [/block] **XML DE RESPOSTA DE CONSULTA DE TRANSAÇÃO COMENTADO** A mensagem AcceptorTransactionStatusReportResponse é respondida pelo adquirente com as informações sobre a requisição de cancelamento AcceptorTransactionStatusReportRequest. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "TransactionStatusReportResponse<TxStsRptRspn>", "1-0": "Transaction<Tx>", "2-0": "Summary<Summry>", "3-0": "RecipientTransactionIdentification<RcptTxId>", "4-0": "InitiatorTransactionIdentification<InitrTxId>", "5-0": "AcquirerDateTime<AcqrrDtTm>", "6-0": "LocalDateTime<LclDtTm>", "7-0": "FirstCaptureDateTime<FrstCaptrDtTm>", "8-0": "FirstCancellationDateTime<FrstCxlDtTm>", "9-0": "TotalOriginalAmount<TtlOrgnlAmt>", "10-0": "TotalAuthorisedAmount<TtlAuthrsdAmt>", "11-0": "TotalCapturedAmount<TtlCaptrdAmt>", "12-0": "TotalCancelledAmount<TtlCancAmt>", "13-0": "AuthorisedStatus<AuthrsdSts>", "14-0": "CapturedStatus<CaptrdSts>", "15-0": "CancelledStatus<CancSts>", "16-0": "Currency<Ccy>", "17-0": "AccountType<AcctTp>", "18-0": "MerchantShortName<MrchntShrtNm>", "19-0": "MerchantCategoryCode<MrchntCtgyCd>", "20-0": "AdditionalService<AddtlSvc>", "21-0": "Installment<Instlmt>", "22-0": "TotalNumberOfPayments<TtlNbOfPmts>", "23-0": "Operations<Oprs>", "24-0": "Authorisation<Authstn>", "25-0": "ReceptorOperationIdentification<RcptOprId>", "26-0": "AcquirerDateTime<AcqrrDtTm>", "27-0": "LocalDateTime<LclDtTm>", "28-0": "OriginalAmount<OrgnAmt>", "29-0": "Response<Rspn>", "30-0": "ResponseReason<RspnRsn>", "31-0": "AuthorisationCode<AuthstnCd>", "32-0": "Capture<Cptr>", "33-0": "Cancellation<Cxl>", "0-1": "1", "1-1": "1 ou mais", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "8-1": "1", "9-1": "1", "10-1": "1", "11-1": "1", "12-1": "1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "1", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "1", "24-1": "1", "25-1": "1", "26-1": "1", "27-1": "1", "28-1": "1", "29-1": "1", "30-1": "1", "31-1": "1", "32-1": "1 ou mais", "33-1": "1 ou mais", "0-2": "Container", "1-2": "Container", "2-2": "Container", "3-2": "Text", "4-2": "Text", "5-2": "DateTime", "6-2": "DateTime", "7-2": "DateTime", "8-2": "DateTime", "9-2": "Amount", "10-2": "Amount", "11-2": "Amount", "12-2": "Amount", "13-2": "CodeSet", "14-2": "CodeSet", "13-3": "Status da transação\n\nFULL : Indica que o valor integral da transação foi autorizado.\n\nPART : Indica que o valor original foi autorizado parcialmente\n\nNONE : Indica que a transação não foi autorizada", "14-3": "Status da captura\n\nFULL : Indica que o valor total da transação foi capturado.\n\nPART : Indica que somente parte do valor autorizado foi capturado.\n\nNONE: Indica que a transação não foi capturada.", "15-2": "Text", "15-3": "Moeda da transação original", "16-3": "Tipo de conta da transação original\n\nCRDT : Crédito\n\nCHCK : Debito", "16-2": "CodeSet", "17-3": "Nome do lojista usado na transação\nSerá exibido o soft descriptor quando este for enviado, se não o nome padrão do lojista será retornado.", "17-2": "Text", "18-2": "Text", "19-2": "Text", "20-2": "CodeSet", "21-2": "Container", "22-2": "Quantity", "23-2": "Container", "24-2": "Container", "25-2": "Text", "26-2": "DateTime", "27-2": "DateTime", "28-2": "Amount", "29-2": "CodeSet", "30-2": "Text", "31-2": "Text", "32-2": "Container", "33-2": "Container", "0-3": "Conteudo da resposta da pesuisa", "1-3": "Coleção de resultados de transações", "2-3": "Parte detalhada de imformaçoes sobre a transação", "3-3": "Identificador do adquirente para a transação", "4-3": "Identificador único da transação para o cliente ( lojista )", "5-3": "Data da transação no adquirente.\nFormato: yyyy-MM-ddTHH:mm:ss", "6-3": "Data do local da transação.\nFormato: yyyy-MM-ddTHH:mm:ss.", "7-3": "Data da primeira captura.\nFormato: yyyy-MM-ddTHH:mm:ss", "8-3": "Data do primeiro cancelamento\nFormato: yyyy-MM-ddTHH:mm:ss", "9-3": "Valor original da transação\nFomato: {0.00}", "10-3": "Valor autorizado da transação\nFomato: {0.00}", "11-3": "Valor capturado da transação\nFomato: {0.00}", "12-3": "Valor cancelado da transação\nFomato: {0.00}", "18-3": "Nome do lojista usado na transação\nSerá exibido o soft descriptor quando este for enviado, se não o nome padrão do lojista será retornado.", "19-3": "Sera retornado o Mcc usado na hora da transação, caso não tenha sido informado sera retornado o mcc padrão do lojista.", "20-3": "Serviços adicionais:\n\nINSA:Indica que foi solicitado parcelamento tipo lojista “sem juros”.\nINSI : Indica que foi solicitado parcelamento tipo emissor “com juros”", "21-3": "Informações da parcela", "22-3": "Numero de parcelas da transação", "23-3": "Operações da transação", "24-3": "Informações sobre a autorização", "25-3": "Número da operação no adquirente.", "26-3": "Data da transação no adquirente\nFormato: yyyy-MM-ddTHH:mm:ss", "27-3": "Data do local da transação\nFormato: yyyy-MM-ddTHH:mm:ss", "28-3": "Dados da transação original\nFormato: {0.00}", "29-3": "Resposta para a transação:\n\nDECL : A operação não foi autorizada\nAPPR : A Operação foi autorizada\nTECH : Ocorreu um erro na operação", "30-3": "Codigo de resposta para a transação", "31-3": "Codigo de autorização fornecido pelo banco", "32-3": "Informações sobre as capturas", "33-3": "Informações sobre as capturas" }, "cols": 4, "rows": 34 } [/block]

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



[block:api-header] { "type": "basic", "title": "O que é Consulta de Transação ?" } [/block] A consulta de transação é uma mensagem enviada pelo sistema do cliente (lojista) para a adquirente com informações de uma transação para que ela envie ao cliente os dados acerca da transação em questão de a garantir acesso à informações mais detalhadas sobre a sua transação. [block:api-header] { "type": "post", "title": "TransactionStatusReport" } [/block] **QUANDO ENVIAR ?** * Quando deseja-se confirmar se o valor correto de uma transação foi capturado e/ou autorizado * Quando deseja-se confirmar se uma transação foi cancelada ou não * Quando deseja-se confirmar algum tipo de erro nas requisições anteriores : Autorização, Captura ou Cancelamento **XML DE REQUISIÇÃO DE CONSULTA DE TRANSAÇÃO COMENTADO** A mensagem AcceptorTransactionStatusReportRequest é utilizada para realizar um pedido de consulta de uma transação e deve ser enviada para a url [https://e-commerce.stone.com.br/TransactionStatusReport](https://e-commerce.stone.com.br/TransactionStatusReport)( produção ) ou [https://sandbox-auth-integration.stone.com.br/TransactionStatusReport](https://sandbox-auth-integration.stone.com.br/TransactionStatusReport) (homologação). [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "AcceptorTransactionStatusReportRequest<AccptrTxStsRptRq>", "1-0": "Header<Hdr>", "2-0": "MessageFunction<MsgFctn>", "3-0": "ProtocolVersion<PrtcolVrsn>", "4-0": "InitialParty<InitgPty>", "5-0": "Identification<Id>", "6-0": "TransactionStatusReport<TxStsRpt>", "7-0": "Transaction<Tx>", "8-0": "TransactionReport<TxRpt>", "9-0": "OriginalTransaction<OrgnlTx>", "10-0": "RecipientTransactionIdentification<RcptTxId>", "11-0": "InitiatorTransactionIdentificationi<InitrTxId>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1 ou mais", "8-1": "1 ou mais", "9-1": "1", "10-1": "0 a 1", "11-1": "0 a 1", "0-2": "Container", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "7-4": "Sim", "8-4": "Sim", "9-4": "Sim", "10-4": "Não", "11-4": "Não", "1-2": "Container", "2-2": "CodeSet", "3-2": "Text", "4-2": "Container", "5-2": "Text", "6-2": "Container", "7-2": "Container", "8-2": "Container", "9-2": "Container", "10-2": "Text", "11-2": "Text", "0-3": "Raiz da requisição de consulta de transação", "1-3": "Cabeçalho da mensagem", "2-3": "O valor deve ser TSRR para a mensagem de AcceptorTransactionStatusReportRequestV02.1", "3-3": "O valor deve ser 2.0 para a esta mensagem", "4-3": "Identificação unica da parte que iniciou a requisição ( cliente )", "5-3": "Id do terminal ou id do lojista, mais conhecido como salleAffiliationKey ( SAK )", "6-3": "Raiz das informações sobre a transação consultada", "7-3": "Coleção de transações para pesquisa.", "8-3": "Define o tipo de Resposta\n\nOPRS = Retorna os dados de todas as operações da transação.\n\nSUMM = Retorna um relatorio detalhado sobre a transação.", "9-3": "Dados da transação original.", "10-3": "Identificador da transação fornecido pelo adquirente na resposta da autorização.", "11-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n\nTamanho máximo : \n 32 caracteres" }, "cols": 5, "rows": 12 } [/block] **XML DE RESPOSTA DE CONSULTA DE TRANSAÇÃO COMENTADO** A mensagem AcceptorTransactionStatusReportResponse é respondida pelo adquirente com as informações sobre a requisição de cancelamento AcceptorTransactionStatusReportRequest. [block:parameters] { "data": { "h-0": "Campo", "h-1": "Ocorrência", "h-2": "Tipo", "h-3": "Descrição", "h-4": "Obrigatório", "0-0": "TransactionStatusReportResponse<TxStsRptRspn>", "1-0": "Transaction<Tx>", "2-0": "Summary<Summry>", "3-0": "RecipientTransactionIdentification<RcptTxId>", "4-0": "InitiatorTransactionIdentification<InitrTxId>", "5-0": "AcquirerDateTime<AcqrrDtTm>", "6-0": "LocalDateTime<LclDtTm>", "7-0": "FirstCaptureDateTime<FrstCaptrDtTm>", "8-0": "FirstCancellationDateTime<FrstCxlDtTm>", "9-0": "TotalOriginalAmount<TtlOrgnlAmt>", "10-0": "TotalAuthorisedAmount<TtlAuthrsdAmt>", "11-0": "TotalCapturedAmount<TtlCaptrdAmt>", "12-0": "TotalCancelledAmount<TtlCancAmt>", "13-0": "AuthorisedStatus<AuthrsdSts>", "14-0": "CapturedStatus<CaptrdSts>", "15-0": "CancelledStatus<CancSts>", "16-0": "Currency<Ccy>", "17-0": "AccountType<AcctTp>", "18-0": "MerchantShortName<MrchntShrtNm>", "19-0": "MerchantCategoryCode<MrchntCtgyCd>", "20-0": "AdditionalService<AddtlSvc>", "21-0": "Installment<Instlmt>", "22-0": "TotalNumberOfPayments<TtlNbOfPmts>", "23-0": "Operations<Oprs>", "24-0": "Authorisation<Authstn>", "25-0": "ReceptorOperationIdentification<RcptOprId>", "26-0": "AcquirerDateTime<AcqrrDtTm>", "27-0": "LocalDateTime<LclDtTm>", "28-0": "OriginalAmount<OrgnAmt>", "29-0": "Response<Rspn>", "30-0": "ResponseReason<RspnRsn>", "31-0": "AuthorisationCode<AuthstnCd>", "32-0": "Capture<Cptr>", "33-0": "Cancellation<Cxl>", "0-1": "1", "1-1": "1 ou mais", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "7-1": "1", "8-1": "1", "9-1": "1", "10-1": "1", "11-1": "1", "12-1": "1", "13-1": "1", "14-1": "1", "15-1": "1", "16-1": "1", "17-1": "1", "18-1": "1", "19-1": "1", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "1", "24-1": "1", "25-1": "1", "26-1": "1", "27-1": "1", "28-1": "1", "29-1": "1", "30-1": "1", "31-1": "1", "32-1": "1 ou mais", "33-1": "1 ou mais", "0-2": "Container", "1-2": "Container", "2-2": "Container", "3-2": "Text", "4-2": "Text", "5-2": "DateTime", "6-2": "DateTime", "7-2": "DateTime", "8-2": "DateTime", "9-2": "Amount", "10-2": "Amount", "11-2": "Amount", "12-2": "Amount", "13-2": "CodeSet", "14-2": "CodeSet", "13-3": "Status da transação\n\nFULL : Indica que o valor integral da transação foi autorizado.\n\nPART : Indica que o valor original foi autorizado parcialmente\n\nNONE : Indica que a transação não foi autorizada", "14-3": "Status da captura\n\nFULL : Indica que o valor total da transação foi capturado.\n\nPART : Indica que somente parte do valor autorizado foi capturado.\n\nNONE: Indica que a transação não foi capturada.", "15-2": "Text", "15-3": "Moeda da transação original", "16-3": "Tipo de conta da transação original\n\nCRDT : Crédito\n\nCHCK : Debito", "16-2": "CodeSet", "17-3": "Nome do lojista usado na transação\nSerá exibido o soft descriptor quando este for enviado, se não o nome padrão do lojista será retornado.", "17-2": "Text", "18-2": "Text", "19-2": "Text", "20-2": "CodeSet", "21-2": "Container", "22-2": "Quantity", "23-2": "Container", "24-2": "Container", "25-2": "Text", "26-2": "DateTime", "27-2": "DateTime", "28-2": "Amount", "29-2": "CodeSet", "30-2": "Text", "31-2": "Text", "32-2": "Container", "33-2": "Container", "0-3": "Conteudo da resposta da pesuisa", "1-3": "Coleção de resultados de transações", "2-3": "Parte detalhada de imformaçoes sobre a transação", "3-3": "Identificador do adquirente para a transação", "4-3": "Identificador único da transação para o cliente ( lojista )", "5-3": "Data da transação no adquirente.\nFormato: yyyy-MM-ddTHH:mm:ss", "6-3": "Data do local da transação.\nFormato: yyyy-MM-ddTHH:mm:ss.", "7-3": "Data da primeira captura.\nFormato: yyyy-MM-ddTHH:mm:ss", "8-3": "Data do primeiro cancelamento\nFormato: yyyy-MM-ddTHH:mm:ss", "9-3": "Valor original da transação\nFomato: {0.00}", "10-3": "Valor autorizado da transação\nFomato: {0.00}", "11-3": "Valor capturado da transação\nFomato: {0.00}", "12-3": "Valor cancelado da transação\nFomato: {0.00}", "18-3": "Nome do lojista usado na transação\nSerá exibido o soft descriptor quando este for enviado, se não o nome padrão do lojista será retornado.", "19-3": "Sera retornado o Mcc usado na hora da transação, caso não tenha sido informado sera retornado o mcc padrão do lojista.", "20-3": "Serviços adicionais:\n\nINSA:Indica que foi solicitado parcelamento tipo lojista “sem juros”.\nINSI : Indica que foi solicitado parcelamento tipo emissor “com juros”", "21-3": "Informações da parcela", "22-3": "Numero de parcelas da transação", "23-3": "Operações da transação", "24-3": "Informações sobre a autorização", "25-3": "Número da operação no adquirente.", "26-3": "Data da transação no adquirente\nFormato: yyyy-MM-ddTHH:mm:ss", "27-3": "Data do local da transação\nFormato: yyyy-MM-ddTHH:mm:ss", "28-3": "Dados da transação original\nFormato: {0.00}", "29-3": "Resposta para a transação:\n\nDECL : A operação não foi autorizada\nAPPR : A Operação foi autorizada\nTECH : Ocorreu um erro na operação", "30-3": "Codigo de resposta para a transação", "31-3": "Codigo de autorização fornecido pelo banco", "32-3": "Informações sobre as capturas", "33-3": "Informações sobre as capturas" }, "cols": 4, "rows": 34 } [/block]
{"__v":0,"_id":"5845964ee055290f00c029d4","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"Os códigos de retorno listados abaixo fazem referência aos possíveis retornos do campo **ResponseReason <RspnRsn>**","category":"584eb07a1318690f009c7a9c","createdAt":"2016-12-05T16:31:10.701Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":0,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"códigos-de-retorno","sync_unique":"","title":"Códigos de Retorno","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Códigos de Retorno


Os códigos de retorno listados abaixo fazem referência aos possíveis retornos do campo **ResponseReason <RspnRsn>**
Os códigos de retorno listados abaixo fazem referência aos possíveis retornos do campo **ResponseReason <RspnRsn>**
{"__v":0,"_id":"584596599f79b51900b07693","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Código\",\n    \"h-1\": \"Mensagem\",\n    \"h-2\": \"Orientação\",\n    \"h-3\": \"Pode retentar?\",\n    \"0-0\": \"0000\",\n    \"0-1\": \"Transação autorizada\",\n    \"0-2\": \"#\",\n    \"0-3\": \"#\",\n    \"1-0\": \"0001\",\n    \"1-1\": \"Transação autorizada\",\n    \"1-2\": \"Verifique a identidade antes de autorizar\",\n    \"1-3\": \"#\"\n  },\n  \"cols\": 4,\n  \"rows\": 2\n}\n[/block]","category":"584eb07a1318690f009c7a9c","createdAt":"2016-12-05T16:31:21.139Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":2,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"transações-aprovadas","sync_unique":"","title":"Transações Aprovadas","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Transações Aprovadas


[block:parameters] { "data": { "h-0": "Código", "h-1": "Mensagem", "h-2": "Orientação", "h-3": "Pode retentar?", "0-0": "0000", "0-1": "Transação autorizada", "0-2": "#", "0-3": "#", "1-0": "0001", "1-1": "Transação autorizada", "1-2": "Verifique a identidade antes de autorizar", "1-3": "#" }, "cols": 4, "rows": 2 } [/block]
[block:parameters] { "data": { "h-0": "Código", "h-1": "Mensagem", "h-2": "Orientação", "h-3": "Pode retentar?", "0-0": "0000", "0-1": "Transação autorizada", "0-2": "#", "0-3": "#", "1-0": "0001", "1-1": "Transação autorizada", "1-2": "Verifique a identidade antes de autorizar", "1-3": "#" }, "cols": 4, "rows": 2 } [/block]
{"__v":0,"_id":"58459664e055290f00c029d5","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Código\",\n    \"h-1\": \"Mensagem\",\n    \"h-2\": \"Orientação\",\n    \"h-3\": \"Pode retentar?\",\n    \"0-0\": \"1000\",\n    \"1-0\": \"1001\",\n    \"2-0\": \"1002\",\n    \"3-0\": \"1003\",\n    \"4-0\": \"1004\",\n    \"5-0\": \"1005\",\n    \"6-0\": \"1006\",\n    \"7-0\": \"1007\",\n    \"8-0\": \"1008\",\n    \"9-0\": \"1009\",\n    \"10-0\": \"1010\",\n    \"11-0\": \"1011\",\n    \"12-0\": \"1013\",\n    \"13-0\": \"1014\",\n    \"14-0\": \"1016\",\n    \"15-0\": \"1017\",\n    \"16-0\": \"1019\",\n    \"17-0\": \"1020\",\n    \"18-0\": \"1021\",\n    \"19-0\": \"1022\",\n    \"20-0\": \"1023\",\n    \"21-0\": \"1024\",\n    \"22-0\": \"1025\",\n    \"23-0\": \"1042\",\n    \"24-0\": \"1045\",\n    \"25-0\": \"2000\",\n    \"26-0\": \"2001\",\n    \"27-0\": \"2002\",\n    \"28-0\": \"2003\",\n    \"29-0\": \"2004\",\n    \"30-0\": \"2005\",\n    \"31-0\": \"2006\",\n    \"32-0\": \"2007\",\n    \"33-0\": \"2008\",\n    \"34-0\": \"2009\",\n    \"35-0\": \"9102\",\n    \"36-0\": \"9108\",\n    \"37-0\": \"9109\",\n    \"38-0\": \"9111\",\n    \"39-0\": \"9112\",\n    \"40-0\": \"9999\",\n    \"0-1\": \"Transação não autorizada\",\n    \"1-1\": \"Cartão vencido\",\n    \"2-1\": \"Transação não permitida\",\n    \"3-1\": \"Rejeitado emissor\",\n    \"4-1\": \"Cartão com restrição\",\n    \"5-1\": \"Transação não autorizada\",\n    \"6-1\": \"Tentativas de senha excedidas\",\n    \"7-1\": \"Rejeitado emissor\",\n    \"8-1\": \"Rejeitado emissor\",\n    \"9-1\": \"Transação não autorizada\",\n    \"10-1\": \"Valor inválido\",\n    \"11-1\": \"Cartão inválido\",\n    \"12-1\": \"Transação não autorizada\",\n    \"13-1\": \"Tipo de conta inválido\",\n    \"14-1\": \"Saldo insuficiente\",\n    \"15-1\": \"Senha inválida\",\n    \"16-1\": \"Transação não permitida\",\n    \"17-1\": \"Transação não permitida\",\n    \"18-1\": \"Rejeitado emissor\",\n    \"19-1\": \"Cartão com restrição\",\n    \"20-1\": \"Rejeitado emissor\",\n    \"21-1\": \"Transação não permitida\",\n    \"22-1\": \"Cartão bloqueado\",\n    \"23-1\": \"Tipo de conta inválido\",\n    \"24-1\": \"Código de segurança inválido\",\n    \"25-1\": \"Cartão com restrição\",\n    \"26-1\": \"Cartão vencido\",\n    \"27-1\": \"Transação não permitida\",\n    \"28-1\": \"Rejeitado emissor\",\n    \"29-1\": \"Cartão com restrição\",\n    \"30-1\": \"Transação não autorizada\",\n    \"31-1\": \"Tentativas de senha excedidas\",\n    \"32-1\": \"Cartão com restrição\",\n    \"33-1\": \"Cartão com restrição\",\n    \"34-1\": \"Cartão com restrição\",\n    \"35-1\": \"Transação inválida\",\n    \"36-1\": \"Erro no processamento\",\n    \"37-1\": \"Erro no processamento\",\n    \"38-1\": \"Time-out na transação\",\n    \"39-1\": \"Emissor indisponível\",\n    \"40-1\": \"Erro não especificado\",\n    \"40-2\": \"#\",\n    \"39-2\": \"#\",\n    \"38-2\": \"#\",\n    \"37-2\": \"#\",\n    \"36-2\": \"#\",\n    \"35-2\": \"#\",\n    \"34-2\": \"#\",\n    \"33-2\": \"#\",\n    \"32-2\": \"#\",\n    \"31-2\": \"#\",\n    \"30-2\": \"#\",\n    \"40-3\": \"#\",\n    \"39-3\": \"Sim\",\n    \"38-3\": \"Sim\",\n    \"37-3\": \"Sim\",\n    \"36-3\": \"Sim\",\n    \"35-3\": \"#\",\n    \"34-3\": \"#\",\n    \"33-3\": \"#\",\n    \"32-3\": \"#\",\n    \"31-3\": \"#\",\n    \"30-3\": \"#\",\n    \"29-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão\",\n    \"28-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão\",\n    \"29-3\": \"#\",\n    \"28-3\": \"#\",\n    \"27-3\": \"#\",\n    \"26-3\": \"#\",\n    \"25-3\": \"#\",\n    \"24-3\": \"Sim\",\n    \"27-2\": \"# \",\n    \"26-2\": \"#\",\n    \"25-2\": \"#\",\n    \"24-2\": \"#\",\n    \"23-3\": \"#\",\n    \"22-3\": \"#\",\n    \"16-3\": \"#\",\n    \"17-3\": \"#\",\n    \"18-3\": \"#\",\n    \"19-3\": \"#\",\n    \"20-3\": \"#\",\n    \"21-3\": \"#\",\n    \"21-2\": \"#\",\n    \"19-2\": \"#\",\n    \"17-2\": \"#\",\n    \"16-2\": \"#\",\n    \"18-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão.\",\n    \"20-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão.\",\n    \"22-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão.\",\n    \"23-2\": \"O tipo de conta selecionado não existe. Ex: uma transação de crédito com um cartão de débito.\",\n    \"15-2\": \"#\",\n    \"14-2\": \"#\",\n    \"14-3\": \"Sim\",\n    \"15-3\": \"Sim\",\n    \"13-2\": \"O tipo de conta selecionado não existe. Ex: uma transação de crédito com um cartão de débito.\",\n    \"13-3\": \"#\",\n    \"12-2\": \"#\",\n    \"11-2\": \"#\",\n    \"10-2\": \"#\",\n    \"9-2\": \"#\",\n    \"12-3\": \"#\",\n    \"11-3\": \"#\",\n    \"10-3\": \"#\",\n    \"9-3\": \"#\",\n    \"8-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão.\",\n    \"7-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão.\",\n    \"8-3\": \"#\",\n    \"7-3\": \"#\",\n    \"3-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão.\",\n    \"4-2\": \"Oriente o portador a entrar em contato com o banco emissor do cartão.\",\n    \"0-2\": \"#\",\n    \"1-2\": \"#\",\n    \"2-2\": \"#\",\n    \"5-2\": \"#\",\n    \"6-2\": \"#\",\n    \"6-3\": \"#\",\n    \"5-3\": \"#\",\n    \"4-3\": \"#\",\n    \"3-3\": \"#\",\n    \"2-3\": \"#\",\n    \"1-3\": \"#\",\n    \"0-3\": \"#\"\n  },\n  \"cols\": 4,\n  \"rows\": 41\n}\n[/block]","category":"584eb07a1318690f009c7a9c","createdAt":"2016-12-05T16:31:32.487Z","excerpt":"","githubsync":"","hidden":false,"isReference":false,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":3,"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"transações-negadas","sync_unique":"","title":"Transações Negadas","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Transações Negadas


[block:parameters] { "data": { "h-0": "Código", "h-1": "Mensagem", "h-2": "Orientação", "h-3": "Pode retentar?", "0-0": "1000", "1-0": "1001", "2-0": "1002", "3-0": "1003", "4-0": "1004", "5-0": "1005", "6-0": "1006", "7-0": "1007", "8-0": "1008", "9-0": "1009", "10-0": "1010", "11-0": "1011", "12-0": "1013", "13-0": "1014", "14-0": "1016", "15-0": "1017", "16-0": "1019", "17-0": "1020", "18-0": "1021", "19-0": "1022", "20-0": "1023", "21-0": "1024", "22-0": "1025", "23-0": "1042", "24-0": "1045", "25-0": "2000", "26-0": "2001", "27-0": "2002", "28-0": "2003", "29-0": "2004", "30-0": "2005", "31-0": "2006", "32-0": "2007", "33-0": "2008", "34-0": "2009", "35-0": "9102", "36-0": "9108", "37-0": "9109", "38-0": "9111", "39-0": "9112", "40-0": "9999", "0-1": "Transação não autorizada", "1-1": "Cartão vencido", "2-1": "Transação não permitida", "3-1": "Rejeitado emissor", "4-1": "Cartão com restrição", "5-1": "Transação não autorizada", "6-1": "Tentativas de senha excedidas", "7-1": "Rejeitado emissor", "8-1": "Rejeitado emissor", "9-1": "Transação não autorizada", "10-1": "Valor inválido", "11-1": "Cartão inválido", "12-1": "Transação não autorizada", "13-1": "Tipo de conta inválido", "14-1": "Saldo insuficiente", "15-1": "Senha inválida", "16-1": "Transação não permitida", "17-1": "Transação não permitida", "18-1": "Rejeitado emissor", "19-1": "Cartão com restrição", "20-1": "Rejeitado emissor", "21-1": "Transação não permitida", "22-1": "Cartão bloqueado", "23-1": "Tipo de conta inválido", "24-1": "Código de segurança inválido", "25-1": "Cartão com restrição", "26-1": "Cartão vencido", "27-1": "Transação não permitida", "28-1": "Rejeitado emissor", "29-1": "Cartão com restrição", "30-1": "Transação não autorizada", "31-1": "Tentativas de senha excedidas", "32-1": "Cartão com restrição", "33-1": "Cartão com restrição", "34-1": "Cartão com restrição", "35-1": "Transação inválida", "36-1": "Erro no processamento", "37-1": "Erro no processamento", "38-1": "Time-out na transação", "39-1": "Emissor indisponível", "40-1": "Erro não especificado", "40-2": "#", "39-2": "#", "38-2": "#", "37-2": "#", "36-2": "#", "35-2": "#", "34-2": "#", "33-2": "#", "32-2": "#", "31-2": "#", "30-2": "#", "40-3": "#", "39-3": "Sim", "38-3": "Sim", "37-3": "Sim", "36-3": "Sim", "35-3": "#", "34-3": "#", "33-3": "#", "32-3": "#", "31-3": "#", "30-3": "#", "29-2": "Oriente o portador a entrar em contato com o banco emissor do cartão", "28-2": "Oriente o portador a entrar em contato com o banco emissor do cartão", "29-3": "#", "28-3": "#", "27-3": "#", "26-3": "#", "25-3": "#", "24-3": "Sim", "27-2": "# ", "26-2": "#", "25-2": "#", "24-2": "#", "23-3": "#", "22-3": "#", "16-3": "#", "17-3": "#", "18-3": "#", "19-3": "#", "20-3": "#", "21-3": "#", "21-2": "#", "19-2": "#", "17-2": "#", "16-2": "#", "18-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "20-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "22-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "23-2": "O tipo de conta selecionado não existe. Ex: uma transação de crédito com um cartão de débito.", "15-2": "#", "14-2": "#", "14-3": "Sim", "15-3": "Sim", "13-2": "O tipo de conta selecionado não existe. Ex: uma transação de crédito com um cartão de débito.", "13-3": "#", "12-2": "#", "11-2": "#", "10-2": "#", "9-2": "#", "12-3": "#", "11-3": "#", "10-3": "#", "9-3": "#", "8-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "7-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "8-3": "#", "7-3": "#", "3-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "4-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "0-2": "#", "1-2": "#", "2-2": "#", "5-2": "#", "6-2": "#", "6-3": "#", "5-3": "#", "4-3": "#", "3-3": "#", "2-3": "#", "1-3": "#", "0-3": "#" }, "cols": 4, "rows": 41 } [/block]
[block:parameters] { "data": { "h-0": "Código", "h-1": "Mensagem", "h-2": "Orientação", "h-3": "Pode retentar?", "0-0": "1000", "1-0": "1001", "2-0": "1002", "3-0": "1003", "4-0": "1004", "5-0": "1005", "6-0": "1006", "7-0": "1007", "8-0": "1008", "9-0": "1009", "10-0": "1010", "11-0": "1011", "12-0": "1013", "13-0": "1014", "14-0": "1016", "15-0": "1017", "16-0": "1019", "17-0": "1020", "18-0": "1021", "19-0": "1022", "20-0": "1023", "21-0": "1024", "22-0": "1025", "23-0": "1042", "24-0": "1045", "25-0": "2000", "26-0": "2001", "27-0": "2002", "28-0": "2003", "29-0": "2004", "30-0": "2005", "31-0": "2006", "32-0": "2007", "33-0": "2008", "34-0": "2009", "35-0": "9102", "36-0": "9108", "37-0": "9109", "38-0": "9111", "39-0": "9112", "40-0": "9999", "0-1": "Transação não autorizada", "1-1": "Cartão vencido", "2-1": "Transação não permitida", "3-1": "Rejeitado emissor", "4-1": "Cartão com restrição", "5-1": "Transação não autorizada", "6-1": "Tentativas de senha excedidas", "7-1": "Rejeitado emissor", "8-1": "Rejeitado emissor", "9-1": "Transação não autorizada", "10-1": "Valor inválido", "11-1": "Cartão inválido", "12-1": "Transação não autorizada", "13-1": "Tipo de conta inválido", "14-1": "Saldo insuficiente", "15-1": "Senha inválida", "16-1": "Transação não permitida", "17-1": "Transação não permitida", "18-1": "Rejeitado emissor", "19-1": "Cartão com restrição", "20-1": "Rejeitado emissor", "21-1": "Transação não permitida", "22-1": "Cartão bloqueado", "23-1": "Tipo de conta inválido", "24-1": "Código de segurança inválido", "25-1": "Cartão com restrição", "26-1": "Cartão vencido", "27-1": "Transação não permitida", "28-1": "Rejeitado emissor", "29-1": "Cartão com restrição", "30-1": "Transação não autorizada", "31-1": "Tentativas de senha excedidas", "32-1": "Cartão com restrição", "33-1": "Cartão com restrição", "34-1": "Cartão com restrição", "35-1": "Transação inválida", "36-1": "Erro no processamento", "37-1": "Erro no processamento", "38-1": "Time-out na transação", "39-1": "Emissor indisponível", "40-1": "Erro não especificado", "40-2": "#", "39-2": "#", "38-2": "#", "37-2": "#", "36-2": "#", "35-2": "#", "34-2": "#", "33-2": "#", "32-2": "#", "31-2": "#", "30-2": "#", "40-3": "#", "39-3": "Sim", "38-3": "Sim", "37-3": "Sim", "36-3": "Sim", "35-3": "#", "34-3": "#", "33-3": "#", "32-3": "#", "31-3": "#", "30-3": "#", "29-2": "Oriente o portador a entrar em contato com o banco emissor do cartão", "28-2": "Oriente o portador a entrar em contato com o banco emissor do cartão", "29-3": "#", "28-3": "#", "27-3": "#", "26-3": "#", "25-3": "#", "24-3": "Sim", "27-2": "# ", "26-2": "#", "25-2": "#", "24-2": "#", "23-3": "#", "22-3": "#", "16-3": "#", "17-3": "#", "18-3": "#", "19-3": "#", "20-3": "#", "21-3": "#", "21-2": "#", "19-2": "#", "17-2": "#", "16-2": "#", "18-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "20-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "22-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "23-2": "O tipo de conta selecionado não existe. Ex: uma transação de crédito com um cartão de débito.", "15-2": "#", "14-2": "#", "14-3": "Sim", "15-3": "Sim", "13-2": "O tipo de conta selecionado não existe. Ex: uma transação de crédito com um cartão de débito.", "13-3": "#", "12-2": "#", "11-2": "#", "10-2": "#", "9-2": "#", "12-3": "#", "11-3": "#", "10-3": "#", "9-3": "#", "8-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "7-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "8-3": "#", "7-3": "#", "3-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "4-2": "Oriente o portador a entrar em contato com o banco emissor do cartão.", "0-2": "#", "1-2": "#", "2-2": "#", "5-2": "#", "6-2": "#", "6-3": "#", "5-3": "#", "4-3": "#", "3-3": "#", "2-3": "#", "1-3": "#", "0-3": "#" }, "cols": 4, "rows": 41 } [/block]
{"__v":0,"_id":"585448639bd59b2300f03a32","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"body":"**Container**\n\nÉ uma tag que possui tags \"filhas\", ou seja, cujos elementos são uma ou mais tags \n\nExemplo: Suponha que temos a tag Cliente que é um Container e possui como elementos as tags NomeDaLoja, MCC e SAK então a representação dessa tag XML seria : \n\n<Cliente>\n  <NomeDaLoja></NomeDaLoja>\n  <MCC>999</MCC>\n  <SAK>xxxxxxxxxxxxxxxxxxx</SAK>\n</Cliente>\n\n**CodeSet**\n\nSão tags cujos valores são Enums, ou seja, cujos elementos são represantações em letras de números.\n\nExemplo : Ao criar um uma tag do tipo CodeSet chamada Aviso seus podemos criar alias ( apelidos ) para os números de 1 ,2 ,3 e chamá-los de OK , ERRO e ADVERTÊNCIA, respectivamente de maneira a facilitar a distinção deles dos números 1, 2 e 3 apenas.\n\nA representação dessa tag XML ocorreria da seguinte forma : \n\n<Aviso>OK<./Aviso>\n\n**Text**\n\nSão tags cujos valores são strings alfanuméricas. \n\nExemplo :\n\nSuponha que exista um tag chamada Nome, logo sua representação será : \n\n<Nome>Fulano<Nome>\n\n**DateTime**\n\nSão tags que representam a data e hora. \n\nExemplo : \n\nSuponha que exita uma tag chamada DataEHoraAtual, sua representação será:\n\n<DataEHoraAtual>2014-03-12T15:09:00</DataEHoraAtual>\n\n**Amount**\n\nSão tags cujos valores são números decimais podendo ou não conter virgula, geralmente utilizados para identifcar valores de transações.\n\nExemplo:\n\nSuponha que tenhamos uma tag com o nome <ValorTotalTransacao> que indica o valor total da venda, caso o valor total da venda fosse R$ 500,00 sua representação seria : \n\n<ValorTotalTransacao>500.00</ValorTotalTransacao>\n\n**Quantity**\n\nSão tags cujos valores são números inteiros ( sem vírgula ) utilizados para contagem.\n\nExemplo : \n\nSuponha que tenhamos um tag com o nome <NumeroParcelas> que indica o número de parcelas de uma transação de crédito. No caso de uma transação de crédito em 3 vezes a representação da tag seria : \n\n<NumeroParcelas>3<NumeroParcelas>","category":"584eb07a1318690f009c7a9c","createdAt":"2016-12-16T20:02:43.325Z","excerpt":"","githubsync":"","hidden":false,"isReference":true,"link_external":false,"link_url":"","next":{"pages":[],"description":""},"order":999,"project":"583f0fb04828d50f00126d4d","slug":"tipo-das-tags-xml","sync_unique":"","title":"Tipo das TAGs XML","type":"basic","updates":[],"user":"57ea79f61780cd170064f273","version":"583f0fb04828d50f00126d50","childrenPages":[]}

Tipo das TAGs XML


**Container** É uma tag que possui tags "filhas", ou seja, cujos elementos são uma ou mais tags Exemplo: Suponha que temos a tag Cliente que é um Container e possui como elementos as tags NomeDaLoja, MCC e SAK então a representação dessa tag XML seria : <Cliente> <NomeDaLoja></NomeDaLoja> <MCC>999</MCC> <SAK>xxxxxxxxxxxxxxxxxxx</SAK> </Cliente> **CodeSet** São tags cujos valores são Enums, ou seja, cujos elementos são represantações em letras de números. Exemplo : Ao criar um uma tag do tipo CodeSet chamada Aviso seus podemos criar alias ( apelidos ) para os números de 1 ,2 ,3 e chamá-los de OK , ERRO e ADVERTÊNCIA, respectivamente de maneira a facilitar a distinção deles dos números 1, 2 e 3 apenas. A representação dessa tag XML ocorreria da seguinte forma : <Aviso>OK<./Aviso> **Text** São tags cujos valores são strings alfanuméricas. Exemplo : Suponha que exista um tag chamada Nome, logo sua representação será : <Nome>Fulano<Nome> **DateTime** São tags que representam a data e hora. Exemplo : Suponha que exita uma tag chamada DataEHoraAtual, sua representação será: <DataEHoraAtual>2014-03-12T15:09:00</DataEHoraAtual> **Amount** São tags cujos valores são números decimais podendo ou não conter virgula, geralmente utilizados para identifcar valores de transações. Exemplo: Suponha que tenhamos uma tag com o nome <ValorTotalTransacao> que indica o valor total da venda, caso o valor total da venda fosse R$ 500,00 sua representação seria : <ValorTotalTransacao>500.00</ValorTotalTransacao> **Quantity** São tags cujos valores são números inteiros ( sem vírgula ) utilizados para contagem. Exemplo : Suponha que tenhamos um tag com o nome <NumeroParcelas> que indica o número de parcelas de uma transação de crédito. No caso de uma transação de crédito em 3 vezes a representação da tag seria : <NumeroParcelas>3<NumeroParcelas>
**Container** É uma tag que possui tags "filhas", ou seja, cujos elementos são uma ou mais tags Exemplo: Suponha que temos a tag Cliente que é um Container e possui como elementos as tags NomeDaLoja, MCC e SAK então a representação dessa tag XML seria : <Cliente> <NomeDaLoja></NomeDaLoja> <MCC>999</MCC> <SAK>xxxxxxxxxxxxxxxxxxx</SAK> </Cliente> **CodeSet** São tags cujos valores são Enums, ou seja, cujos elementos são represantações em letras de números. Exemplo : Ao criar um uma tag do tipo CodeSet chamada Aviso seus podemos criar alias ( apelidos ) para os números de 1 ,2 ,3 e chamá-los de OK , ERRO e ADVERTÊNCIA, respectivamente de maneira a facilitar a distinção deles dos números 1, 2 e 3 apenas. A representação dessa tag XML ocorreria da seguinte forma : <Aviso>OK<./Aviso> **Text** São tags cujos valores são strings alfanuméricas. Exemplo : Suponha que exista um tag chamada Nome, logo sua representação será : <Nome>Fulano<Nome> **DateTime** São tags que representam a data e hora. Exemplo : Suponha que exita uma tag chamada DataEHoraAtual, sua representação será: <DataEHoraAtual>2014-03-12T15:09:00</DataEHoraAtual> **Amount** São tags cujos valores são números decimais podendo ou não conter virgula, geralmente utilizados para identifcar valores de transações. Exemplo: Suponha que tenhamos uma tag com o nome <ValorTotalTransacao> que indica o valor total da venda, caso o valor total da venda fosse R$ 500,00 sua representação seria : <ValorTotalTransacao>500.00</ValorTotalTransacao> **Quantity** São tags cujos valores são números inteiros ( sem vírgula ) utilizados para contagem. Exemplo : Suponha que tenhamos um tag com o nome <NumeroParcelas> que indica o número de parcelas de uma transação de crédito. No caso de uma transação de crédito em 3 vezes a representação da tag seria : <NumeroParcelas>3<NumeroParcelas>