{"_id":"591445abbb92601b00a4facc","parentDoc":null,"slug":"bem-vindo-à-stone-online","title":"Bem vindo à Stone Online","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, 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\n Adquirente é a empresa que habilita o estabelecimento comercial a realizar vendas por meio de cartão. No momento da compra pelo portador (cliente-final), a adquirente é quem captura todos os dados daquela transação e envia para o emissor (banco). Com isso, o banco retorna para a adquirente com uma resposta positiva (transação aprovada) ou negativa (transação negada). \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.","updates":["5981e66ff1e801002c8f6966"],"next":{"pages":[],"description":""},"sync_unique":"","isReference":false,"type":"basic","category":"591445abbb92601b00a4fac9","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","link_url":"","githubsync":"","hidden":false,"order":0,"excerpt":"","user":"57ea79f61780cd170064f273","createdAt":"2016-12-05T16:27:19.513Z","link_external":false,"__v":1,"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, 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 que habilita o estabelecimento comercial a realizar vendas por meio de cartão. No momento da compra pelo portador (cliente-final), a adquirente é quem captura todos os dados daquela transação e envia para o emissor (banco). Com isso, o banco retorna para a adquirente com uma resposta positiva (transação aprovada) ou negativa (transação negada). 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, 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 que habilita o estabelecimento comercial a realizar vendas por meio de cartão. No momento da compra pelo portador (cliente-final), a adquirente é quem captura todos os dados daquela transação e envia para o emissor (banco). Com isso, o banco retorna para a adquirente com uma resposta positiva (transação aprovada) ou negativa (transação negada). 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.
{"_id":"59d4ec11ee39f3003c3cf460","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4fac9","user":"58dcf4b604ea0f0f00fbdfcb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-10-04T14:11:29.613Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"Este documento define a transação que ocorre entre a solução E-commerce e o adquirente. É detalhada tanto a mensageiria quanto a especificação funcional das transações e funcionalidades existente no Commerce.","excerpt":"","slug":"escopo","type":"basic","title":"Escopo","__v":0,"parentDoc":null,"childrenPages":[]}

Escopo


Este documento define a transação que ocorre entre a solução E-commerce e o adquirente. É detalhada tanto a mensageiria quanto a especificação funcional das transações e funcionalidades existente no Commerce.
Este documento define a transação que ocorre entre a solução E-commerce e o adquirente. É detalhada tanto a mensageiria quanto a especificação funcional das transações e funcionalidades existente no Commerce.
{"_id":"5943f76f363d07002d6ba019","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4fac9","user":"58dcf4b604ea0f0f00fbdfcb","updates":["598336797b3f5f0020d3032b"],"next":{"pages":[],"description":""},"createdAt":"2017-06-16T15:21:19.769Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"O Stone Online é indicado para empresas que já tem na sua sua estrutura serviços como anti-fraude, tokenização, multi meios de pagamento, recorrência, etc.\n\nPara parceiros que ainda não tem e desejam esses serviços, a API mais aconselhável é a e-Stone.","excerpt":"","slug":"para-quem-é-indicado","type":"basic","title":"Para quem é indicado?","__v":1,"parentDoc":null,"childrenPages":[]}

Para quem é indicado?


O Stone Online é indicado para empresas que já tem na sua sua estrutura serviços como anti-fraude, tokenização, multi meios de pagamento, recorrência, etc. Para parceiros que ainda não tem e desejam esses serviços, a API mais aconselhável é a e-Stone.
O Stone Online é indicado para empresas que já tem na sua sua estrutura serviços como anti-fraude, tokenização, multi meios de pagamento, recorrência, etc. Para parceiros que ainda não tem e desejam esses serviços, a API mais aconselhável é a e-Stone.
{"_id":"59d4ed60ee39f3003c3cf47a","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4fac9","user":"58dcf4b604ea0f0f00fbdfcb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-10-04T14:17:04.026Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"A solução eCommerce é um sistema que permite que o portador do cartão realize transações financeiras dentro de uma plataforma eletrônica de vendas. Este tipo de solução é geralmente utilizado em clientes que necessitam integrar as transações financeiras com sua plataforma digital de vendas.","excerpt":"","slug":"solução-ecommerce","type":"basic","title":"Solução eCommerce","__v":0,"parentDoc":null,"childrenPages":[]}

Solução eCommerce


A solução eCommerce é um sistema que permite que o portador do cartão realize transações financeiras dentro de uma plataforma eletrônica de vendas. Este tipo de solução é geralmente utilizado em clientes que necessitam integrar as transações financeiras com sua plataforma digital de vendas.
A solução eCommerce é um sistema que permite que o portador do cartão realize transações financeiras dentro de uma plataforma eletrônica de vendas. Este tipo de solução é geralmente utilizado em clientes que necessitam integrar as transações financeiras com sua plataforma digital de vendas.
{"_id":"591445abbb92601b00a4facd","hidden":false,"excerpt":"","type":"basic","parentDoc":null,"project":"583f0fb04828d50f00126d4d","link_url":"","sync_unique":"","body":"O fluxo de Comunicação é iniciado logo que o portador (cliente-final) decide finalizar a sua compra, insere os dados solicitados e de autenticação para conclusão da mesma e segue para finalização do pagamento. Nesse momento é solicitado o processamento do pagamento, a partir da integração existente entre o e-commerce e a adquirente. A adquirente segue para a fase de consulta daquela transação com o banco e retorna com uma mensagem autorizando ou negando aquela compra. \n\nA integração com a Stone ocorrerá através do uso (consumo) de um webservice REST através de requisições HTTP.\n\nO protocolo de comunicação utilizado para se conectar a Stone é o Https. O HTTPS verb a ser utilizado será sempre POST.\nPara o ambiente de transações (Autorização/Cancelamento/Diagnóstico), as mensagens são baseadas na versão 2.0 do protocolo EPAS/ISO 20022 CAPE (Card Payment Exchanges).\n\n**Importante:**\nOs dados para conexão ao sandbox da Stone, para realização de testes, devem ser solicitados ao time de integrações da Stone (integracoes@stone.com.br).\nO protocolo de comunicação para requisições HTTPs ao Host da Stone, será o TLS v1.2, de acordo com o PCI DSS 3.1.\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]","title":"Fluxo de Comunicação","__v":0,"next":{"description":"","pages":[]},"createdAt":"2016-12-05T16:28:46.226Z","link_external":false,"order":4,"githubsync":"","isReference":false,"user":"57ea79f61780cd170064f273","version":"591445aabb92601b00a4fac8","updates":[],"category":"591445abbb92601b00a4fac9","api":{"results":{"codes":[{"status":200,"name":"","code":"{}","language":"json"},{"code":"{}","language":"json","status":400,"name":""}]},"settings":"","auth":"required","params":[],"url":""},"slug":"fluxo-de-comunicação","childrenPages":[]}

Fluxo de Comunicação


O fluxo de Comunicação é iniciado logo que o portador (cliente-final) decide finalizar a sua compra, insere os dados solicitados e de autenticação para conclusão da mesma e segue para finalização do pagamento. Nesse momento é solicitado o processamento do pagamento, a partir da integração existente entre o e-commerce e a adquirente. A adquirente segue para a fase de consulta daquela transação com o banco e retorna com uma mensagem autorizando ou negando aquela compra. A integração com a Stone ocorrerá através do uso (consumo) de um webservice REST através de requisições HTTP. O protocolo de comunicação utilizado para se conectar a Stone é o Https. O HTTPS verb a ser utilizado será sempre POST. Para o ambiente de transações (Autorização/Cancelamento/Diagnóstico), as mensagens são baseadas na versão 2.0 do protocolo EPAS/ISO 20022 CAPE (Card Payment Exchanges). **Importante:** Os dados para conexão ao sandbox da Stone, para realização de testes, devem ser solicitados ao time de integrações da Stone (integracoes@stone.com.br). O protocolo de comunicação para requisições HTTPs ao Host da Stone, será o TLS v1.2, de acordo com o PCI DSS 3.1. [block:image] { "images": [ { "image": [ "https://files.readme.io/5223cc6-fluxo.png", "fluxo.png", 903, 1343, "#9a9a9a" ], "sizing": "full", "border": true } ] } [/block]
O fluxo de Comunicação é iniciado logo que o portador (cliente-final) decide finalizar a sua compra, insere os dados solicitados e de autenticação para conclusão da mesma e segue para finalização do pagamento. Nesse momento é solicitado o processamento do pagamento, a partir da integração existente entre o e-commerce e a adquirente. A adquirente segue para a fase de consulta daquela transação com o banco e retorna com uma mensagem autorizando ou negando aquela compra. A integração com a Stone ocorrerá através do uso (consumo) de um webservice REST através de requisições HTTP. O protocolo de comunicação utilizado para se conectar a Stone é o Https. O HTTPS verb a ser utilizado será sempre POST. Para o ambiente de transações (Autorização/Cancelamento/Diagnóstico), as mensagens são baseadas na versão 2.0 do protocolo EPAS/ISO 20022 CAPE (Card Payment Exchanges). **Importante:** Os dados para conexão ao sandbox da Stone, para realização de testes, devem ser solicitados ao time de integrações da Stone (integracoes@stone.com.br). O protocolo de comunicação para requisições HTTPs ao Host da Stone, será o TLS v1.2, de acordo com o PCI DSS 3.1. [block:image] { "images": [ { "image": [ "https://files.readme.io/5223cc6-fluxo.png", "fluxo.png", 903, 1343, "#9a9a9a" ], "sizing": "full", "border": true } ] } [/block]
{"_id":"59d4f0550efc0c00102b202c","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4fac9","user":"58dcf4b604ea0f0f00fbdfcb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-10-04T14:29:41.907Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"O protocolo de comunicação utilizado para se conectar a Stone é o HTTPS. O http verb a ser utilizado será sempre Post.\nPara o ambiente de transações (Autorização/Cancelamento/Diagnóstico), as mensagens são baseadas na versão 2.0 do protocolo EPAS/ISO 20022 CAPE (Card Payment Exchanges).","excerpt":"","slug":"segurança","type":"basic","title":"Segurança","__v":0,"parentDoc":null,"childrenPages":[]}

Segurança


O protocolo de comunicação utilizado para se conectar a Stone é o HTTPS. O http verb a ser utilizado será sempre Post. Para o ambiente de transações (Autorização/Cancelamento/Diagnóstico), as mensagens são baseadas na versão 2.0 do protocolo EPAS/ISO 20022 CAPE (Card Payment Exchanges).
O protocolo de comunicação utilizado para se conectar a Stone é o HTTPS. O http verb a ser utilizado será sempre Post. Para o ambiente de transações (Autorização/Cancelamento/Diagnóstico), as mensagens são baseadas na versão 2.0 do protocolo EPAS/ISO 20022 CAPE (Card Payment Exchanges).
{"_id":"591445abbb92601b00a4face","next":{"pages":[],"description":""},"createdAt":"2016-12-05T16:28:57.700Z","link_external":false,"body":"[block:api-header]\n{\n  \"title\": \"Sandbox\"\n}\n[/block]\nPara obter sua chave para integração em nosso ambiente Sandbox, 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\nLhe encaminharemos duas chaves vinculadas ao produto Stone Online:\n\n**SAK (SaleAffiliationKey)**\n**StoneCode**\n\nLembrando que o StoneCode também deve ser de conhecimento do desenvolvedor/estabelecimento.\n\n[block:api-header]\n{\n  \"title\": \"Produção\"\n}\n[/block]\nUma vez que a etapa de homologação for concluída você precisará de uma credencial de **PRODUÇÃO** .\n\nPara solicitar, 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":"591445abbb92601b00a4fac9","version":"591445aabb92601b00a4fac8","updates":[],"type":"basic","__v":0,"excerpt":"Neste item, esclarecemos dúvidas relacionadas aos dados de permissão necessários e como geramos os dados de acesso.","parentDoc":null,"project":"583f0fb04828d50f00126d4d","sync_unique":"","hidden":false,"api":{"params":[],"url":"","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","auth":"required"},"order":6,"title":"Credenciais de Acesso","slug":"credenciais-de-acesso","user":"57ea79f61780cd170064f273","link_url":"","githubsync":"","isReference":false,"childrenPages":[]}

Credenciais de Acesso

Neste item, esclarecemos dúvidas relacionadas aos dados de permissão necessários e como geramos os dados de acesso.

[block:api-header] { "title": "Sandbox" } [/block] Para obter sua chave para integração em nosso ambiente Sandbox, 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** Lhe encaminharemos duas chaves vinculadas ao produto Stone Online: **SAK (SaleAffiliationKey)** **StoneCode** Lembrando que o StoneCode também deve ser de conhecimento do desenvolvedor/estabelecimento. [block:api-header] { "title": "Produção" } [/block] Uma vez que a etapa de homologação for concluída você precisará de uma credencial de **PRODUÇÃO** . Para solicitar, encaminhe um e-mail para o nosso time comercial [ecommerce@stone.com.br](mailto:ecommerce@stone.com.br) lhe auxiliar no processo de credenciamento.
[block:api-header] { "title": "Sandbox" } [/block] Para obter sua chave para integração em nosso ambiente Sandbox, 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** Lhe encaminharemos duas chaves vinculadas ao produto Stone Online: **SAK (SaleAffiliationKey)** **StoneCode** Lembrando que o StoneCode também deve ser de conhecimento do desenvolvedor/estabelecimento. [block:api-header] { "title": "Produção" } [/block] Uma vez que a etapa de homologação for concluída você precisará de uma credencial de **PRODUÇÃO** . Para solicitar, encaminhe um e-mail para o nosso time comercial [ecommerce@stone.com.br](mailto:ecommerce@stone.com.br) lhe auxiliar no processo de credenciamento.
{"_id":"59dbb2a1c92dcd001c440fd2","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4fac9","user":"58dcf4b604ea0f0f00fbdfcb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-10-09T17:32:17.420Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"O cancelamento é feito, a pedido do portador do cartão, na loja em que a compra foi realizada.\nA solicitação de cancelamento poderá ser solicitada a qualquer momento, mesmo que em dia diferente ao que ocorreu a transação.\nO período permitido para a realização de um cancelamento depende do EMISSOR.\nCancelamentos podem ser feitos do valor total da transação ou do valor parcial e pode ser realizado apenas no estabelecimento onde foi realizada a transação original, pois se considera que o SAK será utilizado para localizar a transação na log ou no host da Stone. Tanto no cancelamento parcial quanto no total é permitido apenas uma vez, ou seja, uma vez aprovada a solicitação de cancelamento o TEF não deve permitir uma nova tentativa.\nAs seguintes transações podem ser canceladas:\n• Crédito (online e off-line)\no À vista, parcelado com juros e parcelado sem juros.\n• Débito\n• Voucher\n\nOs dados originais que podem ser pedidos para serem digitados na solução de captura/canal:\n• Stone ID;\n• Data da transação;\n• Valor a ser cancelado;\nNão há relação entre o modo de entrada da transação original e do cancelamento. Por exemplo: se a transação for realizada com chip, o cancelamento pode ser feito com chip, tarja magnética ou digitado.\nQuando o cancelamento é feito via chip, o processamento","excerpt":"","slug":"cancellamento-de-transação-estorno-e-reembolso","type":"basic","title":"Cancelamento de Transação (Estorno e Reembolso)","__v":0,"parentDoc":null,"childrenPages":[]}

Cancelamento de Transação (Estorno e Reembolso)


O cancelamento é feito, a pedido do portador do cartão, na loja em que a compra foi realizada. A solicitação de cancelamento poderá ser solicitada a qualquer momento, mesmo que em dia diferente ao que ocorreu a transação. O período permitido para a realização de um cancelamento depende do EMISSOR. Cancelamentos podem ser feitos do valor total da transação ou do valor parcial e pode ser realizado apenas no estabelecimento onde foi realizada a transação original, pois se considera que o SAK será utilizado para localizar a transação na log ou no host da Stone. Tanto no cancelamento parcial quanto no total é permitido apenas uma vez, ou seja, uma vez aprovada a solicitação de cancelamento o TEF não deve permitir uma nova tentativa. As seguintes transações podem ser canceladas: • Crédito (online e off-line) o À vista, parcelado com juros e parcelado sem juros. • Débito • Voucher Os dados originais que podem ser pedidos para serem digitados na solução de captura/canal: • Stone ID; • Data da transação; • Valor a ser cancelado; Não há relação entre o modo de entrada da transação original e do cancelamento. Por exemplo: se a transação for realizada com chip, o cancelamento pode ser feito com chip, tarja magnética ou digitado. Quando o cancelamento é feito via chip, o processamento
O cancelamento é feito, a pedido do portador do cartão, na loja em que a compra foi realizada. A solicitação de cancelamento poderá ser solicitada a qualquer momento, mesmo que em dia diferente ao que ocorreu a transação. O período permitido para a realização de um cancelamento depende do EMISSOR. Cancelamentos podem ser feitos do valor total da transação ou do valor parcial e pode ser realizado apenas no estabelecimento onde foi realizada a transação original, pois se considera que o SAK será utilizado para localizar a transação na log ou no host da Stone. Tanto no cancelamento parcial quanto no total é permitido apenas uma vez, ou seja, uma vez aprovada a solicitação de cancelamento o TEF não deve permitir uma nova tentativa. As seguintes transações podem ser canceladas: • Crédito (online e off-line) o À vista, parcelado com juros e parcelado sem juros. • Débito • Voucher Os dados originais que podem ser pedidos para serem digitados na solução de captura/canal: • Stone ID; • Data da transação; • Valor a ser cancelado; Não há relação entre o modo de entrada da transação original e do cancelamento. Por exemplo: se a transação for realizada com chip, o cancelamento pode ser feito com chip, tarja magnética ou digitado. Quando o cancelamento é feito via chip, o processamento
{"_id":"591445abbb92601b00a4facf","excerpt":"","type":"basic","title":"Requisições e funcionalidades","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","next":{"pages":[],"description":""},"githubsync":"","sync_unique":"","order":8,"slug":"requisições-e-funcionalidades","user":"57ea79f61780cd170064f273","__v":0,"updates":[],"createdAt":"2016-12-05T16:29:57.725Z","link_url":"","hidden":false,"parentDoc":null,"link_external":false,"api":{"results":{"codes":[{"status":200,"name":"","code":"{}","language":"json"},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"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 sandbox [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     * **Recorrência**\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":"591445abbb92601b00a4fac9","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 sandbox [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**) * **Recorrência** * 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 sandbox [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**) * **Recorrência** * 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]
{"_id":"59d4f204f9c4c10010adbb3f","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4fac9","user":"58dcf4b604ea0f0f00fbdfcb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-10-04T14:36:52.976Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":9,"body":"| Transação | Modalidades | Formas de Pagamento |\n| ----------------- | --------- | ------------------- |\n| Crédito | Captura Automática | À Vista / Parcelado emissor / Parcelado logista |\n| Crédito | Captura Posterior | À Vista / Parcelado emissor / Parcelado logista | \n| Crédito | Recorrência |  Parcelas / Transações |\n\n\nA seguir, estão as possíveis modalidades de pagamento com breve descrição:\n\n- Crédito à Vista com captura imediata: Consiste no pagamento do valor total da compra com captura imediata.\n\n- Crédito à Vista com captura posterior: Consiste no pagamento do valor total da compra com captura posterior.\n\n- Crédito Parcelado com captura imediata: Consiste no pagamento do valor parcelado da compra com captura imediata.\n\n- Crédito Parcelado com captura posterior: Consiste no pagamento do valor parcelado da compra com captura posterior.","excerpt":"","slug":"descrição-das-possíveis-transações-financeiras","type":"basic","title":"Descrição das possíveis Transações Financeiras","__v":0,"parentDoc":null,"childrenPages":[]}

Descrição das possíveis Transações Financeiras


| Transação | Modalidades | Formas de Pagamento | | ----------------- | --------- | ------------------- | | Crédito | Captura Automática | À Vista / Parcelado emissor / Parcelado logista | | Crédito | Captura Posterior | À Vista / Parcelado emissor / Parcelado logista | | Crédito | Recorrência | Parcelas / Transações | A seguir, estão as possíveis modalidades de pagamento com breve descrição: - Crédito à Vista com captura imediata: Consiste no pagamento do valor total da compra com captura imediata. - Crédito à Vista com captura posterior: Consiste no pagamento do valor total da compra com captura posterior. - Crédito Parcelado com captura imediata: Consiste no pagamento do valor parcelado da compra com captura imediata. - Crédito Parcelado com captura posterior: Consiste no pagamento do valor parcelado da compra com captura posterior.
| Transação | Modalidades | Formas de Pagamento | | ----------------- | --------- | ------------------- | | Crédito | Captura Automática | À Vista / Parcelado emissor / Parcelado logista | | Crédito | Captura Posterior | À Vista / Parcelado emissor / Parcelado logista | | Crédito | Recorrência | Parcelas / Transações | A seguir, estão as possíveis modalidades de pagamento com breve descrição: - Crédito à Vista com captura imediata: Consiste no pagamento do valor total da compra com captura imediata. - Crédito à Vista com captura posterior: Consiste no pagamento do valor total da compra com captura posterior. - Crédito Parcelado com captura imediata: Consiste no pagamento do valor parcelado da compra com captura imediata. - Crédito Parcelado com captura posterior: Consiste no pagamento do valor parcelado da compra com captura posterior.
{"_id":"591445abbb92601b00a4fad0","link_url":"","parentDoc":null,"sync_unique":"","__v":0,"createdAt":"2016-12-05T16:30:10.779Z","order":10,"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>EF1CC1A4FECE40EB8B29CA7328955C77</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 de PSP. -->\n                <LctnAndCtct>\n                    <PstlAdr>\n                        <PstCd></PstCd> <!--CEP-->\n                        <TwnNm></TwnNm> <!--CIDADE-->\n                        <CtrySubDvsn></CtrySubDvsn> <!--ESTADO-->\n                        <Ctry></Ctry> <!--PAIS-->                                 \n                    </PstlAdr>\n                </LctnAndCtct>   \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                <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n                <AddtlSvc>RECP</AddtlSvc>\n                <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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"}]},"method":"post","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>EF1CC1A4FECE40EB8B29CA7328955C77</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"},"hidden":false,"link_external":false,"slug":"mensagens-de-autorização","type":"post","category":"591445abbb92601b00a4fac9","next":{"pages":[],"description":""},"project":"583f0fb04828d50f00126d4d","isReference":false,"title":"Mensagens de Autorização","updates":[],"user":"57ea79f61780cd170064f273","version":"591445aabb92601b00a4fac8","body":"[block:api-header]\n{\n  \"title\": \"Authorize\"\n}\n[/block]\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    \"13-1\": \"0 à 1\",\n    \"20-1\": \"1\",\n    \"21-1\": \"1\",\n    \"22-1\": \"1\",\n    \"23-1\": \"1\",\n    \"24-1\": \"0 à 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\": \"0 à 1\",\n    \"33-1\": \"1\",\n    \"36-1\": \"0 à 1\",\n    \"38-1\": \"1\",\n    \"39-1\": \"1\",\n    \"40-1\": \"1\",\n    \"41-1\": \"1\",\n    \"42-1\": \"1\",\n    \"43-1\": \"1\",\n    \"44-1\": \"1\",\n    \"45-1\": \"0 à 1\",\n    \"46-1\": \"0 à 1\",\n    \"47-1\": \"1\",\n    \"48-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    \"13-0\": \"ShortName<ShrtNm>\",\n    \"20-0\": \"Poi<POI>\",\n    \"21-0\": \"Identification<ID>\",\n    \"22-0\": \"Identification<ID>\",\n    \"23-0\": \"Card<Card>\",\n    \"24-0\": \"PlainCardData<PlainCardData>\",\n    \"25-0\": \"PAN<PAN>\",\n    \"26-0\": \"ExpiryDate<XpryDt>\",\n    \"27-0\": \"CardSctyCd<CardSctyCd>\",\n    \"28-0\": \"CSCVal<CSCVal>\",\n    \"29-0\": \"Context<Cntxt>\",\n    \"30-0\": \"PaymentContext<PmtCntxt>\",\n    \"31-0\": \"CardDataEntryMode<CardDataNtryMd>\",\n    \"32-0\": \"TransactionChannel<TxChanl>\",\n    \"33-0\": \"Transaction<Tx>\",\n    \"36-0\": \"InitiatorTransactionIdentification<InitrTxId>\",\n    \"38-0\": \"TransactionCapture<TxCaptr>\",\n    \"39-0\": \"TransactionIdentification<TxId>\",\n    \"40-0\": \"TransactionDateTime<TxDtTm>\",\n    \"41-0\": \"TransactionReference<TxRef>\",\n    \"42-0\": \"TransactionDetails<TxDtls>\",\n    \"43-0\": \"Currency<Ccy>\",\n    \"44-0\": \"TotalAmount<TtlAmt>\",\n    \"45-0\": \"AccountType<AcctTp>\",\n    \"46-0\": \"RecurringTransaction<RcrngTx>\",\n    \"47-0\": \"InstalmentType<InstlmtTp>\",\n    \"48-0\": \"TotalNumberOfPayments <TtlNbOfPmts>\",\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    \"13-2\": \"Text\",\n    \"20-2\": \"Container\",\n    \"21-2\": \"Container\",\n    \"22-2\": \"Text\",\n    \"23-2\": \"Container\",\n    \"24-2\": \"Container\",\n    \"25-2\": \"Text\",\n    \"26-2\": \"Text\",\n    \"27-2\": \"Container\",\n    \"28-2\": \"Text\",\n    \"29-2\": \"Container\",\n    \"30-2\": \"Container\",\n    \"31-2\": \"CodeSet\",\n    \"32-2\": \"CodeSet\",\n    \"33-2\": \"Container\",\n    \"36-2\": \"Text\",\n    \"38-2\": \"Boolean\",\n    \"39-2\": \"Container\",\n    \"40-2\": \"DateTime\",\n    \"41-2\": \"Text\",\n    \"42-2\": \"Container\",\n    \"43-2\": \"CodeSet\",\n    \"44-2\": \"Amount\",\n    \"45-2\": \"CodeSet\",\n    \"46-2\": \"Container\",\n    \"47-2\": \"CodeSet\",\n    \"48-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    \"13-4\": \"Não\",\n    \"20-4\": \"Sim\",\n    \"21-4\": \"Sim\",\n    \"22-4\": \"Sim\",\n    \"23-4\": \"Sim\",\n    \"24-4\": \"Não\",\n    \"25-4\": \"Sim\",\n    \"26-4\": \"Sim\",\n    \"27-4\": \"Sim\",\n    \"28-4\": \"Sim\",\n    \"29-4\": \"Sim\",\n    \"30-4\": \"Sim\",\n    \"31-4\": \"Sim\",\n    \"32-4\": \"Sim\",\n    \"33-4\": \"Sim\",\n    \"36-4\": \"Não\",\n    \"38-4\": \"Sim\",\n    \"39-4\": \"Sim\",\n    \"40-4\": \"Sim\",\n    \"41-4\": \"Sim\",\n    \"42-4\": \"Sim\",\n    \"43-4\": \"Sim\",\n    \"44-4\": \"Sim\",\n    \"45-4\": \"Não\",\n    \"46-4\": \"Não\",\n    \"47-4\": \"Sim\",\n    \"48-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    \"13-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    \"20-3\": \"Dados do ponto de interação\",\n    \"21-3\": \"Identificação do ponto de interação\",\n    \"22-3\": \"Código de identificação do ponto de interação atribuído pelo estabelecimento.\",\n    \"23-3\": \"Dados do cartão utilizado na transação.\",\n    \"24-3\": \"Dados não criptografados do cartão utilizado na transação.\",\n    \"25-3\": \"Número do cartão. (Primary Account Number)\",\n    \"26-3\": \"Data de validade do cartão no formato “yyyy-MM”.\",\n    \"27-3\": \"Código de segurança do cartão\",\n    \"28-3\": \"CVV estampado no verso do cartão\",\n    \"29-3\": \"Informações da transação a ser realizada.\",\n    \"30-3\": \"Informações sobre o pagamento.\",\n    \"31-3\": \"Modo da entrada dos dados do cartão: PHYS = Ecommerce ou Digitada;\",\n    \"32-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    \"33-3\": \"Informações da transação.\",\n    \"36-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    \"38-3\": \"Indica se os dados da transação devem ser capturados - true - ou não false - imediatamente.\",\n    \"39-3\": \"Dados de identificação da transação atribuída pelo POI (Ponto de interação).\",\n    \"40-3\": \"Data local e hora da transação atribuídas pelo POI (ponto de interação).\",\n    \"41-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    \"42-3\": \"Detalhes da transação.\",\n    \"43-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.\",\n    \"44-3\": \"Valor total da transação em centavos.\",\n    \"45-3\": \"Modalidade do cartão utilizado na transação. \\n**Fixo**: **CRDT **= Crédito.\",\n    \"46-3\": \"Os dados relativos à(s) parcela(s) ou a uma transação recorrente.\",\n    \"47-3\": \"Tipo de parcelamento. \\nNONE = A vista\\nMCHT = Lojista\\nISSR = Emissor (Com Juros)\",\n    \"48-3\": \"Número do total de parcelas.\\nPara transação a vista deve ser enviado o valor “0\\\".\",\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    \"34-0\": \"AdditionalService<AddtlSvc>\",\n    \"34-1\": \"0 à 1\",\n    \"34-2\": \"CodeSet\",\n    \"35-0\": \"ServiceAttribute\",\n    \"35-1\": \"0 à 1\",\n    \"35-2\": \"CodeSet\",\n    \"34-4\": \"Não (apenas para **recorrência**)\",\n    \"35-4\": \"Não (apenas para **recorrência**)\",\n    \"34-3\": \"Informações da transação de recorrência.\\n\\nValor \\\"FIXO\\\" = RECP (*Recurring Payment*)\",\n    \"35-3\": \"Informações da transação de recorrência.\\n\\nValores:\\nFREC (*First Recurring*) para  a **PRIMEIRA TRANSAÇÃO** \\n\\nRREC (*Following Recurring*) para  as **TRANSAÇÕES POSTERIORES**\",\n    \"14-0\": \"LocationAndContact <LctnAndCtct>\",\n    \"14-1\": \"0 à 1\",\n    \"14-2\": \"Container\",\n    \"14-3\": \"Dados de PSP\",\n    \"14-4\": \"Não\",\n    \"15-0\": \"PostalAddress <PstlAdr>\",\n    \"15-1\": \"0 à 1\",\n    \"15-2\": \"Container\",\n    \"15-3\": \"Dados de PSP\",\n    \"15-4\": \"Não\",\n    \"16-0\": \"PostCode <PstCd>\",\n    \"16-1\": \"0 à 1\",\n    \"16-2\": \"Text\",\n    \"16-3\": \"CEP do submerchant\",\n    \"16-4\": \"Não\",\n    \"17-0\": \"<TwnNm>\",\n    \"17-1\": \"0 à 1\",\n    \"17-2\": \"Text\",\n    \"17-3\": \"Cidade do submerchant\",\n    \"17-4\": \"Não\",\n    \"18-0\": \"<CtrySubDvsn>\",\n    \"18-1\": \"0 à 1\",\n    \"18-2\": \"Text\",\n    \"18-3\": \"Estado do submerchant\",\n    \"18-4\": \"Não\",\n    \"19-0\": \"<Ctry>\",\n    \"19-1\": \"0 à 1\",\n    \"19-2\": \"Text\",\n    \"19-3\": \"País do submerchant\",\n    \"19-4\": \"Não\",\n    \"7-0\": \"LocationAndContact <LctnAndCtct>\",\n    \"7-1\": \"[0..1]\",\n    \"8-1\": \"[0..1]\",\n    \"9-1\": \"[0..1]\",\n    \"10-1\": \"[0..1]\",\n    \"11-1\": \"[0..1]\",\n    \"12-1\": \"[0..1]\",\n    \"7-2\": \"-\",\n    \"8-2\": \"-\",\n    \"9-2\": \"n.. 16\",\n    \"10-2\": \"n.. 35\",\n    \"11-2\": \"n.. 35\",\n    \"12-2\": \"an ..2\",\n    \"12-0\": \"<Ctry>\",\n    \"11-0\": \"<CtrySubDvsn>\",\n    \"10-0\": \"<TwnNm>\",\n    \"9-0\": \"PostCode <PstCd>\",\n    \"8-0\": \"PostalAddress <PstlAdr>\",\n    \"7-3\": \"Container\",\n    \"8-3\": \"Container\",\n    \"9-3\": \"Text\",\n    \"10-3\": \"Text\",\n    \"11-3\": \"Text\",\n    \"12-3\": \"Text\",\n    \"7-4\": \"Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)\",\n    \"8-4\": \"Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)\",\n    \"9-4\": \"CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client  e-commerce. Deve ser enviado apenas se coletado.\",\n    \"10-4\": \"Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client  e-commerce. Deve ser enviado apenas se coletado.\",\n    \"11-4\": \"Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client  e-commerce. Deve ser enviado apenas se coletado.\",\n    \"12-4\": \"Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client  e-commerce. Deve ser enviado apenas se coletado.\",\n    \"37-0\": \"MerchantCategoryCode <MrchntCtgyCd>\",\n    \"37-1\": \"[0..1]\",\n    \"37-2\": \"an ...4\",\n    \"37-3\": \"Text\",\n    \"37-4\": \"Valor do MCC dinâmico, para clientes que precisam sinalizar esta informação na autorização. Deve haver a possibilidade de configuração desta informação para envio no client e-commerce.\"\n  },\n  \"cols\": 5,\n  \"rows\": 49\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"O que é Autorização ?\"\n}\n[/block]\nA autorização de uma transação representa o envio da mesma para o banco para a análise de prevenção, análise do limite de crédito e da validação dos dados do cartão utilizado. Na autorização bem-sucedida é feita a reserva do limite de crédito do portador do cartão junto ao banco emissor, mas nenhuma cobrança é feita. \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\nA captura representa a cobrança de fato do valor já reservado junto ao banco emissor. Nesse momento sua transação passará para o status pago e você possui a garantia de que receberá o valor daquela transação. Por padrão a autorização e a captura são feitas de forma automática, assim logo após criar uma transação você já recebe a resposta da captura, com a transação paga ou recusada.\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  \"title\": \"O que é \\\"Recorrência\\\"?\"\n}\n[/block]\nRecorrência é uma funcionalidade para envio de transações recorrentes sem a necessidade de envio das informações do cartão/comprador integralmente em todas as parcelas/transações.\n\nEssa funcionalidade tem como objetivo facilitar o controle e envio de informações de transações que são periodicamente encaminhadas com os mesmos valores e dados do comprador (cartão).\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Como funciona?\",\n  \"body\": \"Ao encaminhar uma transação recorrente, deve-se adicionar as seguintes *TAGs* nas informações da transação: <tx>\\n\\n<AddtlSvc> - **AdditionalService**\\n<SvcAttr> - **ServiceAttribute** \\n\\n**Para primeira transação da recorrência:**\\n<tx>\\n...\\n<AddtlSvc>**RECP**</AddtlSvc>\\n<SvcAttr>**FREC**</SvcAttr>\\n...\\n</tx>\\n\\n**Para transações posteriores da recorrência:**\\n<tx>\\n...\\n<AddtlSvc>**RECP**</AddtlSvc>\\n<SvcAttr>**RREC**</SvcAttr>\\n...\\n</tx>\"\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 as suas vendas o cliente gera um saldo, ou uma agenda de recebíveis. A adquirente é responsável por efetivar o pagamento daquele saldo para o lojista. Esse momento do pagamento é chamado de liquidação. \n\n **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+1, ou seja, um dia 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\nCrédito à vista: Em geral a liquidação de transações de crédito à vista ocorre em D+30, ou seja, trinta dias depois da captura da transação (dias úteis).\n\nCrédito parcelado: Em uma transação parcelada, por exemplo, em 2 parcelas, a primeira liquidação acontece geralmente em D+30 e a segunda em D+60, ambas a partir da data da captura. \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\nVamos supor um cenário no qual um cliente (lojista) possui negociado um aluguel de R$120,00 da maquininha Stone e naquele mês transacionou apenas R$50,00. Nesse caso, quando a cobrança referente ao POS for realizada nos recebíveis do cliente, não haverá saldo suficiente, de modo que o mesmo ficará com um saldo negativo de R$70,00.\n\nPorque seu saldo se tornará : \n\nSALDO = SALDO ANTERIOR + VALOR DA TRANSAÇÃO = R$ - 120,00 + 50,00 =  R$ -70,00. \n\nEntão, como apenas liquidamos saldo, não iremos retirar esse R$ -70,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]\nNo cenário mais comum, a autorização com captura já acontecem quase que simultaneamente e de forma automática. Em uma situação de compra via uma plataforma digital, o cliente seleciona os seus produtos ao carrinho e, ao finalizar o pedido e faz o pagamento inserindo os dados para autenticação da compra. Nesse momento, é realizada uma comunicação com a adquirente solicitando a autorização e a captura daquele valor. Dessa forma, logo após criar uma transação já se recebe uma resposta de captura com a transação paga ou recusada. Esse é o processo utilizado na maioria dos e-commerces. \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 acordada 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. Existem dois tipos de parcelamentos e ambos possuem juros. A diferença é de quem os juros serão cobrados: a) do portador do cartão ou; b) do lojista.\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 sem juros** – é o pagamento mensal do valor da compra, dividido pelo número escolhido de parcelas. O pagamento é realizado de acordo com a data de faturamento acordada entre o portador do cartão e o emissor, nos meses subsequentes a compra, até que valor integral devido seja quitado. É o adquirente quem controla as parcelas desta transação. \n **Parcelado com juros** – é similar ao parcelado sem juros, porém, no valor a ser pago, será acrescentado juros cobrados diretamente pelo emissor e devidamente aceitos pelo portador. Para o adquirente e o estabelecimento, a transação será liquidada como à vista. É o emissor quem controla as parcelas dessa transação.\n\n\n\n\nA autorização é o processo de troca de mensagens entre o estabelecimento e o adquirente para verificação do limite de saldo do protador para realização daquela transação. Nesse momento, é feita a reserva do limite de crédito do portador do cartão junto ao banco emissor, mas nenhuma cobrança é realizada. 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**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) (Sandbox) 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**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]","excerpt":"Neste item exemplificamos o modelo esperado por nosso autorizador para uma requisição de Autorização. Deve se adicionar o endpoint /Authorize ao endereço de conexão","githubsync":"","childrenPages":[]}

postMensagens de Autorização

Neste item exemplificamos o modelo esperado por nosso autorizador para uma requisição de Autorização. Deve se adicionar o endpoint /Authorize ao endereço de conexão

[block:api-header] { "title": "Authorize" } [/block] [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", "13-1": "0 à 1", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "1", "24-1": "0 à 1", "25-1": "1", "26-1": "1", "27-1": "1", "28-1": "1", "29-1": "1", "30-1": "1", "31-1": "1", "32-1": "0 à 1", "33-1": "1", "36-1": "0 à 1", "38-1": "1", "39-1": "1", "40-1": "1", "41-1": "1", "42-1": "1", "43-1": "1", "44-1": "1", "45-1": "0 à 1", "46-1": "0 à 1", "47-1": "1", "48-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>", "13-0": "ShortName<ShrtNm>", "20-0": "Poi<POI>", "21-0": "Identification<ID>", "22-0": "Identification<ID>", "23-0": "Card<Card>", "24-0": "PlainCardData<PlainCardData>", "25-0": "PAN<PAN>", "26-0": "ExpiryDate<XpryDt>", "27-0": "CardSctyCd<CardSctyCd>", "28-0": "CSCVal<CSCVal>", "29-0": "Context<Cntxt>", "30-0": "PaymentContext<PmtCntxt>", "31-0": "CardDataEntryMode<CardDataNtryMd>", "32-0": "TransactionChannel<TxChanl>", "33-0": "Transaction<Tx>", "36-0": "InitiatorTransactionIdentification<InitrTxId>", "38-0": "TransactionCapture<TxCaptr>", "39-0": "TransactionIdentification<TxId>", "40-0": "TransactionDateTime<TxDtTm>", "41-0": "TransactionReference<TxRef>", "42-0": "TransactionDetails<TxDtls>", "43-0": "Currency<Ccy>", "44-0": "TotalAmount<TtlAmt>", "45-0": "AccountType<AcctTp>", "46-0": "RecurringTransaction<RcrngTx>", "47-0": "InstalmentType<InstlmtTp>", "48-0": "TotalNumberOfPayments <TtlNbOfPmts>", "0-2": "Container", "1-2": "Text", "2-2": "Container", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Text", "13-2": "Text", "20-2": "Container", "21-2": "Container", "22-2": "Text", "23-2": "Container", "24-2": "Container", "25-2": "Text", "26-2": "Text", "27-2": "Container", "28-2": "Text", "29-2": "Container", "30-2": "Container", "31-2": "CodeSet", "32-2": "CodeSet", "33-2": "Container", "36-2": "Text", "38-2": "Boolean", "39-2": "Container", "40-2": "DateTime", "41-2": "Text", "42-2": "Container", "43-2": "CodeSet", "44-2": "Amount", "45-2": "CodeSet", "46-2": "Container", "47-2": "CodeSet", "48-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", "13-4": "Não", "20-4": "Sim", "21-4": "Sim", "22-4": "Sim", "23-4": "Sim", "24-4": "Não", "25-4": "Sim", "26-4": "Sim", "27-4": "Sim", "28-4": "Sim", "29-4": "Sim", "30-4": "Sim", "31-4": "Sim", "32-4": "Sim", "33-4": "Sim", "36-4": "Não", "38-4": "Sim", "39-4": "Sim", "40-4": "Sim", "41-4": "Sim", "42-4": "Sim", "43-4": "Sim", "44-4": "Sim", "45-4": "Não", "46-4": "Não", "47-4": "Sim", "48-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”.", "13-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.", "20-3": "Dados do ponto de interação", "21-3": "Identificação do ponto de interação", "22-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento.", "23-3": "Dados do cartão utilizado na transação.", "24-3": "Dados não criptografados do cartão utilizado na transação.", "25-3": "Número do cartão. (Primary Account Number)", "26-3": "Data de validade do cartão no formato “yyyy-MM”.", "27-3": "Código de segurança do cartão", "28-3": "CVV estampado no verso do cartão", "29-3": "Informações da transação a ser realizada.", "30-3": "Informações sobre o pagamento.", "31-3": "Modo da entrada dos dados do cartão: PHYS = Ecommerce ou Digitada;", "32-3": "Tipo do canal de comunicação utilizado na transação. Obs.: Preencher esta tag apenas se CardDataNtryMd = PHYS ou ECOM = Ecommerce ou Digitada", "33-3": "Informações da transação.", "36-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** ", "38-3": "Indica se os dados da transação devem ser capturados - true - ou não false - imediatamente.", "39-3": "Dados de identificação da transação atribuída pelo POI (Ponto de interação).", "40-3": "Data local e hora da transação atribuídas pelo POI (ponto de interação).", "41-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.", "42-3": "Detalhes da transação.", "43-3": "Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.", "44-3": "Valor total da transação em centavos.", "45-3": "Modalidade do cartão utilizado na transação. \n**Fixo**: **CRDT **= Crédito.", "46-3": "Os dados relativos à(s) parcela(s) ou a uma transação recorrente.", "47-3": "Tipo de parcelamento. \nNONE = A vista\nMCHT = Lojista\nISSR = Emissor (Com Juros)", "48-3": "Número do total de parcelas.\nPara transação a vista deve ser enviado o valor “0\".", "h-5": "Tamanho", "0-5": "-", "1-5": "an ... 6", "2-5": "-", "3-5": "-", "4-5": "-", "5-5": "an 32", "34-0": "AdditionalService<AddtlSvc>", "34-1": "0 à 1", "34-2": "CodeSet", "35-0": "ServiceAttribute", "35-1": "0 à 1", "35-2": "CodeSet", "34-4": "Não (apenas para **recorrência**)", "35-4": "Não (apenas para **recorrência**)", "34-3": "Informações da transação de recorrência.\n\nValor \"FIXO\" = RECP (*Recurring Payment*)", "35-3": "Informações da transação de recorrência.\n\nValores:\nFREC (*First Recurring*) para a **PRIMEIRA TRANSAÇÃO** \n\nRREC (*Following Recurring*) para as **TRANSAÇÕES POSTERIORES**", "14-0": "LocationAndContact <LctnAndCtct>", "14-1": "0 à 1", "14-2": "Container", "14-3": "Dados de PSP", "14-4": "Não", "15-0": "PostalAddress <PstlAdr>", "15-1": "0 à 1", "15-2": "Container", "15-3": "Dados de PSP", "15-4": "Não", "16-0": "PostCode <PstCd>", "16-1": "0 à 1", "16-2": "Text", "16-3": "CEP do submerchant", "16-4": "Não", "17-0": "<TwnNm>", "17-1": "0 à 1", "17-2": "Text", "17-3": "Cidade do submerchant", "17-4": "Não", "18-0": "<CtrySubDvsn>", "18-1": "0 à 1", "18-2": "Text", "18-3": "Estado do submerchant", "18-4": "Não", "19-0": "<Ctry>", "19-1": "0 à 1", "19-2": "Text", "19-3": "País do submerchant", "19-4": "Não", "7-0": "LocationAndContact <LctnAndCtct>", "7-1": "[0..1]", "8-1": "[0..1]", "9-1": "[0..1]", "10-1": "[0..1]", "11-1": "[0..1]", "12-1": "[0..1]", "7-2": "-", "8-2": "-", "9-2": "n.. 16", "10-2": "n.. 35", "11-2": "n.. 35", "12-2": "an ..2", "12-0": "<Ctry>", "11-0": "<CtrySubDvsn>", "10-0": "<TwnNm>", "9-0": "PostCode <PstCd>", "8-0": "PostalAddress <PstlAdr>", "7-3": "Container", "8-3": "Container", "9-3": "Text", "10-3": "Text", "11-3": "Text", "12-3": "Text", "7-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)", "8-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)", "9-4": "CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "10-4": "Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "11-4": "Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "12-4": "Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "37-0": "MerchantCategoryCode <MrchntCtgyCd>", "37-1": "[0..1]", "37-2": "an ...4", "37-3": "Text", "37-4": "Valor do MCC dinâmico, para clientes que precisam sinalizar esta informação na autorização. Deve haver a possibilidade de configuração desta informação para envio no client e-commerce." }, "cols": 5, "rows": 49 } [/block] [block:api-header] { "type": "basic", "title": "O que é Autorização ?" } [/block] A autorização de uma transação representa o envio da mesma para o banco para a análise de prevenção, análise do limite de crédito e da validação dos dados do cartão utilizado. Na autorização bem-sucedida é feita a reserva do limite de crédito do portador do cartão junto ao banco emissor, mas nenhuma cobrança é feita. [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. A captura representa a cobrança de fato do valor já reservado junto ao banco emissor. Nesse momento sua transação passará para o status pago e você possui a garantia de que receberá o valor daquela transação. Por padrão a autorização e a captura são feitas de forma automática, assim logo após criar uma transação você já recebe a resposta da captura, com a transação paga ou recusada. 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] { "title": "O que é \"Recorrência\"?" } [/block] Recorrência é uma funcionalidade para envio de transações recorrentes sem a necessidade de envio das informações do cartão/comprador integralmente em todas as parcelas/transações. Essa funcionalidade tem como objetivo facilitar o controle e envio de informações de transações que são periodicamente encaminhadas com os mesmos valores e dados do comprador (cartão). [block:callout] { "type": "info", "title": "Como funciona?", "body": "Ao encaminhar uma transação recorrente, deve-se adicionar as seguintes *TAGs* nas informações da transação: <tx>\n\n<AddtlSvc> - **AdditionalService**\n<SvcAttr> - **ServiceAttribute** \n\n**Para primeira transação da recorrência:**\n<tx>\n...\n<AddtlSvc>**RECP**</AddtlSvc>\n<SvcAttr>**FREC**</SvcAttr>\n...\n</tx>\n\n**Para transações posteriores da recorrência:**\n<tx>\n...\n<AddtlSvc>**RECP**</AddtlSvc>\n<SvcAttr>**RREC**</SvcAttr>\n...\n</tx>" } [/block] [block:api-header] { "type": "basic", "title": "O que é a Liquidação ?" } [/block] De acordo com as suas vendas o cliente gera um saldo, ou uma agenda de recebíveis. A adquirente é responsável por efetivar o pagamento daquele saldo para o lojista. Esse momento do pagamento é chamado de liquidação. **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+1, ou seja, um dia 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 : Crédito à vista: Em geral a liquidação de transações de crédito à vista ocorre em D+30, ou seja, trinta dias depois da captura da transação (dias úteis). Crédito parcelado: Em uma transação parcelada, por exemplo, em 2 parcelas, a primeira liquidação acontece geralmente em D+30 e a segunda em D+60, ambas a partir da data da captura. 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** : Vamos supor um cenário no qual um cliente (lojista) possui negociado um aluguel de R$120,00 da maquininha Stone e naquele mês transacionou apenas R$50,00. Nesse caso, quando a cobrança referente ao POS for realizada nos recebíveis do cliente, não haverá saldo suficiente, de modo que o mesmo ficará com um saldo negativo de R$70,00. Porque seu saldo se tornará : SALDO = SALDO ANTERIOR + VALOR DA TRANSAÇÃO = R$ - 120,00 + 50,00 = R$ -70,00. Então, como apenas liquidamos saldo, não iremos retirar esse R$ -70,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] No cenário mais comum, a autorização com captura já acontecem quase que simultaneamente e de forma automática. Em uma situação de compra via uma plataforma digital, o cliente seleciona os seus produtos ao carrinho e, ao finalizar o pedido e faz o pagamento inserindo os dados para autenticação da compra. Nesse momento, é realizada uma comunicação com a adquirente solicitando a autorização e a captura daquele valor. Dessa forma, logo após criar uma transação já se recebe uma resposta de captura com a transação paga ou recusada. Esse é o processo utilizado na maioria dos e-commerces. [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 acordada 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. Existem dois tipos de parcelamentos e ambos possuem juros. A diferença é de quem os juros serão cobrados: a) do portador do cartão ou; b) do lojista. **Tipos de parcelamento** Durante o credenciamento com a STONE é possível optar pelas seguintes formas de parcelamento de transações: **Parcelado sem juros** – é o pagamento mensal do valor da compra, dividido pelo número escolhido de parcelas. O pagamento é realizado de acordo com a data de faturamento acordada entre o portador do cartão e o emissor, nos meses subsequentes a compra, até que valor integral devido seja quitado. É o adquirente quem controla as parcelas desta transação. **Parcelado com juros** – é similar ao parcelado sem juros, porém, no valor a ser pago, será acrescentado juros cobrados diretamente pelo emissor e devidamente aceitos pelo portador. Para o adquirente e o estabelecimento, a transação será liquidada como à vista. É o emissor quem controla as parcelas dessa transação. A autorização é o processo de troca de mensagens entre o estabelecimento e o adquirente para verificação do limite de saldo do protador para realização daquela transação. Nesse momento, é feita a reserva do limite de crédito do portador do cartão junto ao banco emissor, mas nenhuma cobrança é realizada. 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) (Sandbox) 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. **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] { "title": "Authorize" } [/block] [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", "13-1": "0 à 1", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "1", "24-1": "0 à 1", "25-1": "1", "26-1": "1", "27-1": "1", "28-1": "1", "29-1": "1", "30-1": "1", "31-1": "1", "32-1": "0 à 1", "33-1": "1", "36-1": "0 à 1", "38-1": "1", "39-1": "1", "40-1": "1", "41-1": "1", "42-1": "1", "43-1": "1", "44-1": "1", "45-1": "0 à 1", "46-1": "0 à 1", "47-1": "1", "48-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>", "13-0": "ShortName<ShrtNm>", "20-0": "Poi<POI>", "21-0": "Identification<ID>", "22-0": "Identification<ID>", "23-0": "Card<Card>", "24-0": "PlainCardData<PlainCardData>", "25-0": "PAN<PAN>", "26-0": "ExpiryDate<XpryDt>", "27-0": "CardSctyCd<CardSctyCd>", "28-0": "CSCVal<CSCVal>", "29-0": "Context<Cntxt>", "30-0": "PaymentContext<PmtCntxt>", "31-0": "CardDataEntryMode<CardDataNtryMd>", "32-0": "TransactionChannel<TxChanl>", "33-0": "Transaction<Tx>", "36-0": "InitiatorTransactionIdentification<InitrTxId>", "38-0": "TransactionCapture<TxCaptr>", "39-0": "TransactionIdentification<TxId>", "40-0": "TransactionDateTime<TxDtTm>", "41-0": "TransactionReference<TxRef>", "42-0": "TransactionDetails<TxDtls>", "43-0": "Currency<Ccy>", "44-0": "TotalAmount<TtlAmt>", "45-0": "AccountType<AcctTp>", "46-0": "RecurringTransaction<RcrngTx>", "47-0": "InstalmentType<InstlmtTp>", "48-0": "TotalNumberOfPayments <TtlNbOfPmts>", "0-2": "Container", "1-2": "Text", "2-2": "Container", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Text", "13-2": "Text", "20-2": "Container", "21-2": "Container", "22-2": "Text", "23-2": "Container", "24-2": "Container", "25-2": "Text", "26-2": "Text", "27-2": "Container", "28-2": "Text", "29-2": "Container", "30-2": "Container", "31-2": "CodeSet", "32-2": "CodeSet", "33-2": "Container", "36-2": "Text", "38-2": "Boolean", "39-2": "Container", "40-2": "DateTime", "41-2": "Text", "42-2": "Container", "43-2": "CodeSet", "44-2": "Amount", "45-2": "CodeSet", "46-2": "Container", "47-2": "CodeSet", "48-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", "13-4": "Não", "20-4": "Sim", "21-4": "Sim", "22-4": "Sim", "23-4": "Sim", "24-4": "Não", "25-4": "Sim", "26-4": "Sim", "27-4": "Sim", "28-4": "Sim", "29-4": "Sim", "30-4": "Sim", "31-4": "Sim", "32-4": "Sim", "33-4": "Sim", "36-4": "Não", "38-4": "Sim", "39-4": "Sim", "40-4": "Sim", "41-4": "Sim", "42-4": "Sim", "43-4": "Sim", "44-4": "Sim", "45-4": "Não", "46-4": "Não", "47-4": "Sim", "48-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”.", "13-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.", "20-3": "Dados do ponto de interação", "21-3": "Identificação do ponto de interação", "22-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento.", "23-3": "Dados do cartão utilizado na transação.", "24-3": "Dados não criptografados do cartão utilizado na transação.", "25-3": "Número do cartão. (Primary Account Number)", "26-3": "Data de validade do cartão no formato “yyyy-MM”.", "27-3": "Código de segurança do cartão", "28-3": "CVV estampado no verso do cartão", "29-3": "Informações da transação a ser realizada.", "30-3": "Informações sobre o pagamento.", "31-3": "Modo da entrada dos dados do cartão: PHYS = Ecommerce ou Digitada;", "32-3": "Tipo do canal de comunicação utilizado na transação. Obs.: Preencher esta tag apenas se CardDataNtryMd = PHYS ou ECOM = Ecommerce ou Digitada", "33-3": "Informações da transação.", "36-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** ", "38-3": "Indica se os dados da transação devem ser capturados - true - ou não false - imediatamente.", "39-3": "Dados de identificação da transação atribuída pelo POI (Ponto de interação).", "40-3": "Data local e hora da transação atribuídas pelo POI (ponto de interação).", "41-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.", "42-3": "Detalhes da transação.", "43-3": "Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.", "44-3": "Valor total da transação em centavos.", "45-3": "Modalidade do cartão utilizado na transação. \n**Fixo**: **CRDT **= Crédito.", "46-3": "Os dados relativos à(s) parcela(s) ou a uma transação recorrente.", "47-3": "Tipo de parcelamento. \nNONE = A vista\nMCHT = Lojista\nISSR = Emissor (Com Juros)", "48-3": "Número do total de parcelas.\nPara transação a vista deve ser enviado o valor “0\".", "h-5": "Tamanho", "0-5": "-", "1-5": "an ... 6", "2-5": "-", "3-5": "-", "4-5": "-", "5-5": "an 32", "34-0": "AdditionalService<AddtlSvc>", "34-1": "0 à 1", "34-2": "CodeSet", "35-0": "ServiceAttribute", "35-1": "0 à 1", "35-2": "CodeSet", "34-4": "Não (apenas para **recorrência**)", "35-4": "Não (apenas para **recorrência**)", "34-3": "Informações da transação de recorrência.\n\nValor \"FIXO\" = RECP (*Recurring Payment*)", "35-3": "Informações da transação de recorrência.\n\nValores:\nFREC (*First Recurring*) para a **PRIMEIRA TRANSAÇÃO** \n\nRREC (*Following Recurring*) para as **TRANSAÇÕES POSTERIORES**", "14-0": "LocationAndContact <LctnAndCtct>", "14-1": "0 à 1", "14-2": "Container", "14-3": "Dados de PSP", "14-4": "Não", "15-0": "PostalAddress <PstlAdr>", "15-1": "0 à 1", "15-2": "Container", "15-3": "Dados de PSP", "15-4": "Não", "16-0": "PostCode <PstCd>", "16-1": "0 à 1", "16-2": "Text", "16-3": "CEP do submerchant", "16-4": "Não", "17-0": "<TwnNm>", "17-1": "0 à 1", "17-2": "Text", "17-3": "Cidade do submerchant", "17-4": "Não", "18-0": "<CtrySubDvsn>", "18-1": "0 à 1", "18-2": "Text", "18-3": "Estado do submerchant", "18-4": "Não", "19-0": "<Ctry>", "19-1": "0 à 1", "19-2": "Text", "19-3": "País do submerchant", "19-4": "Não", "7-0": "LocationAndContact <LctnAndCtct>", "7-1": "[0..1]", "8-1": "[0..1]", "9-1": "[0..1]", "10-1": "[0..1]", "11-1": "[0..1]", "12-1": "[0..1]", "7-2": "-", "8-2": "-", "9-2": "n.. 16", "10-2": "n.. 35", "11-2": "n.. 35", "12-2": "an ..2", "12-0": "<Ctry>", "11-0": "<CtrySubDvsn>", "10-0": "<TwnNm>", "9-0": "PostCode <PstCd>", "8-0": "PostalAddress <PstlAdr>", "7-3": "Container", "8-3": "Container", "9-3": "Text", "10-3": "Text", "11-3": "Text", "12-3": "Text", "7-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)", "8-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)", "9-4": "CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "10-4": "Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "11-4": "Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "12-4": "Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "37-0": "MerchantCategoryCode <MrchntCtgyCd>", "37-1": "[0..1]", "37-2": "an ...4", "37-3": "Text", "37-4": "Valor do MCC dinâmico, para clientes que precisam sinalizar esta informação na autorização. Deve haver a possibilidade de configuração desta informação para envio no client e-commerce." }, "cols": 5, "rows": 49 } [/block] [block:api-header] { "type": "basic", "title": "O que é Autorização ?" } [/block] A autorização de uma transação representa o envio da mesma para o banco para a análise de prevenção, análise do limite de crédito e da validação dos dados do cartão utilizado. Na autorização bem-sucedida é feita a reserva do limite de crédito do portador do cartão junto ao banco emissor, mas nenhuma cobrança é feita. [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. A captura representa a cobrança de fato do valor já reservado junto ao banco emissor. Nesse momento sua transação passará para o status pago e você possui a garantia de que receberá o valor daquela transação. Por padrão a autorização e a captura são feitas de forma automática, assim logo após criar uma transação você já recebe a resposta da captura, com a transação paga ou recusada. 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] { "title": "O que é \"Recorrência\"?" } [/block] Recorrência é uma funcionalidade para envio de transações recorrentes sem a necessidade de envio das informações do cartão/comprador integralmente em todas as parcelas/transações. Essa funcionalidade tem como objetivo facilitar o controle e envio de informações de transações que são periodicamente encaminhadas com os mesmos valores e dados do comprador (cartão). [block:callout] { "type": "info", "title": "Como funciona?", "body": "Ao encaminhar uma transação recorrente, deve-se adicionar as seguintes *TAGs* nas informações da transação: <tx>\n\n<AddtlSvc> - **AdditionalService**\n<SvcAttr> - **ServiceAttribute** \n\n**Para primeira transação da recorrência:**\n<tx>\n...\n<AddtlSvc>**RECP**</AddtlSvc>\n<SvcAttr>**FREC**</SvcAttr>\n...\n</tx>\n\n**Para transações posteriores da recorrência:**\n<tx>\n...\n<AddtlSvc>**RECP**</AddtlSvc>\n<SvcAttr>**RREC**</SvcAttr>\n...\n</tx>" } [/block] [block:api-header] { "type": "basic", "title": "O que é a Liquidação ?" } [/block] De acordo com as suas vendas o cliente gera um saldo, ou uma agenda de recebíveis. A adquirente é responsável por efetivar o pagamento daquele saldo para o lojista. Esse momento do pagamento é chamado de liquidação. **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+1, ou seja, um dia 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 : Crédito à vista: Em geral a liquidação de transações de crédito à vista ocorre em D+30, ou seja, trinta dias depois da captura da transação (dias úteis). Crédito parcelado: Em uma transação parcelada, por exemplo, em 2 parcelas, a primeira liquidação acontece geralmente em D+30 e a segunda em D+60, ambas a partir da data da captura. 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** : Vamos supor um cenário no qual um cliente (lojista) possui negociado um aluguel de R$120,00 da maquininha Stone e naquele mês transacionou apenas R$50,00. Nesse caso, quando a cobrança referente ao POS for realizada nos recebíveis do cliente, não haverá saldo suficiente, de modo que o mesmo ficará com um saldo negativo de R$70,00. Porque seu saldo se tornará : SALDO = SALDO ANTERIOR + VALOR DA TRANSAÇÃO = R$ - 120,00 + 50,00 = R$ -70,00. Então, como apenas liquidamos saldo, não iremos retirar esse R$ -70,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] No cenário mais comum, a autorização com captura já acontecem quase que simultaneamente e de forma automática. Em uma situação de compra via uma plataforma digital, o cliente seleciona os seus produtos ao carrinho e, ao finalizar o pedido e faz o pagamento inserindo os dados para autenticação da compra. Nesse momento, é realizada uma comunicação com a adquirente solicitando a autorização e a captura daquele valor. Dessa forma, logo após criar uma transação já se recebe uma resposta de captura com a transação paga ou recusada. Esse é o processo utilizado na maioria dos e-commerces. [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 acordada 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. Existem dois tipos de parcelamentos e ambos possuem juros. A diferença é de quem os juros serão cobrados: a) do portador do cartão ou; b) do lojista. **Tipos de parcelamento** Durante o credenciamento com a STONE é possível optar pelas seguintes formas de parcelamento de transações: **Parcelado sem juros** – é o pagamento mensal do valor da compra, dividido pelo número escolhido de parcelas. O pagamento é realizado de acordo com a data de faturamento acordada entre o portador do cartão e o emissor, nos meses subsequentes a compra, até que valor integral devido seja quitado. É o adquirente quem controla as parcelas desta transação. **Parcelado com juros** – é similar ao parcelado sem juros, porém, no valor a ser pago, será acrescentado juros cobrados diretamente pelo emissor e devidamente aceitos pelo portador. Para o adquirente e o estabelecimento, a transação será liquidada como à vista. É o emissor quem controla as parcelas dessa transação. A autorização é o processo de troca de mensagens entre o estabelecimento e o adquirente para verificação do limite de saldo do protador para realização daquela transação. Nesse momento, é feita a reserva do limite de crédito do portador do cartão junto ao banco emissor, mas nenhuma cobrança é realizada. 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) (Sandbox) 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. **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]
{"_id":"591445abbb92601b00a4fad1","title":"Captura Posterior","__v":0,"category":"591445abbb92601b00a4fac9","link_url":"","sync_unique":"","api":{"method":"post","results":{"codes":[{"status":200,"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>EF1CC1A4FECE40EB8B29CA7328955C77</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"},{"name":"","code":"{}","language":"json","status":400}]},"settings":"","auth":"required","params":[],"url":"/CompletionAdvice","examples":{"codes":[{"language":"xml","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>EF1CC1A4FECE40EB8B29CA7328955C77</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>"}]}},"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 transaçã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/sandbox).\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    \"13-0\": \"Transaction<Tx>\",\n    \"14-0\": \"TransactionIdentification<TxId>\",\n    \"15-0\": \"TransactionDateTime<TxDtTm>\",\n    \"16-0\": \"TransactionReference<TxRef>\",\n    \"17-0\": \"OriginalTransaction<OrgnlTx>\",\n    \"18-0\": \"RecipientTransactionIdentification<RcptTxId>\",\n    \"19-0\": \"TransactionDetails<TxDtls>\",\n    \"20-0\": \"Currency<Ccy>\",\n    \"21-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    \"13-1\": \"1\",\n    \"14-1\": \"1\",\n    \"15-1\": \"1\",\n    \"21-1\": \"1\",\n    \"20-1\": \"1\",\n    \"19-1\": \"1\",\n    \"18-1\": \"0 à 1\",\n    \"17-1\": \"0 à 1\",\n    \"16-1\": \"1\",\n    \"21-4\": \"Sim\",\n    \"20-4\": \"Sim\",\n    \"19-4\": \"Sim\",\n    \"18-4\": \"Não\",\n    \"17-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    \"13-4\": \"Sim\",\n    \"14-4\": \"Sim\",\n    \"15-4\": \"Sim\",\n    \"16-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    \"13-2\": \"Container\",\n    \"14-2\": \"Container\",\n    \"15-2\": \"DateTime\",\n    \"16-2\": \"Text\",\n    \"17-2\": \"Container\",\n    \"18-2\": \"Text\",\n    \"19-2\": \"Container\",\n    \"20-2\": \"CodeSet\",\n    \"21-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    \"13-3\": \"Dados da transação.\",\n    \"14-3\": \"Dados de identificação da transação atribuída pelo POI.\",\n    \"15-3\": \"Data local e hora da transação atribuído pelo POI. Este campo será ecoado pelo adquirente.\",\n    \"16-3\": \"Identificação da transação atribuída pelo POI. Este campo será ecoado pelo adquirente.\",\n    \"17-3\": \"Identificação da transação original\",\n    \"18-3\": \"Identificação da transação definida pelo adquirente.\",\n    \"19-3\": \"Detalhes da transação.\",\n    \"20-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217.\",\n    \"21-3\": \"Valor total da transação em centavos.\",\n    \"7-0\": \"LocationAndContact <LctnAndCtct>\",\n    \"8-0\": \"PostalAddress <PstlAdr>\",\n    \"9-0\": \"PostCode <PstCd>\",\n    \"10-0\": \"<TwnNm>\",\n    \"11-0\": \"<CtrySubDvsn>\",\n    \"7-1\": \"[0..1]\",\n    \"8-1\": \"[0..1]\",\n    \"9-1\": \"[0..1]\",\n    \"10-1\": \"[0..1]\",\n    \"11-1\": \"[0..1]\",\n    \"12-1\": \"[0..1]\",\n    \"7-2\": \"-\",\n    \"8-2\": \"-\",\n    \"9-2\": \"n.. 16\",\n    \"10-2\": \"n.. 35\",\n    \"11-2\": \"n.. 35\",\n    \"7-3\": \"Container\",\n    \"8-3\": \"Container\",\n    \"9-3\": \"Text\",\n    \"10-3\": \"Text\",\n    \"11-3\": \"Text\",\n    \"12-3\": \"Text\",\n    \"7-4\": \"Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)\",\n    \"8-4\": \"Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)\",\n    \"9-4\": \"CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.\",\n    \"10-4\": \"Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.\",\n    \"11-4\": \"Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.\",\n    \"12-0\": \"<Ctry>\",\n    \"12-2\": \"an ..2\",\n    \"12-4\": \"Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.\"\n  },\n  \"cols\": 5,\n  \"rows\": 22\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]","parentDoc":null,"version":"591445aabb92601b00a4fac8","createdAt":"2016-12-05T16:30:20.617Z","hidden":false,"order":11,"slug":"captura-posterior","updates":[],"next":{"pages":[],"description":""},"githubsync":"","excerpt":"","project":"583f0fb04828d50f00126d4d","user":"57ea79f61780cd170064f273","link_external":false,"isReference":false,"type":"post","childrenPages":[]}

postCaptura Posterior


[block:api-header] { "type": "basic", "title": "AUTORIZAÇÃO COM CAPTURA POSTERIOR" } [/block] Ocorre quando o estabelecimento decide autorizar a transaçã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/sandbox). [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>", "13-0": "Transaction<Tx>", "14-0": "TransactionIdentification<TxId>", "15-0": "TransactionDateTime<TxDtTm>", "16-0": "TransactionReference<TxRef>", "17-0": "OriginalTransaction<OrgnlTx>", "18-0": "RecipientTransactionIdentification<RcptTxId>", "19-0": "TransactionDetails<TxDtls>", "20-0": "Currency<Ccy>", "21-0": "TotalAmount<TtlAmt>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "13-1": "1", "14-1": "1", "15-1": "1", "21-1": "1", "20-1": "1", "19-1": "1", "18-1": "0 à 1", "17-1": "0 à 1", "16-1": "1", "21-4": "Sim", "20-4": "Sim", "19-4": "Sim", "18-4": "Não", "17-4": "Não", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Text", "13-2": "Container", "14-2": "Container", "15-2": "DateTime", "16-2": "Text", "17-2": "Container", "18-2": "Text", "19-2": "Container", "20-2": "CodeSet", "21-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”.", "13-3": "Dados da transação.", "14-3": "Dados de identificação da transação atribuída pelo POI.", "15-3": "Data local e hora da transação atribuído pelo POI. Este campo será ecoado pelo adquirente.", "16-3": "Identificação da transação atribuída pelo POI. Este campo será ecoado pelo adquirente.", "17-3": "Identificação da transação original", "18-3": "Identificação da transação definida pelo adquirente.", "19-3": "Detalhes da transação.", "20-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "21-3": "Valor total da transação em centavos.", "7-0": "LocationAndContact <LctnAndCtct>", "8-0": "PostalAddress <PstlAdr>", "9-0": "PostCode <PstCd>", "10-0": "<TwnNm>", "11-0": "<CtrySubDvsn>", "7-1": "[0..1]", "8-1": "[0..1]", "9-1": "[0..1]", "10-1": "[0..1]", "11-1": "[0..1]", "12-1": "[0..1]", "7-2": "-", "8-2": "-", "9-2": "n.. 16", "10-2": "n.. 35", "11-2": "n.. 35", "7-3": "Container", "8-3": "Container", "9-3": "Text", "10-3": "Text", "11-3": "Text", "12-3": "Text", "7-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)", "8-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)", "9-4": "CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "10-4": "Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "11-4": "Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "12-0": "<Ctry>", "12-2": "an ..2", "12-4": "Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado." }, "cols": 5, "rows": 22 } [/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 transaçã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/sandbox). [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>", "13-0": "Transaction<Tx>", "14-0": "TransactionIdentification<TxId>", "15-0": "TransactionDateTime<TxDtTm>", "16-0": "TransactionReference<TxRef>", "17-0": "OriginalTransaction<OrgnlTx>", "18-0": "RecipientTransactionIdentification<RcptTxId>", "19-0": "TransactionDetails<TxDtls>", "20-0": "Currency<Ccy>", "21-0": "TotalAmount<TtlAmt>", "0-1": "1", "1-1": "1", "2-1": "1", "3-1": "1", "4-1": "1", "5-1": "1", "6-1": "1", "13-1": "1", "14-1": "1", "15-1": "1", "21-1": "1", "20-1": "1", "19-1": "1", "18-1": "0 à 1", "17-1": "0 à 1", "16-1": "1", "21-4": "Sim", "20-4": "Sim", "19-4": "Sim", "18-4": "Não", "17-4": "Não", "0-4": "Sim", "1-4": "Sim", "2-4": "Sim", "3-4": "Sim", "4-4": "Sim", "5-4": "Sim", "6-4": "Sim", "13-4": "Sim", "14-4": "Sim", "15-4": "Sim", "16-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Text", "13-2": "Container", "14-2": "Container", "15-2": "DateTime", "16-2": "Text", "17-2": "Container", "18-2": "Text", "19-2": "Container", "20-2": "CodeSet", "21-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”.", "13-3": "Dados da transação.", "14-3": "Dados de identificação da transação atribuída pelo POI.", "15-3": "Data local e hora da transação atribuído pelo POI. Este campo será ecoado pelo adquirente.", "16-3": "Identificação da transação atribuída pelo POI. Este campo será ecoado pelo adquirente.", "17-3": "Identificação da transação original", "18-3": "Identificação da transação definida pelo adquirente.", "19-3": "Detalhes da transação.", "20-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "21-3": "Valor total da transação em centavos.", "7-0": "LocationAndContact <LctnAndCtct>", "8-0": "PostalAddress <PstlAdr>", "9-0": "PostCode <PstCd>", "10-0": "<TwnNm>", "11-0": "<CtrySubDvsn>", "7-1": "[0..1]", "8-1": "[0..1]", "9-1": "[0..1]", "10-1": "[0..1]", "11-1": "[0..1]", "12-1": "[0..1]", "7-2": "-", "8-2": "-", "9-2": "n.. 16", "10-2": "n.. 35", "11-2": "n.. 35", "7-3": "Container", "8-3": "Container", "9-3": "Text", "10-3": "Text", "11-3": "Text", "12-3": "Text", "7-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)", "8-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client e-commerce)", "9-4": "CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "10-4": "Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "11-4": "Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado.", "12-0": "<Ctry>", "12-2": "an ..2", "12-4": "Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client e-commerce. Deve ser enviado apenas se coletado." }, "cols": 5, "rows": 22 } [/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]
{"_id":"591445abbb92601b00a4fad2","api":{"results":{"codes":[{"language":"xml","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>EF1CC1A4FECE40EB8B29CA7328955C77</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>","name":"","status":200},{"code":"{}","name":"","status":400,"language":"json"}]},"settings":"","url":"/Cancellation","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 de PSP. -->\n                <LctnAndCtct>\n                    <PstlAdr>\n                        <PstCd></PstCd> <!--CEP-->\n                        <TwnNm></TwnNm> <!--CIDADE-->\n                        <CtrySubDvsn></CtrySubDvsn> <!--ESTADO-->\n                        <Ctry></Ctry> <!--PAIS-->                                 \n                    </PstlAdr>\n                </LctnAndCtct>\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                  </Id>\n                </POI>\n                </POI>\n            </Envt>\n            <!-- Dados da transação. -->\n            <Tx>\n                <!-- Fixo true para Cancelamento. -->\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>"}]},"method":"post","params":[]},"parentDoc":null,"project":"583f0fb04828d50f00126d4d","slug":"cancelamentoestorno-desfazimento","type":"post","link_external":false,"link_url":"","next":{"pages":[],"description":""},"sync_unique":"","version":"591445aabb92601b00a4fac8","createdAt":"2016-12-05T16:30:54.921Z","excerpt":"","hidden":false,"order":12,"user":"57ea79f61780cd170064f273","__v":0,"body":"O cancelamento é feito a pedido do portador do cartão, na loja em que a compra foi realizada. A solicitação de cancelamento poderá ser solicitada a qualquer momento, mesmo que em dia diferente ao que ocorreu a transação. \n\n O período permitido para a realização de um cancelamento depende do EMISSOR. Note que cancelamentos podem ser feitos apenas do valor total da transação e pode ser realizado apenas no estabelecimento onde foi realizada a transação original, pois se considera que o SAK será utilizado para localizar a transação na log ou no host da Stone. \n\n É 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 é de 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    \"20-0\": \"Poi<POI>\",\n    \"21-0\": \"Identification<Id>\",\n    \"22-0\": \"Identification<Id>\",\n    \"23-0\": \"Capabilities\",\n    \"24-0\": \"PrintLineWidth<PrtLineWidth>\",\n    \"25-0\": \"Transaction<Tx>\",\n    \"26-0\": \"TransactionCapture<TxCaptr>\",\n    \"27-0\": \"TransactionIdentification<TxId>\",\n    \"28-0\": \"TransactionDateTime<TxDtTm>\",\n    \"29-0\": \"TransactionReference<TxRef>\",\n    \"30-0\": \"TransactionDetails<TxDtls>\",\n    \"31-0\": \"Currency<Ccy>\",\n    \"32-0\": \"TotalAmount<TtlAmt>\",\n    \"33-0\": \"OriginalTransaction<OrgnlTx>\",\n    \"34-0\": \"InitiatorTransactionIdentification<InitrTxId>\",\n    \"35-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    \"20-1\": \"1\",\n    \"21-1\": \"1\",\n    \"22-1\": \"1\",\n    \"23-1\": \"0 à 1\",\n    \"24-1\": \"0 à 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\",\n    \"33-1\": \"1\",\n    \"34-1\": \"1\",\n    \"35-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    \"20-4\": \"Sim\",\n    \"21-4\": \"Sim\",\n    \"22-4\": \"Sim\",\n    \"23-4\": \"Não\",\n    \"24-4\": \"Não\",\n    \"25-4\": \"Sim\",\n    \"26-4\": \"Sim\",\n    \"27-4\": \"Sim\",\n    \"28-4\": \"Sim\",\n    \"29-4\": \"Sim\",\n    \"30-4\": \"Sim\",\n    \"31-4\": \"Sim\",\n    \"32-4\": \"Sim\",\n    \"33-4\": \"Sim\",\n    \"34-4\": \"Sim\",\n    \"35-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    \"20-2\": \"Container\",\n    \"21-2\": \"Container\",\n    \"7-2\": \"Text\",\n    \"23-2\": \"Container\",\n    \"22-2\": \"Text\",\n    \"24-2\": \"Text\",\n    \"25-2\": \"Container\",\n    \"26-2\": \"Bool\",\n    \"27-2\": \"Container\",\n    \"28-2\": \"DateTime\",\n    \"29-2\": \"Text\",\n    \"30-2\": \"Container\",\n    \"31-2\": \"CodeSet\",\n    \"32-2\": \"Amount\",\n    \"33-2\": \"Container\",\n    \"34-2\": \"Text\",\n    \"35-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    \"20-3\": \"Dados do Ponto de Interação.\",\n    \"21-3\": \"Identificação do ponto de interação\",\n    \"22-3\": \"Código de identificação do ponto de interação atribuído pelo estabelecimento.\",\n    \"23-3\": \"Capacidades do Ponto de interação.\",\n    \"24-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    \"25-3\": \"Dados da transação.\",\n    \"26-3\": \"Fixo true para requisições de cancelamento.\",\n    \"27-3\": \"Identificação da transação atribuída pelo POI (Ponto de interação).\",\n    \"28-3\": \"Data e hora local da transação definidas pelo ponto de interação.\",\n    \"29-3\": \"Identificação da transação definida pelo ponto de interação. O formato é livre contendo no máximo 32 caracteres.\",\n    \"30-3\": \"Detalhes da transação\",\n    \"31-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217.\",\n    \"32-3\": \"Valor total da transação em centavos\",\n    \"33-3\": \"Dados da transação original\",\n    \"34-3\": \"Identificação da transação definida pelo sistema que se comunica com o Host Stone.\\n\\nTamanho máximo : \\n32 caracteres\",\n    \"35-3\": \"Identificação da transação definida pelo adquirente.\",\n    \"14-0\": \"LocationAndContact <LctnAndCtct>\",\n    \"14-1\": \"0 à 1\",\n    \"14-2\": \"Text\",\n    \"14-3\": \"Dados de PSP\",\n    \"14-4\": \"Não\",\n    \"15-0\": \"PostalAddress <PstlAdr>\",\n    \"15-1\": \"0 à 1\",\n    \"15-2\": \"Text\",\n    \"15-3\": \"Dados de PSP\",\n    \"15-4\": \"Não\",\n    \"16-0\": \"PostCode <PstCd>\",\n    \"16-1\": \"0 à 1\",\n    \"16-2\": \"Text\",\n    \"16-3\": \"CEP do submerchant\",\n    \"16-4\": \"Não\",\n    \"17-0\": \"TownName <TwnNm>\",\n    \"17-1\": \"0 à 1\",\n    \"17-2\": \"Text\",\n    \"17-3\": \"Cidade do submerchant\",\n    \"17-4\": \"Não\",\n    \"18-0\": \"CountrySubDivision <CtrySubDvsn>\",\n    \"18-1\": \"0 à 1\",\n    \"18-2\": \"Text\",\n    \"18-3\": \"Estado do submerchant\",\n    \"18-4\": \"Não\",\n    \"19-0\": \"Country<Ctry>\",\n    \"19-1\": \"0 à 1\",\n    \"19-2\": \"Text\",\n    \"19-3\": \"País do submerchant\",\n    \"19-4\": \"Não\",\n    \"8-0\": \"LocationAndContact <LctnAndCtct>\",\n    \"9-0\": \"PostalAddress <PstlAdr>\",\n    \"10-0\": \"PostCode <PstCd>\",\n    \"11-0\": \"<TwnNm>\",\n    \"12-0\": \"<CtrySubDvsn>\",\n    \"8-1\": \"[0..1]\",\n    \"9-1\": \"[0..1]\",\n    \"10-1\": \"[0..1]\",\n    \"11-1\": \"[0..1]\",\n    \"12-1\": \"[0..1]\",\n    \"13-1\": \"[0..1]\",\n    \"8-2\": \"-\",\n    \"9-2\": \"-\",\n    \"10-2\": \"n.. 16\",\n    \"11-2\": \"n.. 35\",\n    \"12-2\": \"n.. 35\",\n    \"8-3\": \"Container\",\n    \"9-3\": \"Container\",\n    \"10-3\": \"Text\",\n    \"11-3\": \"Text\",\n    \"12-3\": \"Text\",\n    \"13-3\": \"Text\",\n    \"8-4\": \"Dados de PSP (Enviado apenas se dados de PSP coletados no client TEF) – Apenas para Estorno\",\n    \"9-4\": \"Dados de PSP (Enviado apenas se dados de PSP coletados no client TEF) – Apenas para Estorno\",\n    \"10-4\": \"CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno\",\n    \"11-4\": \"Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno\",\n    \"12-4\": \"Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno\",\n    \"13-4\": \"Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno\",\n    \"13-2\": \"an ..2\",\n    \"13-0\": \"<Ctry>\"\n  },\n  \"cols\": 5,\n  \"rows\": 36\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 haver algum desacordo comercial em relação à sua compra. Por exemplo em um caso onde tenha recebido um produto diferente do que aquele que solicitou. \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":"591445abbb92601b00a4fac9","githubsync":"","isReference":false,"title":"Cancelamento/Estorno (Desfazimento)","updates":[],"childrenPages":[]}

postCancelamento/Estorno (Desfazimento)


O cancelamento é feito a pedido do portador do cartão, na loja em que a compra foi realizada. A solicitação de cancelamento poderá ser solicitada a qualquer momento, mesmo que em dia diferente ao que ocorreu a transação. O período permitido para a realização de um cancelamento depende do EMISSOR. Note que cancelamentos podem ser feitos apenas do valor total da transação e pode ser realizado apenas no estabelecimento onde foi realizada a transação original, pois se considera que o SAK será utilizado para localizar a transação na log ou no host da Stone. É 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 é de 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>", "20-0": "Poi<POI>", "21-0": "Identification<Id>", "22-0": "Identification<Id>", "23-0": "Capabilities", "24-0": "PrintLineWidth<PrtLineWidth>", "25-0": "Transaction<Tx>", "26-0": "TransactionCapture<TxCaptr>", "27-0": "TransactionIdentification<TxId>", "28-0": "TransactionDateTime<TxDtTm>", "29-0": "TransactionReference<TxRef>", "30-0": "TransactionDetails<TxDtls>", "31-0": "Currency<Ccy>", "32-0": "TotalAmount<TtlAmt>", "33-0": "OriginalTransaction<OrgnlTx>", "34-0": "InitiatorTransactionIdentification<InitrTxId>", "35-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", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "0 à 1", "24-1": "0 à 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", "33-1": "1", "34-1": "1", "35-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", "20-4": "Sim", "21-4": "Sim", "22-4": "Sim", "23-4": "Não", "24-4": "Não", "25-4": "Sim", "26-4": "Sim", "27-4": "Sim", "28-4": "Sim", "29-4": "Sim", "30-4": "Sim", "31-4": "Sim", "32-4": "Sim", "33-4": "Sim", "34-4": "Sim", "35-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Container", "20-2": "Container", "21-2": "Container", "7-2": "Text", "23-2": "Container", "22-2": "Text", "24-2": "Text", "25-2": "Container", "26-2": "Bool", "27-2": "Container", "28-2": "DateTime", "29-2": "Text", "30-2": "Container", "31-2": "CodeSet", "32-2": "Amount", "33-2": "Container", "34-2": "Text", "35-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”.", "20-3": "Dados do Ponto de Interação.", "21-3": "Identificação do ponto de interação", "22-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento.", "23-3": "Capacidades do Ponto de interação.", "24-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.", "25-3": "Dados da transação.", "26-3": "Fixo true para requisições de cancelamento.", "27-3": "Identificação da transação atribuída pelo POI (Ponto de interação).", "28-3": "Data e hora local da transação definidas pelo ponto de interação.", "29-3": "Identificação da transação definida pelo ponto de interação. O formato é livre contendo no máximo 32 caracteres.", "30-3": "Detalhes da transação", "31-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "32-3": "Valor total da transação em centavos", "33-3": "Dados da transação original", "34-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n\nTamanho máximo : \n32 caracteres", "35-3": "Identificação da transação definida pelo adquirente.", "14-0": "LocationAndContact <LctnAndCtct>", "14-1": "0 à 1", "14-2": "Text", "14-3": "Dados de PSP", "14-4": "Não", "15-0": "PostalAddress <PstlAdr>", "15-1": "0 à 1", "15-2": "Text", "15-3": "Dados de PSP", "15-4": "Não", "16-0": "PostCode <PstCd>", "16-1": "0 à 1", "16-2": "Text", "16-3": "CEP do submerchant", "16-4": "Não", "17-0": "TownName <TwnNm>", "17-1": "0 à 1", "17-2": "Text", "17-3": "Cidade do submerchant", "17-4": "Não", "18-0": "CountrySubDivision <CtrySubDvsn>", "18-1": "0 à 1", "18-2": "Text", "18-3": "Estado do submerchant", "18-4": "Não", "19-0": "Country<Ctry>", "19-1": "0 à 1", "19-2": "Text", "19-3": "País do submerchant", "19-4": "Não", "8-0": "LocationAndContact <LctnAndCtct>", "9-0": "PostalAddress <PstlAdr>", "10-0": "PostCode <PstCd>", "11-0": "<TwnNm>", "12-0": "<CtrySubDvsn>", "8-1": "[0..1]", "9-1": "[0..1]", "10-1": "[0..1]", "11-1": "[0..1]", "12-1": "[0..1]", "13-1": "[0..1]", "8-2": "-", "9-2": "-", "10-2": "n.. 16", "11-2": "n.. 35", "12-2": "n.. 35", "8-3": "Container", "9-3": "Container", "10-3": "Text", "11-3": "Text", "12-3": "Text", "13-3": "Text", "8-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client TEF) – Apenas para Estorno", "9-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client TEF) – Apenas para Estorno", "10-4": "CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno", "11-4": "Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno", "12-4": "Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno", "13-4": "Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno", "13-2": "an ..2", "13-0": "<Ctry>" }, "cols": 5, "rows": 36 } [/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 haver algum desacordo comercial em relação à sua compra. Por exemplo em um caso onde tenha recebido um produto diferente do que aquele que solicitou. * **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 é feito a pedido do portador do cartão, na loja em que a compra foi realizada. A solicitação de cancelamento poderá ser solicitada a qualquer momento, mesmo que em dia diferente ao que ocorreu a transação. O período permitido para a realização de um cancelamento depende do EMISSOR. Note que cancelamentos podem ser feitos apenas do valor total da transação e pode ser realizado apenas no estabelecimento onde foi realizada a transação original, pois se considera que o SAK será utilizado para localizar a transação na log ou no host da Stone. É 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 é de 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>", "20-0": "Poi<POI>", "21-0": "Identification<Id>", "22-0": "Identification<Id>", "23-0": "Capabilities", "24-0": "PrintLineWidth<PrtLineWidth>", "25-0": "Transaction<Tx>", "26-0": "TransactionCapture<TxCaptr>", "27-0": "TransactionIdentification<TxId>", "28-0": "TransactionDateTime<TxDtTm>", "29-0": "TransactionReference<TxRef>", "30-0": "TransactionDetails<TxDtls>", "31-0": "Currency<Ccy>", "32-0": "TotalAmount<TtlAmt>", "33-0": "OriginalTransaction<OrgnlTx>", "34-0": "InitiatorTransactionIdentification<InitrTxId>", "35-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", "20-1": "1", "21-1": "1", "22-1": "1", "23-1": "0 à 1", "24-1": "0 à 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", "33-1": "1", "34-1": "1", "35-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", "20-4": "Sim", "21-4": "Sim", "22-4": "Sim", "23-4": "Não", "24-4": "Não", "25-4": "Sim", "26-4": "Sim", "27-4": "Sim", "28-4": "Sim", "29-4": "Sim", "30-4": "Sim", "31-4": "Sim", "32-4": "Sim", "33-4": "Sim", "34-4": "Sim", "35-4": "Sim", "0-2": "Container", "1-2": "CodeSet", "2-2": "Text", "3-2": "Container", "4-2": "Container", "5-2": "Container", "6-2": "Container", "20-2": "Container", "21-2": "Container", "7-2": "Text", "23-2": "Container", "22-2": "Text", "24-2": "Text", "25-2": "Container", "26-2": "Bool", "27-2": "Container", "28-2": "DateTime", "29-2": "Text", "30-2": "Container", "31-2": "CodeSet", "32-2": "Amount", "33-2": "Container", "34-2": "Text", "35-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”.", "20-3": "Dados do Ponto de Interação.", "21-3": "Identificação do ponto de interação", "22-3": "Código de identificação do ponto de interação atribuído pelo estabelecimento.", "23-3": "Capacidades do Ponto de interação.", "24-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.", "25-3": "Dados da transação.", "26-3": "Fixo true para requisições de cancelamento.", "27-3": "Identificação da transação atribuída pelo POI (Ponto de interação).", "28-3": "Data e hora local da transação definidas pelo ponto de interação.", "29-3": "Identificação da transação definida pelo ponto de interação. O formato é livre contendo no máximo 32 caracteres.", "30-3": "Detalhes da transação", "31-3": "Moeda utilizada na transação em conformidade com a ISO 4217.", "32-3": "Valor total da transação em centavos", "33-3": "Dados da transação original", "34-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n\nTamanho máximo : \n32 caracteres", "35-3": "Identificação da transação definida pelo adquirente.", "14-0": "LocationAndContact <LctnAndCtct>", "14-1": "0 à 1", "14-2": "Text", "14-3": "Dados de PSP", "14-4": "Não", "15-0": "PostalAddress <PstlAdr>", "15-1": "0 à 1", "15-2": "Text", "15-3": "Dados de PSP", "15-4": "Não", "16-0": "PostCode <PstCd>", "16-1": "0 à 1", "16-2": "Text", "16-3": "CEP do submerchant", "16-4": "Não", "17-0": "TownName <TwnNm>", "17-1": "0 à 1", "17-2": "Text", "17-3": "Cidade do submerchant", "17-4": "Não", "18-0": "CountrySubDivision <CtrySubDvsn>", "18-1": "0 à 1", "18-2": "Text", "18-3": "Estado do submerchant", "18-4": "Não", "19-0": "Country<Ctry>", "19-1": "0 à 1", "19-2": "Text", "19-3": "País do submerchant", "19-4": "Não", "8-0": "LocationAndContact <LctnAndCtct>", "9-0": "PostalAddress <PstlAdr>", "10-0": "PostCode <PstCd>", "11-0": "<TwnNm>", "12-0": "<CtrySubDvsn>", "8-1": "[0..1]", "9-1": "[0..1]", "10-1": "[0..1]", "11-1": "[0..1]", "12-1": "[0..1]", "13-1": "[0..1]", "8-2": "-", "9-2": "-", "10-2": "n.. 16", "11-2": "n.. 35", "12-2": "n.. 35", "8-3": "Container", "9-3": "Container", "10-3": "Text", "11-3": "Text", "12-3": "Text", "13-3": "Text", "8-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client TEF) – Apenas para Estorno", "9-4": "Dados de PSP (Enviado apenas se dados de PSP coletados no client TEF) – Apenas para Estorno", "10-4": "CEP do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno", "11-4": "Cidade do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno", "12-4": "Estado do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno", "13-4": "Pais do submerchant. Deve haver a possibilidade de coleta desta informação no client TEF. Deve ser enviado apenas se coletado. – Apenas para Estorno", "13-2": "an ..2", "13-0": "<Ctry>" }, "cols": 5, "rows": 36 } [/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 haver algum desacordo comercial em relação à sua compra. Por exemplo em um caso onde tenha recebido um produto diferente do que aquele que solicitou. * **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.
{"_id":"591445abbb92601b00a4fad3","slug":"consulta-de-transações-2","parentDoc":null,"project":"583f0fb04828d50f00126d4d","githubsync":"","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\": \"InitiatorTransactionIdentification<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. (ATK)\",\n    \"11-3\": \"Identificação da transação definida pelo sistema que se comunica com o Host Stone.\\n(ITK)\\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    \"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    \"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    \"16-3\": \"Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.\",\n    \"16-2\": \"Text\",\n    \"17-3\": \"Tipo de conta da transação original\\n\\nCRDT : Crédito\\n\\nCHCK : Debito\",\n    \"17-2\": \"CodeSet\",\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\": \"Valor original da transação\\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 os cancelamentos\",\n    \"15-0\": \"CanceledStatus<CancSts>\",\n    \"15-1\": \"1\",\n    \"15-2\": \"CodeSet\",\n    \"15-3\": \"Status do cancelamento\\n\\nFULL : Indica que o valor total da transação foi cancelado.\\n\\nPART : Indica que somente parte do valor capturado foi cancelado.\\n\\nNONE: Indica que a transação não foi cancelada.\"\n  },\n  \"cols\": 4,\n  \"rows\": 34\n}\n[/block]","user":"57ea79f61780cd170064f273","version":"591445aabb92601b00a4fac8","link_url":"","excerpt":"","title":"Consulta de Transações","__v":0,"next":{"pages":[],"description":""},"createdAt":"2016-12-16T15:16:03.249Z","link_external":false,"hidden":false,"api":{"results":{"codes":[{"status":200,"language":"xml","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>EF1CC1A4FECE40EB8B29CA7328955C77</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>1000</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>","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":"/TransactionStatusReport","examples":{"codes":[{"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>EF1CC1A4FECE40EB8B29CA7328955C77</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\t<RcptTxId>11350002663228</RcptTxId>\n\t\t\t</OrgnlTx>\n\t\t</Tx>\n\t\t</TxStsRpt>\n\t</AccptrTxStsRptRq>\n</Document>","language":"xml"}]},"method":"post"},"isReference":false,"order":13,"type":"post","category":"591445abbb92601b00a4fac9","updates":[],"sync_unique":"","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": "InitiatorTransactionIdentification<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. (ATK)", "11-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n(ITK)\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>", "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", "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.", "16-3": "Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.", "16-2": "Text", "17-3": "Tipo de conta da transação original\n\nCRDT : Crédito\n\nCHCK : Debito", "17-2": "CodeSet", "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": "Valor original da transação\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 os cancelamentos", "15-0": "CanceledStatus<CancSts>", "15-1": "1", "15-2": "CodeSet", "15-3": "Status do cancelamento\n\nFULL : Indica que o valor total da transação foi cancelado.\n\nPART : Indica que somente parte do valor capturado foi cancelado.\n\nNONE: Indica que a transação não foi cancelada." }, "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": "InitiatorTransactionIdentification<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. (ATK)", "11-3": "Identificação da transação definida pelo sistema que se comunica com o Host Stone.\n(ITK)\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>", "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", "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.", "16-3": "Moeda utilizada na transação em conformidade com a ISO 4217 - 986 = Real Brasileiro.", "16-2": "Text", "17-3": "Tipo de conta da transação original\n\nCRDT : Crédito\n\nCHCK : Debito", "17-2": "CodeSet", "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": "Valor original da transação\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 os cancelamentos", "15-0": "CanceledStatus<CancSts>", "15-1": "1", "15-2": "CodeSet", "15-3": "Status do cancelamento\n\nFULL : Indica que o valor total da transação foi cancelado.\n\nPART : Indica que somente parte do valor capturado foi cancelado.\n\nNONE: Indica que a transação não foi cancelada." }, "cols": 4, "rows": 34 } [/block]
{"_id":"5943f1556ec7dc002db0f474","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4fac9","user":"58dcf4b604ea0f0f00fbdfcb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-06-16T14:55:17.297Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":14,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"1. Autorização com captura posterior\"\n}\n[/block]\nAmbiente Sandbox\n https://sandbox-auth-integration.stone.com.br/Authorize\n\nRequest\n[block:code]\n{\n  \"codes\": [\n    {\n      \"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>BFDB58AB9A8A48828C2647E18B7F1114</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                <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \\n                <AddtlSvc>RECP</AddtlSvc>\\n                <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\\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>2017-06-01T15: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>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\nResponse\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?>\\n<Document xmlns=\\\"urn:AcceptorAuthorisationResponseV02.1\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\">\\n    <AccptrAuthstnRspn>\\n        <Hdr>\\n            <MsgFctn>AUTP</MsgFctn>\\n            <PrtcolVrsn>2.0</PrtcolVrsn>\\n            <CreDtTm>2017-06-16T11:42:43</CreDtTm>\\n        </Hdr>\\n        <AuthstnRspn>\\n            <Envt>\\n                <MrchntId>\\n                    <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\\n                    <ShrtNm>Nome da fatura</ShrtNm>\\n                </MrchntId>\\n            </Envt>\\n            <Tx>\\n                <TxId>\\n                    <TxDtTm>2017-06-01T15:11:06</TxDtTm>\\n                    <TxRef>06064f516a50483da7f189243c95ccca</TxRef>\\n                </TxId>\\n                <RcptTxId>26770052347033</RcptTxId>\\n                <TxDtls>\\n                    <Ccy>986</Ccy>\\n                    <TtlAmt>100</TtlAmt>\\n                    <AcctTp>CRDT</AcctTp>\\n                </TxDtls>\\n            </Tx>\\n            <TxRspn>\\n                <AuthstnRslt>\\n                    <RspnToAuthstn>\\n                        <Rspn>APPR</Rspn>\\n                        <RspnRsn>0000</RspnRsn>\\n                    </RspnToAuthstn>\\n                    <AuthstnCd>347033</AuthstnCd>\\n                    <CmpltnReqrd>true</CmpltnReqrd>\\n                </AuthstnRslt>\\n                <Actn>\\n                    <ActnTp>DISP</ActnTp>\\n                    <MsgToPres>\\n                        <MsgDstn>MDSP</MsgDstn>\\n                        <MsgCntt>Aprovado</MsgCntt>\\n                    </MsgToPres>\\n                </Actn>\\n            </TxRspn>\\n        </AuthstnRspn>\\n    </AccptrAuthstnRspn>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"2. Autorização com captura imediata\"\n}\n[/block]\nhttps://sandbox-auth-integration.stone.com.br/Authorize\n\nRequisição\n[block:code]\n{\n  \"codes\": [\n    {\n      \"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>BFDB58AB9A8A48828C2647E18B7F1114</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                <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \\n                <AddtlSvc>RECP</AddtlSvc>\\n                <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\\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>true</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>2017-06-01T15: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>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\nResposta\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?>\\n<Document xmlns=\\\"urn:AcceptorAuthorisationResponseV02.1\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\">\\n    <AccptrAuthstnRspn>\\n        <Hdr>\\n            <MsgFctn>AUTP</MsgFctn>\\n            <PrtcolVrsn>2.0</PrtcolVrsn>\\n            <CreDtTm>2017-06-16T11:46:35</CreDtTm>\\n        </Hdr>\\n        <AuthstnRspn>\\n            <Envt>\\n                <MrchntId>\\n                    <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\\n                    <ShrtNm>Nome da fatura</ShrtNm>\\n                </MrchntId>\\n            </Envt>\\n            <Tx>\\n                <TxId>\\n                    <TxDtTm>2017-06-01T15:11:06</TxDtTm>\\n                    <TxRef>06064f516a50483da7f189243c95ccca</TxRef>\\n                </TxId>\\n                <RcptTxId>26770052347037</RcptTxId>\\n                <TxDtls>\\n                    <Ccy>986</Ccy>\\n                    <TtlAmt>100</TtlAmt>\\n                    <AcctTp>CRDT</AcctTp>\\n                </TxDtls>\\n            </Tx>\\n            <TxRspn>\\n                <AuthstnRslt>\\n                    <RspnToAuthstn>\\n                        <Rspn>APPR</Rspn>\\n                        <RspnRsn>0000</RspnRsn>\\n                    </RspnToAuthstn>\\n                    <AuthstnCd>347037</AuthstnCd>\\n                    <CmpltnReqrd>false</CmpltnReqrd>\\n                </AuthstnRslt>\\n                <Actn>\\n                    <ActnTp>DISP</ActnTp>\\n                    <MsgToPres>\\n                        <MsgDstn>MDSP</MsgDstn>\\n                        <MsgCntt>Aprovado</MsgCntt>\\n                    </MsgToPres>\\n                </Actn>\\n            </TxRspn>\\n        </AuthstnRspn>\\n    </AccptrAuthstnRspn>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"3. Cancelamento/Estorno (Desfazimento)\"\n}\n[/block]\nhttps://sandbox-auth-integration.stone.com.br/Cancellation\n\nRequisição\n[block:code]\n{\n  \"codes\": [\n    {\n      \"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>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\nResposta\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?>\\n<Document xmlns=\\\"urn:AcceptorCancellationResponseV02.1\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\">\\n    <AccptrCxlRspn>\\n        <Hdr>\\n            <MsgFctn>CCAP</MsgFctn>\\n            <PrtcolVrsn>2.0</PrtcolVrsn>\\n            <CreDtTm>2017-06-16T11:48:32</CreDtTm>\\n        </Hdr>\\n        <CxlRspn>\\n            <Envt>\\n                <MrchntId>\\n                    <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\\n                </MrchntId>\\n            </Envt>\\n            <TxRspn>\\n                <AuthstnRslt>\\n                    <RspnToAuthstn>\\n                        <Rspn>DECL</Rspn>\\n                        <RspnRsn>9114</RspnRsn>\\n                    </RspnToAuthstn>\\n                    <CmpltnReqrd>false</CmpltnReqrd>\\n                </AuthstnRslt>\\n            </TxRspn>\\n            <Tx>\\n                <TxId>\\n                    <TxDtTm>2014-03-12T15:09:00</TxDtTm>\\n                    <TxRef>12345ABC</TxRef>\\n                </TxId>\\n                <RcptTxId>00000034071000000215346</RcptTxId>\\n                <TxDtls>\\n                    <Ccy>986</Ccy>\\n                    <TtlAmt>100</TtlAmt>\\n                </TxDtls>\\n            </Tx>\\n        </CxlRspn>\\n    </AccptrCxlRspn>\\n</Document>\",\n      \"language\": \"text\",\n      \"name\": \"Aprovado\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?>\\n<Document xmlns=\\\"urn:AcceptorCancellationResponseV02.1\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\">\\n    <AccptrCxlRspn>\\n        <Hdr>\\n            <MsgFctn>CCAP</MsgFctn>\\n            <PrtcolVrsn>2.0</PrtcolVrsn>\\n            <CreDtTm>2017-10-04T15:57:40</CreDtTm>\\n        </Hdr>\\n        <CxlRspn>\\n            <Envt>\\n                <MrchntId>\\n                    <Id>XPTO</Id>\\n                </MrchntId>\\n            </Envt>\\n            <TxRspn>\\n                <AuthstnRslt>\\n                    <RspnToAuthstn>\\n                        <Rspn>DECL</Rspn>\\n                        <RspnRsn>9114</RspnRsn>\\n                    </RspnToAuthstn>\\n                    <CmpltnReqrd>false</CmpltnReqrd>\\n                </AuthstnRslt>\\n            </TxRspn>\\n            <Tx>\\n                <TxId>\\n                    <TxDtTm>2014-03-12T15:09:00</TxDtTm>\\n                    <TxRef>XPTO</TxRef>\\n                </TxId>\\n                <RcptTxId>XPTO</RcptTxId>\\n                <TxDtls>\\n                    <Ccy>986</Ccy>\\n                    <TtlAmt>100</TtlAmt>\\n                </TxDtls>\\n            </Tx>\\n        </CxlRspn>\\n    </AccptrCxlRspn>\\n</Document>\",\n      \"language\": \"text\",\n      \"name\": \"Negado\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"4. Consulta\"\n}\n[/block]\nhttps://sandbox-auth-integration.stone.com.br/TransactionStatusReport\n\nRequisição\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Document xmlns=\\\"urn:AcceptorTransactionStatusReportRequestV02.1\\\">\\n  <AccptrTxStsRptRq>\\n      <Hdr>\\n        <MsgFctn>TSRR</MsgFctn>\\n        <PrtcolVrsn>2.0</PrtcolVrsn>\\n        <InitgPty>\\n          <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\\n        </InitgPty>\\n    </Hdr>\\n    <TxStsRpt>\\n      <Tx>\\n        <TxRpt>OPRS</TxRpt>\\n        <TxRpt>SUMM</TxRpt>\\n      <OrgnlTx>\\n        <InitrTxId>2a42327648f644f4</InitrTxId>\\n        <RcptTxId>11350002663228</RcptTxId>\\n      </OrgnlTx>\\n    </Tx>\\n    </TxStsRpt>\\n  </AccptrTxStsRptRq>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\nResposta\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?>\\n<Document xmlns=\\\"urn:AcceptorTransactionStatusReportResponseV02.1\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\">\\n    <AccptrTxStsRptRspn>\\n        <Hdr>\\n            <MsgFctn>TSRP</MsgFctn>\\n            <PrtcolVrsn>2.0</PrtcolVrsn>\\n            <CreDtTm>2017-06-16T11:51:22</CreDtTm>\\n            <InitgPty>\\n                <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\\n            </InitgPty>\\n        </Hdr>\\n        <TxStsRptRspn/>\\n    </AccptrTxStsRptRspn>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"SAK não identificado pelo autorizador Stone\"\n}\n[/block]\nRequisição\n[block:code]\n{\n  \"codes\": [\n    {\n      \"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>XTPO</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>XTPO</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>XTPO</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                <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \\n                <AddtlSvc>RECP</AddtlSvc>\\n                <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\\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>2017-06-01T15: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>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\nResposta \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?>\\n<Document xmlns=\\\"urn:AcceptorRejectionV02.1\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\">\\n    <AccptrRjctn>\\n        <Hdr>\\n            <MsgFctn>RJCT</MsgFctn>\\n            <PrtcolVrsn>2.0</PrtcolVrsn>\\n            <CreDtTm>2017-10-04T15:08:21</CreDtTm>\\n        </Hdr>\\n        <Rjct>\\n            <RjctRsn>INTP</RjctRsn>\\n            <AddtlInf>Invalid identification data for the sender.</AddtlInf>\\n            <MsgInErr/>\\n        </Rjct>\\n    </AccptrRjctn>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Número de Parcelas maior que 1, porém com TAG InstlmtTp igual a NONE\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"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>XPTO</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>XPTO</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>XPTO</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                <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \\n                <AddtlSvc>RECP</AddtlSvc>\\n                <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\\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>2017-06-01T15: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>2</TtlNbOfPmts>\\n                    </RcrngTx>\\n                </TxDtls>\\n            </Tx>\\n        </AuthstnReq>\\n    </AccptrAuthstnReq>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Cartão Inválido\"\n}\n[/block]\nRequisição\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Document xmlns=\\\"urn:AcceptorAuthorisationRequestV02.1\\\">\\n\\t<AccptrAuthstnReq>\\n\\t\\t<Hdr>\\n\\t\\t\\t<MsgFctn>AUTQ</MsgFctn>\\n\\t\\t\\t<PrtcolVrsn>2.0</PrtcolVrsn>\\n\\t\\t</Hdr>\\n\\t\\t<AuthstnReq>\\n\\t\\t\\t<Envt>\\n\\t\\t\\t\\t<Mrchnt>\\n\\t\\t\\t\\t\\t<Id>\\n\\t\\t\\t\\t\\t\\t<Id>XPTO</Id>\\n\\t\\t\\t\\t\\t</Id>\\n\\t\\t\\t\\t</Mrchnt>\\n\\t\\t\\t\\t<POI>\\n\\t\\t\\t\\t\\t<Id>\\n\\t\\t\\t\\t\\t\\t<Id>CHECKOUT1</Id>\\n\\t\\t\\t\\t\\t</Id>\\n\\t\\t\\t\\t\\t<SysNm>SOFTWAREHOUSE</SysNm>\\n\\t\\t\\t\\t\\t<Cmpnt>\\n\\t\\t\\t\\t\\t\\t<Tp>TERM</Tp>\\n\\t\\t\\t\\t\\t\\t<Id>\\n\\t\\t\\t\\t\\t\\t\\t<PrvdrId>FABRICANTE</PrvdrId>\\n\\t\\t\\t\\t\\t\\t\\t<Id>MODELO</Id>\\n\\t\\t\\t\\t\\t\\t\\t<SrlNb>XPTO</SrlNb>\\n\\t\\t\\t\\t\\t\\t</Id>\\n\\t\\t\\t\\t\\t\\t<Sts>\\n\\t\\t\\t\\t\\t\\t\\t<VrsnNb>XPTO</VrsnNb>\\n\\t\\t\\t\\t\\t\\t</Sts>\\n\\t\\t\\t\\t\\t</Cmpnt>\\n\\t\\t\\t\\t\\t<Cpblties>\\n\\t\\t\\t\\t\\t\\t<PrtLineWidth>39</PrtLineWidth>\\n\\t\\t\\t\\t\\t</Cpblties>\\n\\t\\t\\t\\t</POI>\\n\\t\\t\\t\\t<Card>\\n\\t\\t\\t\\t\\t<PlainCardData>\\n\\t\\t\\t\\t\\t\\t<PAN>5612000269966</PAN>\\n\\t\\t\\t\\t\\t\\t<XpryDt>2050-12</XpryDt>\\n\\t\\t\\t\\t\\t\\t<CardSctyCd>\\n\\t\\t\\t\\t\\t\\t\\t<CSCVal>111</CSCVal>\\n\\t\\t\\t\\t\\t\\t</CardSctyCd>\\n\\t\\t\\t\\t\\t</PlainCardData>\\n\\t\\t\\t\\t</Card>\\n\\t\\t\\t\\t<Crdhldr>\\n\\t\\t\\t\\t\\t<Nm>XPTO</Nm>\\n\\t\\t\\t\\t\\t<Authntcn>\\n\\t\\t\\t\\t\\t\\t<AuthntcnMtd>PPSG</AuthntcnMtd>\\n\\t\\t\\t\\t\\t</Authntcn>\\n\\t\\t\\t\\t</Crdhldr>\\n\\t\\t\\t</Envt>\\n\\t\\t\\t<Cntxt>\\n\\t\\t\\t\\t<PmtCntxt>\\n\\t\\t\\t\\t\\t<CardDataNtryMd>PHYS</CardDataNtryMd>\\n\\t\\t\\t\\t\\t<FllbckInd>false</FllbckInd>\\n\\t\\t\\t\\t\\t<TxChanl>ECOM</TxChanl>\\n\\t\\t\\t\\t</PmtCntxt>\\n\\t\\t\\t</Cntxt>\\n\\t\\t\\t<Tx>\\n\\t\\t\\t\\t<InitrTxId>00000124112016103201</InitrTxId>\\n\\t\\t\\t\\t<TxCaptr>true</TxCaptr>\\n\\t\\t\\t\\t<TxId>\\n\\t\\t\\t\\t\\t<TxDtTm>2016-11-24T10:32:01</TxDtTm>\\n\\t\\t\\t\\t\\t<TxRef>0123456</TxRef>\\n\\t\\t\\t\\t</TxId>\\n\\t\\t\\t\\t<TxDtls>\\n\\t\\t\\t\\t\\t<Ccy>986</Ccy>\\n\\t\\t\\t\\t\\t<TtlAmt>100</TtlAmt>\\n\\t\\t\\t\\t\\t<AcctTp>CRDT</AcctTp>\\n\\t\\t\\t\\t\\t<RcrngTx>\\n\\t\\t\\t\\t\\t\\t<InstlmtTp>ISSR</InstlmtTp>\\n\\t\\t\\t\\t\\t\\t<TtlNbOfPmts>5</TtlNbOfPmts>\\n\\t\\t\\t\\t\\t</RcrngTx>\\n\\t\\t\\t\\t</TxDtls>\\n\\t\\t\\t</Tx>\\n\\t\\t</AuthstnReq>\\n\\t</AccptrAuthstnReq>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\nResposta \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Document xmlns=\\\"urn:AcceptorAuthorisationResponseV02.1\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\">\\n    <AccptrAuthstnRspn>\\n        <Hdr>\\n            <MsgFctn>AUTP</MsgFctn>\\n            <PrtcolVrsn>2.0</PrtcolVrsn>\\n            <CreDtTm>2017-10-04T15:31:58</CreDtTm>\\n        </Hdr>\\n        <AuthstnRspn>\\n            <Envt>\\n                <MrchntId>\\n                    <Id>XPTO</Id>\\n                </MrchntId>\\n            </Envt>\\n            <Tx>\\n                <TxId>\\n                    <TxDtTm>2016-11-24T10:32:01</TxDtTm>\\n                    <TxRef>0123456</TxRef>\\n                </TxId>\\n                <RcptTxId>XPTO</RcptTxId>\\n                <TxDtls>\\n                    <Ccy>986</Ccy>\\n                    <TtlAmt>0</TtlAmt>\\n                    <AcctTp>CRDT</AcctTp>\\n                </TxDtls>\\n            </Tx>\\n            <TxRspn>\\n                <AuthstnRslt>\\n                    <RspnToAuthstn>\\n                        <Rspn>DECL</Rspn>\\n                        <RspnRsn>1011</RspnRsn>\\n                    </RspnToAuthstn>\\n                    <AuthstnCd/>\\n                    <CmpltnReqrd>false</CmpltnReqrd>\\n                </AuthstnRslt>\\n                <Actn>\\n                    <ActnTp>DISP</ActnTp>\\n                    <MsgToPres>\\n                        <MsgDstn>MDSP</MsgDstn>\\n                        <MsgCntt>Cartão inválido</MsgCntt>\\n                    </MsgToPres>\\n                </Actn>\\n            </TxRspn>\\n        </AuthstnRspn>\\n    </AccptrAuthstnRspn>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Resposta de Rejeição\"\n}\n[/block]\nMensagem Invalida – A mensagem enviada possui um formato inválido.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Document xmlns=\\\"urn:AcceptorRejectionV02.1\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\">\\n\\t<AccptrRjctn>\\n\\t\\t<Hdr>\\n\\t\\t\\t<MsgFctn>RJCT</MsgFctn>\\n\\t\\t\\t<PrtcolVrsn>2.0</PrtcolVrsn>\\n\\t\\t\\t<CreDtTm>2016-11-28T10:11:23</CreDtTm>\\n\\t\\t</Hdr>\\n\\t\\t<Rjct>\\n\\t\\t\\t<RjctRsn>IMSG</RjctRsn>\\n\\t\\t\\t<AddtlInf> Identification - GenericIdentification Id can not be null</AddtlInf>\\n\\t\\t\\t<MsgInErr/>\\n\\t\\t</Rjct>\\n\\t</AccptrRjctn>\\n</Document>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"Inclusive com cenários de erro.","slug":"exemplos-de-mensagens","type":"basic","title":"Exemplos de mensageiria - Requisição e Resposta","__v":0,"parentDoc":null,"childrenPages":[]}

Exemplos de mensageiria - Requisição e Resposta

Inclusive com cenários de erro.

[block:api-header] { "type": "basic", "title": "1. Autorização com captura posterior" } [/block] Ambiente Sandbox https://sandbox-auth-integration.stone.com.br/Authorize Request [block:code] { "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>BFDB58AB9A8A48828C2647E18B7F1114</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 <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n <AddtlSvc>RECP</AddtlSvc>\n <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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>2017-06-01T15: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" } ] } [/block] Response [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorAuthorisationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrAuthstnRspn>\n <Hdr>\n <MsgFctn>AUTP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-06-16T11:42:43</CreDtTm>\n </Hdr>\n <AuthstnRspn>\n <Envt>\n <MrchntId>\n <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\n <ShrtNm>Nome da fatura</ShrtNm>\n </MrchntId>\n </Envt>\n <Tx>\n <TxId>\n <TxDtTm>2017-06-01T15:11:06</TxDtTm>\n <TxRef>06064f516a50483da7f189243c95ccca</TxRef>\n </TxId>\n <RcptTxId>26770052347033</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>100</TtlAmt>\n <AcctTp>CRDT</AcctTp>\n </TxDtls>\n </Tx>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>APPR</Rspn>\n <RspnRsn>0000</RspnRsn>\n </RspnToAuthstn>\n <AuthstnCd>347033</AuthstnCd>\n <CmpltnReqrd>true</CmpltnReqrd>\n </AuthstnRslt>\n <Actn>\n <ActnTp>DISP</ActnTp>\n <MsgToPres>\n <MsgDstn>MDSP</MsgDstn>\n <MsgCntt>Aprovado</MsgCntt>\n </MsgToPres>\n </Actn>\n </TxRspn>\n </AuthstnRspn>\n </AccptrAuthstnRspn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "2. Autorização com captura imediata" } [/block] https://sandbox-auth-integration.stone.com.br/Authorize Requisição [block:code] { "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>BFDB58AB9A8A48828C2647E18B7F1114</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 <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n <AddtlSvc>RECP</AddtlSvc>\n <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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>true</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>2017-06-01T15: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" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorAuthorisationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrAuthstnRspn>\n <Hdr>\n <MsgFctn>AUTP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-06-16T11:46:35</CreDtTm>\n </Hdr>\n <AuthstnRspn>\n <Envt>\n <MrchntId>\n <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\n <ShrtNm>Nome da fatura</ShrtNm>\n </MrchntId>\n </Envt>\n <Tx>\n <TxId>\n <TxDtTm>2017-06-01T15:11:06</TxDtTm>\n <TxRef>06064f516a50483da7f189243c95ccca</TxRef>\n </TxId>\n <RcptTxId>26770052347037</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>100</TtlAmt>\n <AcctTp>CRDT</AcctTp>\n </TxDtls>\n </Tx>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>APPR</Rspn>\n <RspnRsn>0000</RspnRsn>\n </RspnToAuthstn>\n <AuthstnCd>347037</AuthstnCd>\n <CmpltnReqrd>false</CmpltnReqrd>\n </AuthstnRslt>\n <Actn>\n <ActnTp>DISP</ActnTp>\n <MsgToPres>\n <MsgDstn>MDSP</MsgDstn>\n <MsgCntt>Aprovado</MsgCntt>\n </MsgToPres>\n </Actn>\n </TxRspn>\n </AuthstnRspn>\n </AccptrAuthstnRspn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "3. Cancelamento/Estorno (Desfazimento)" } [/block] https://sandbox-auth-integration.stone.com.br/Cancellation Requisição [block:code] { "codes": [ { "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>", "language": "xml" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorCancellationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrCxlRspn>\n <Hdr>\n <MsgFctn>CCAP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-06-16T11:48:32</CreDtTm>\n </Hdr>\n <CxlRspn>\n <Envt>\n <MrchntId>\n <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n </MrchntId>\n </Envt>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>DECL</Rspn>\n <RspnRsn>9114</RspnRsn>\n </RspnToAuthstn>\n <CmpltnReqrd>false</CmpltnReqrd>\n </AuthstnRslt>\n </TxRspn>\n <Tx>\n <TxId>\n <TxDtTm>2014-03-12T15:09:00</TxDtTm>\n <TxRef>12345ABC</TxRef>\n </TxId>\n <RcptTxId>00000034071000000215346</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>100</TtlAmt>\n </TxDtls>\n </Tx>\n </CxlRspn>\n </AccptrCxlRspn>\n</Document>", "language": "text", "name": "Aprovado" }, { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorCancellationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrCxlRspn>\n <Hdr>\n <MsgFctn>CCAP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-10-04T15:57:40</CreDtTm>\n </Hdr>\n <CxlRspn>\n <Envt>\n <MrchntId>\n <Id>XPTO</Id>\n </MrchntId>\n </Envt>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>DECL</Rspn>\n <RspnRsn>9114</RspnRsn>\n </RspnToAuthstn>\n <CmpltnReqrd>false</CmpltnReqrd>\n </AuthstnRslt>\n </TxRspn>\n <Tx>\n <TxId>\n <TxDtTm>2014-03-12T15:09:00</TxDtTm>\n <TxRef>XPTO</TxRef>\n </TxId>\n <RcptTxId>XPTO</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>100</TtlAmt>\n </TxDtls>\n </Tx>\n </CxlRspn>\n </AccptrCxlRspn>\n</Document>", "language": "text", "name": "Negado" } ] } [/block] [block:api-header] { "title": "4. Consulta" } [/block] https://sandbox-auth-integration.stone.com.br/TransactionStatusReport Requisição [block:code] { "codes": [ { "code": "<Document xmlns=\"urn:AcceptorTransactionStatusReportRequestV02.1\">\n <AccptrTxStsRptRq>\n <Hdr>\n <MsgFctn>TSRR</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <InitgPty>\n <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n </InitgPty>\n </Hdr>\n <TxStsRpt>\n <Tx>\n <TxRpt>OPRS</TxRpt>\n <TxRpt>SUMM</TxRpt>\n <OrgnlTx>\n <InitrTxId>2a42327648f644f4</InitrTxId>\n <RcptTxId>11350002663228</RcptTxId>\n </OrgnlTx>\n </Tx>\n </TxStsRpt>\n </AccptrTxStsRptRq>\n</Document>", "language": "xml" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorTransactionStatusReportResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrTxStsRptRspn>\n <Hdr>\n <MsgFctn>TSRP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-06-16T11:51:22</CreDtTm>\n <InitgPty>\n <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n </InitgPty>\n </Hdr>\n <TxStsRptRspn/>\n </AccptrTxStsRptRspn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "SAK não identificado pelo autorizador Stone" } [/block] Requisição [block:code] { "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>XTPO</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>XTPO</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>XTPO</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 <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n <AddtlSvc>RECP</AddtlSvc>\n <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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>2017-06-01T15: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" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorRejectionV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrRjctn>\n <Hdr>\n <MsgFctn>RJCT</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-10-04T15:08:21</CreDtTm>\n </Hdr>\n <Rjct>\n <RjctRsn>INTP</RjctRsn>\n <AddtlInf>Invalid identification data for the sender.</AddtlInf>\n <MsgInErr/>\n </Rjct>\n </AccptrRjctn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "Número de Parcelas maior que 1, porém com TAG InstlmtTp igual a NONE" } [/block] [block:code] { "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>XPTO</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>XPTO</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>XPTO</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 <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n <AddtlSvc>RECP</AddtlSvc>\n <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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>2017-06-01T15: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>2</TtlNbOfPmts>\n </RcrngTx>\n </TxDtls>\n </Tx>\n </AuthstnReq>\n </AccptrAuthstnReq>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "Cartão Inválido" } [/block] Requisição [block:code] { "codes": [ { "code": "<Document xmlns=\"urn:AcceptorAuthorisationRequestV02.1\">\n\t<AccptrAuthstnReq>\n\t\t<Hdr>\n\t\t\t<MsgFctn>AUTQ</MsgFctn>\n\t\t\t<PrtcolVrsn>2.0</PrtcolVrsn>\n\t\t</Hdr>\n\t\t<AuthstnReq>\n\t\t\t<Envt>\n\t\t\t\t<Mrchnt>\n\t\t\t\t\t<Id>\n\t\t\t\t\t\t<Id>XPTO</Id>\n\t\t\t\t\t</Id>\n\t\t\t\t</Mrchnt>\n\t\t\t\t<POI>\n\t\t\t\t\t<Id>\n\t\t\t\t\t\t<Id>CHECKOUT1</Id>\n\t\t\t\t\t</Id>\n\t\t\t\t\t<SysNm>SOFTWAREHOUSE</SysNm>\n\t\t\t\t\t<Cmpnt>\n\t\t\t\t\t\t<Tp>TERM</Tp>\n\t\t\t\t\t\t<Id>\n\t\t\t\t\t\t\t<PrvdrId>FABRICANTE</PrvdrId>\n\t\t\t\t\t\t\t<Id>MODELO</Id>\n\t\t\t\t\t\t\t<SrlNb>XPTO</SrlNb>\n\t\t\t\t\t\t</Id>\n\t\t\t\t\t\t<Sts>\n\t\t\t\t\t\t\t<VrsnNb>XPTO</VrsnNb>\n\t\t\t\t\t\t</Sts>\n\t\t\t\t\t</Cmpnt>\n\t\t\t\t\t<Cpblties>\n\t\t\t\t\t\t<PrtLineWidth>39</PrtLineWidth>\n\t\t\t\t\t</Cpblties>\n\t\t\t\t</POI>\n\t\t\t\t<Card>\n\t\t\t\t\t<PlainCardData>\n\t\t\t\t\t\t<PAN>5612000269966</PAN>\n\t\t\t\t\t\t<XpryDt>2050-12</XpryDt>\n\t\t\t\t\t\t<CardSctyCd>\n\t\t\t\t\t\t\t<CSCVal>111</CSCVal>\n\t\t\t\t\t\t</CardSctyCd>\n\t\t\t\t\t</PlainCardData>\n\t\t\t\t</Card>\n\t\t\t\t<Crdhldr>\n\t\t\t\t\t<Nm>XPTO</Nm>\n\t\t\t\t\t<Authntcn>\n\t\t\t\t\t\t<AuthntcnMtd>PPSG</AuthntcnMtd>\n\t\t\t\t\t</Authntcn>\n\t\t\t\t</Crdhldr>\n\t\t\t</Envt>\n\t\t\t<Cntxt>\n\t\t\t\t<PmtCntxt>\n\t\t\t\t\t<CardDataNtryMd>PHYS</CardDataNtryMd>\n\t\t\t\t\t<FllbckInd>false</FllbckInd>\n\t\t\t\t\t<TxChanl>ECOM</TxChanl>\n\t\t\t\t</PmtCntxt>\n\t\t\t</Cntxt>\n\t\t\t<Tx>\n\t\t\t\t<InitrTxId>00000124112016103201</InitrTxId>\n\t\t\t\t<TxCaptr>true</TxCaptr>\n\t\t\t\t<TxId>\n\t\t\t\t\t<TxDtTm>2016-11-24T10:32:01</TxDtTm>\n\t\t\t\t\t<TxRef>0123456</TxRef>\n\t\t\t\t</TxId>\n\t\t\t\t<TxDtls>\n\t\t\t\t\t<Ccy>986</Ccy>\n\t\t\t\t\t<TtlAmt>100</TtlAmt>\n\t\t\t\t\t<AcctTp>CRDT</AcctTp>\n\t\t\t\t\t<RcrngTx>\n\t\t\t\t\t\t<InstlmtTp>ISSR</InstlmtTp>\n\t\t\t\t\t\t<TtlNbOfPmts>5</TtlNbOfPmts>\n\t\t\t\t\t</RcrngTx>\n\t\t\t\t</TxDtls>\n\t\t\t</Tx>\n\t\t</AuthstnReq>\n\t</AccptrAuthstnReq>\n</Document>", "language": "xml" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<Document xmlns=\"urn:AcceptorAuthorisationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrAuthstnRspn>\n <Hdr>\n <MsgFctn>AUTP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-10-04T15:31:58</CreDtTm>\n </Hdr>\n <AuthstnRspn>\n <Envt>\n <MrchntId>\n <Id>XPTO</Id>\n </MrchntId>\n </Envt>\n <Tx>\n <TxId>\n <TxDtTm>2016-11-24T10:32:01</TxDtTm>\n <TxRef>0123456</TxRef>\n </TxId>\n <RcptTxId>XPTO</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>0</TtlAmt>\n <AcctTp>CRDT</AcctTp>\n </TxDtls>\n </Tx>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>DECL</Rspn>\n <RspnRsn>1011</RspnRsn>\n </RspnToAuthstn>\n <AuthstnCd/>\n <CmpltnReqrd>false</CmpltnReqrd>\n </AuthstnRslt>\n <Actn>\n <ActnTp>DISP</ActnTp>\n <MsgToPres>\n <MsgDstn>MDSP</MsgDstn>\n <MsgCntt>Cartão inválido</MsgCntt>\n </MsgToPres>\n </Actn>\n </TxRspn>\n </AuthstnRspn>\n </AccptrAuthstnRspn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "Resposta de Rejeição" } [/block] Mensagem Invalida – A mensagem enviada possui um formato inválido. [block:code] { "codes": [ { "code": "<Document xmlns=\"urn:AcceptorRejectionV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n\t<AccptrRjctn>\n\t\t<Hdr>\n\t\t\t<MsgFctn>RJCT</MsgFctn>\n\t\t\t<PrtcolVrsn>2.0</PrtcolVrsn>\n\t\t\t<CreDtTm>2016-11-28T10:11:23</CreDtTm>\n\t\t</Hdr>\n\t\t<Rjct>\n\t\t\t<RjctRsn>IMSG</RjctRsn>\n\t\t\t<AddtlInf> Identification - GenericIdentification Id can not be null</AddtlInf>\n\t\t\t<MsgInErr/>\n\t\t</Rjct>\n\t</AccptrRjctn>\n</Document>", "language": "xml" } ] } [/block]
[block:api-header] { "type": "basic", "title": "1. Autorização com captura posterior" } [/block] Ambiente Sandbox https://sandbox-auth-integration.stone.com.br/Authorize Request [block:code] { "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>BFDB58AB9A8A48828C2647E18B7F1114</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 <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n <AddtlSvc>RECP</AddtlSvc>\n <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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>2017-06-01T15: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" } ] } [/block] Response [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorAuthorisationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrAuthstnRspn>\n <Hdr>\n <MsgFctn>AUTP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-06-16T11:42:43</CreDtTm>\n </Hdr>\n <AuthstnRspn>\n <Envt>\n <MrchntId>\n <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\n <ShrtNm>Nome da fatura</ShrtNm>\n </MrchntId>\n </Envt>\n <Tx>\n <TxId>\n <TxDtTm>2017-06-01T15:11:06</TxDtTm>\n <TxRef>06064f516a50483da7f189243c95ccca</TxRef>\n </TxId>\n <RcptTxId>26770052347033</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>100</TtlAmt>\n <AcctTp>CRDT</AcctTp>\n </TxDtls>\n </Tx>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>APPR</Rspn>\n <RspnRsn>0000</RspnRsn>\n </RspnToAuthstn>\n <AuthstnCd>347033</AuthstnCd>\n <CmpltnReqrd>true</CmpltnReqrd>\n </AuthstnRslt>\n <Actn>\n <ActnTp>DISP</ActnTp>\n <MsgToPres>\n <MsgDstn>MDSP</MsgDstn>\n <MsgCntt>Aprovado</MsgCntt>\n </MsgToPres>\n </Actn>\n </TxRspn>\n </AuthstnRspn>\n </AccptrAuthstnRspn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "2. Autorização com captura imediata" } [/block] https://sandbox-auth-integration.stone.com.br/Authorize Requisição [block:code] { "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>BFDB58AB9A8A48828C2647E18B7F1114</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 <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n <AddtlSvc>RECP</AddtlSvc>\n <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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>true</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>2017-06-01T15: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" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorAuthorisationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrAuthstnRspn>\n <Hdr>\n <MsgFctn>AUTP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-06-16T11:46:35</CreDtTm>\n </Hdr>\n <AuthstnRspn>\n <Envt>\n <MrchntId>\n <Id>BFDB58AB9A8A48828C2647E18B7F1114</Id>\n <ShrtNm>Nome da fatura</ShrtNm>\n </MrchntId>\n </Envt>\n <Tx>\n <TxId>\n <TxDtTm>2017-06-01T15:11:06</TxDtTm>\n <TxRef>06064f516a50483da7f189243c95ccca</TxRef>\n </TxId>\n <RcptTxId>26770052347037</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>100</TtlAmt>\n <AcctTp>CRDT</AcctTp>\n </TxDtls>\n </Tx>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>APPR</Rspn>\n <RspnRsn>0000</RspnRsn>\n </RspnToAuthstn>\n <AuthstnCd>347037</AuthstnCd>\n <CmpltnReqrd>false</CmpltnReqrd>\n </AuthstnRslt>\n <Actn>\n <ActnTp>DISP</ActnTp>\n <MsgToPres>\n <MsgDstn>MDSP</MsgDstn>\n <MsgCntt>Aprovado</MsgCntt>\n </MsgToPres>\n </Actn>\n </TxRspn>\n </AuthstnRspn>\n </AccptrAuthstnRspn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "3. Cancelamento/Estorno (Desfazimento)" } [/block] https://sandbox-auth-integration.stone.com.br/Cancellation Requisição [block:code] { "codes": [ { "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>", "language": "xml" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorCancellationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrCxlRspn>\n <Hdr>\n <MsgFctn>CCAP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-06-16T11:48:32</CreDtTm>\n </Hdr>\n <CxlRspn>\n <Envt>\n <MrchntId>\n <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n </MrchntId>\n </Envt>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>DECL</Rspn>\n <RspnRsn>9114</RspnRsn>\n </RspnToAuthstn>\n <CmpltnReqrd>false</CmpltnReqrd>\n </AuthstnRslt>\n </TxRspn>\n <Tx>\n <TxId>\n <TxDtTm>2014-03-12T15:09:00</TxDtTm>\n <TxRef>12345ABC</TxRef>\n </TxId>\n <RcptTxId>00000034071000000215346</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>100</TtlAmt>\n </TxDtls>\n </Tx>\n </CxlRspn>\n </AccptrCxlRspn>\n</Document>", "language": "text", "name": "Aprovado" }, { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorCancellationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrCxlRspn>\n <Hdr>\n <MsgFctn>CCAP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-10-04T15:57:40</CreDtTm>\n </Hdr>\n <CxlRspn>\n <Envt>\n <MrchntId>\n <Id>XPTO</Id>\n </MrchntId>\n </Envt>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>DECL</Rspn>\n <RspnRsn>9114</RspnRsn>\n </RspnToAuthstn>\n <CmpltnReqrd>false</CmpltnReqrd>\n </AuthstnRslt>\n </TxRspn>\n <Tx>\n <TxId>\n <TxDtTm>2014-03-12T15:09:00</TxDtTm>\n <TxRef>XPTO</TxRef>\n </TxId>\n <RcptTxId>XPTO</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>100</TtlAmt>\n </TxDtls>\n </Tx>\n </CxlRspn>\n </AccptrCxlRspn>\n</Document>", "language": "text", "name": "Negado" } ] } [/block] [block:api-header] { "title": "4. Consulta" } [/block] https://sandbox-auth-integration.stone.com.br/TransactionStatusReport Requisição [block:code] { "codes": [ { "code": "<Document xmlns=\"urn:AcceptorTransactionStatusReportRequestV02.1\">\n <AccptrTxStsRptRq>\n <Hdr>\n <MsgFctn>TSRR</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <InitgPty>\n <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n </InitgPty>\n </Hdr>\n <TxStsRpt>\n <Tx>\n <TxRpt>OPRS</TxRpt>\n <TxRpt>SUMM</TxRpt>\n <OrgnlTx>\n <InitrTxId>2a42327648f644f4</InitrTxId>\n <RcptTxId>11350002663228</RcptTxId>\n </OrgnlTx>\n </Tx>\n </TxStsRpt>\n </AccptrTxStsRptRq>\n</Document>", "language": "xml" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorTransactionStatusReportResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrTxStsRptRspn>\n <Hdr>\n <MsgFctn>TSRP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-06-16T11:51:22</CreDtTm>\n <InitgPty>\n <Id>EF1CC1A4FECE40EB8B29CA7328955C88</Id>\n </InitgPty>\n </Hdr>\n <TxStsRptRspn/>\n </AccptrTxStsRptRspn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "SAK não identificado pelo autorizador Stone" } [/block] Requisição [block:code] { "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>XTPO</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>XTPO</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>XTPO</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 <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n <AddtlSvc>RECP</AddtlSvc>\n <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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>2017-06-01T15: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" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Document xmlns=\"urn:AcceptorRejectionV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrRjctn>\n <Hdr>\n <MsgFctn>RJCT</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-10-04T15:08:21</CreDtTm>\n </Hdr>\n <Rjct>\n <RjctRsn>INTP</RjctRsn>\n <AddtlInf>Invalid identification data for the sender.</AddtlInf>\n <MsgInErr/>\n </Rjct>\n </AccptrRjctn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "Número de Parcelas maior que 1, porém com TAG InstlmtTp igual a NONE" } [/block] [block:code] { "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>XPTO</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>XPTO</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>XPTO</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 <!--- Dados de identificação da transação de recorrência (OPCIONAL) --> \n <AddtlSvc>RECP</AddtlSvc>\n <SvcAttr>FREC</SvcAttr> <!--- RREC para as transações seguintes -->\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>2017-06-01T15: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>2</TtlNbOfPmts>\n </RcrngTx>\n </TxDtls>\n </Tx>\n </AuthstnReq>\n </AccptrAuthstnReq>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "Cartão Inválido" } [/block] Requisição [block:code] { "codes": [ { "code": "<Document xmlns=\"urn:AcceptorAuthorisationRequestV02.1\">\n\t<AccptrAuthstnReq>\n\t\t<Hdr>\n\t\t\t<MsgFctn>AUTQ</MsgFctn>\n\t\t\t<PrtcolVrsn>2.0</PrtcolVrsn>\n\t\t</Hdr>\n\t\t<AuthstnReq>\n\t\t\t<Envt>\n\t\t\t\t<Mrchnt>\n\t\t\t\t\t<Id>\n\t\t\t\t\t\t<Id>XPTO</Id>\n\t\t\t\t\t</Id>\n\t\t\t\t</Mrchnt>\n\t\t\t\t<POI>\n\t\t\t\t\t<Id>\n\t\t\t\t\t\t<Id>CHECKOUT1</Id>\n\t\t\t\t\t</Id>\n\t\t\t\t\t<SysNm>SOFTWAREHOUSE</SysNm>\n\t\t\t\t\t<Cmpnt>\n\t\t\t\t\t\t<Tp>TERM</Tp>\n\t\t\t\t\t\t<Id>\n\t\t\t\t\t\t\t<PrvdrId>FABRICANTE</PrvdrId>\n\t\t\t\t\t\t\t<Id>MODELO</Id>\n\t\t\t\t\t\t\t<SrlNb>XPTO</SrlNb>\n\t\t\t\t\t\t</Id>\n\t\t\t\t\t\t<Sts>\n\t\t\t\t\t\t\t<VrsnNb>XPTO</VrsnNb>\n\t\t\t\t\t\t</Sts>\n\t\t\t\t\t</Cmpnt>\n\t\t\t\t\t<Cpblties>\n\t\t\t\t\t\t<PrtLineWidth>39</PrtLineWidth>\n\t\t\t\t\t</Cpblties>\n\t\t\t\t</POI>\n\t\t\t\t<Card>\n\t\t\t\t\t<PlainCardData>\n\t\t\t\t\t\t<PAN>5612000269966</PAN>\n\t\t\t\t\t\t<XpryDt>2050-12</XpryDt>\n\t\t\t\t\t\t<CardSctyCd>\n\t\t\t\t\t\t\t<CSCVal>111</CSCVal>\n\t\t\t\t\t\t</CardSctyCd>\n\t\t\t\t\t</PlainCardData>\n\t\t\t\t</Card>\n\t\t\t\t<Crdhldr>\n\t\t\t\t\t<Nm>XPTO</Nm>\n\t\t\t\t\t<Authntcn>\n\t\t\t\t\t\t<AuthntcnMtd>PPSG</AuthntcnMtd>\n\t\t\t\t\t</Authntcn>\n\t\t\t\t</Crdhldr>\n\t\t\t</Envt>\n\t\t\t<Cntxt>\n\t\t\t\t<PmtCntxt>\n\t\t\t\t\t<CardDataNtryMd>PHYS</CardDataNtryMd>\n\t\t\t\t\t<FllbckInd>false</FllbckInd>\n\t\t\t\t\t<TxChanl>ECOM</TxChanl>\n\t\t\t\t</PmtCntxt>\n\t\t\t</Cntxt>\n\t\t\t<Tx>\n\t\t\t\t<InitrTxId>00000124112016103201</InitrTxId>\n\t\t\t\t<TxCaptr>true</TxCaptr>\n\t\t\t\t<TxId>\n\t\t\t\t\t<TxDtTm>2016-11-24T10:32:01</TxDtTm>\n\t\t\t\t\t<TxRef>0123456</TxRef>\n\t\t\t\t</TxId>\n\t\t\t\t<TxDtls>\n\t\t\t\t\t<Ccy>986</Ccy>\n\t\t\t\t\t<TtlAmt>100</TtlAmt>\n\t\t\t\t\t<AcctTp>CRDT</AcctTp>\n\t\t\t\t\t<RcrngTx>\n\t\t\t\t\t\t<InstlmtTp>ISSR</InstlmtTp>\n\t\t\t\t\t\t<TtlNbOfPmts>5</TtlNbOfPmts>\n\t\t\t\t\t</RcrngTx>\n\t\t\t\t</TxDtls>\n\t\t\t</Tx>\n\t\t</AuthstnReq>\n\t</AccptrAuthstnReq>\n</Document>", "language": "xml" } ] } [/block] Resposta [block:code] { "codes": [ { "code": "<Document xmlns=\"urn:AcceptorAuthorisationResponseV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n <AccptrAuthstnRspn>\n <Hdr>\n <MsgFctn>AUTP</MsgFctn>\n <PrtcolVrsn>2.0</PrtcolVrsn>\n <CreDtTm>2017-10-04T15:31:58</CreDtTm>\n </Hdr>\n <AuthstnRspn>\n <Envt>\n <MrchntId>\n <Id>XPTO</Id>\n </MrchntId>\n </Envt>\n <Tx>\n <TxId>\n <TxDtTm>2016-11-24T10:32:01</TxDtTm>\n <TxRef>0123456</TxRef>\n </TxId>\n <RcptTxId>XPTO</RcptTxId>\n <TxDtls>\n <Ccy>986</Ccy>\n <TtlAmt>0</TtlAmt>\n <AcctTp>CRDT</AcctTp>\n </TxDtls>\n </Tx>\n <TxRspn>\n <AuthstnRslt>\n <RspnToAuthstn>\n <Rspn>DECL</Rspn>\n <RspnRsn>1011</RspnRsn>\n </RspnToAuthstn>\n <AuthstnCd/>\n <CmpltnReqrd>false</CmpltnReqrd>\n </AuthstnRslt>\n <Actn>\n <ActnTp>DISP</ActnTp>\n <MsgToPres>\n <MsgDstn>MDSP</MsgDstn>\n <MsgCntt>Cartão inválido</MsgCntt>\n </MsgToPres>\n </Actn>\n </TxRspn>\n </AuthstnRspn>\n </AccptrAuthstnRspn>\n</Document>", "language": "xml" } ] } [/block] [block:api-header] { "title": "Resposta de Rejeição" } [/block] Mensagem Invalida – A mensagem enviada possui um formato inválido. [block:code] { "codes": [ { "code": "<Document xmlns=\"urn:AcceptorRejectionV02.1\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\">\n\t<AccptrRjctn>\n\t\t<Hdr>\n\t\t\t<MsgFctn>RJCT</MsgFctn>\n\t\t\t<PrtcolVrsn>2.0</PrtcolVrsn>\n\t\t\t<CreDtTm>2016-11-28T10:11:23</CreDtTm>\n\t\t</Hdr>\n\t\t<Rjct>\n\t\t\t<RjctRsn>IMSG</RjctRsn>\n\t\t\t<AddtlInf> Identification - GenericIdentification Id can not be null</AddtlInf>\n\t\t\t<MsgInErr/>\n\t\t</Rjct>\n\t</AccptrRjctn>\n</Document>", "language": "xml" } ] } [/block]
{"_id":"596bb63d38b45800290c4302","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4fac9","user":"58dcf4b604ea0f0f00fbdfcb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-07-16T18:53:49.412Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"status":200,"name":"","code":"{}","language":"json"},{"name":"","code":"{}","language":"json","status":400}]},"auth":"required","params":[],"url":""},"isReference":false,"order":15,"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     * **Recorrência**\n\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]","excerpt":"","slug":"requisições-e-funcionalidades-2","type":"basic","title":"Requisições e funcionalidades","__v":0,"parentDoc":null,"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**) * **Recorrência** * 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**) * **Recorrência** * 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]
{"_id":"594439a76c2e49000f873719","project":"583f0fb04828d50f00126d4d","version":"591445aabb92601b00a4fac8","category":"591445abbb92601b00a4facb","user":"58dcf4b604ea0f0f00fbdfcb","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-06-16T20:03:51.310Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":0,"body":"[block:api-header]\n{}\n[/block]\n\n[block:api-header]\n{}\n[/block]\n| Código de Retorno | Descrição | Mensagem | Pode retentar? |\n| ----------------- | --------- | -------- | -------------- |\n| 1000 | Do not honour | Não aprovado | Não se Aplica |\n| 1001 | Expired card | Cartão vencido | Não se Aplica |\n| 1002 | Suspected fraud | Suspeita de fraude | Não se Aplica |\n| 1003 | Card acceptor contact acquirer | Estabelecimento entrar em contato com emissor | Não se Aplica |\n| 1004 | Restricted card | Cartão com restrição | Não se Aplica |\n| 1005 | Card acceptor call acquirer's security department | Estabelecimento entrar em contato com departamento de segurança do adquirente | Não se Aplica |\n| 1006 | Allowable PIN tries exceeded | Tentativas de senha excedidas | Não se Aplica |\n| 1007 | Refer to card issuer | Consultar o emissor | Não se Aplica |\n| 1008 | Refer to card issuer's special conditions | Consultar as condições especiais do emissor | Não se Aplica |\n| 1009 | Invalid card acceptor | Estabelecimento inválido | Não se Aplica |\n| 1010 | Invalid amount | Valor inválido | Não se Aplica |\n| 1011 | Invalid card number | Cartão inválido | Não se Aplica |\n| 1012 | PIN data required | Senha necessária | Não se Aplica |\n| 1014 | No account of type requested | Nenhuma conta do tipo selecionado | Não se Aplica |\n| 1015 | Requested function not supported | Função selecionada não suportada | Não se Aplica |\n| 1016 | Not sufficient funds | Saldo insuficiente | Sim |\n| 1017 | Incorrect PIN | Senha inválida | Sim |\n| 1019 | Transaction not permitted to cardholder | Transação não permitida para o portador | Não se Aplica |\n| 1020 | Transaction not permitted to terminal | Transação não permitida para o terminal | Não se Aplica |\n| 1021 | Exceeds withdrawal amount limit | Limite de valor para saque excedido | Não se Aplica |\n| 1022 | Security violation | Violação de segurança | Não se Aplica |\n| 1023 | Exceeds withdrawal frequency limit | Limite de quantidade de saques excedido | Não se Aplica |\n| 1024 | Violation of law | Violação da lei | Não se Aplica |\n| 1025 | Card not effective | Cartão bloqueado | Não se Aplica |\n| 1026 | Invalid PIN block | Dados de senha inválidos | Não se Aplica |\n| 1027 | PIN length error | Erro no tamanho da senha | Não se Aplica |\n| 1028 | PIN key sync error | Erro de sincronia de chave de senha | Não se Aplica |\n| 1029 | Suspected counterfeit card | Suspeita de cartão falso | Não se Aplica |\n| 1030 | Currency unacceptable to card issuer | Moeda inaceitável para o emissor | Não se Aplica |\n| 1032 | Lost/stolen card | Cartão perdido ou roubado | Não se Aplica |\n| 1035 | Closed account | Conta encerrada | Não se Aplica |\n| 1036 | Closed savings account, or restricted for closing | Conta poupança encerrada ou bloqueada para encerramento | Não se Aplica |\n| 1037 | Closed credit account or restricted for closing | Conta de crédito encerrada ou bloqueada para encerramento | Não se Aplica |\n| 1039 | Closed cheque account or restricted for closing | Conta corrente encerrada ou bloquada para encerramento | Não se Aplica |\n| 1041 | From account bad status | Status ruim para conta de origem | Não se Aplica |\n| 1042 | To account bad status | Status ruim para conta de destino | Não se Aplica |\n| 1045 | Card verification data failed | Código de segurança inválido | Sim |\n| 1047 | PIN change required | Troca de senha necessária | Não se Aplica |\n| 1048 | New PIN invalid | Nova senha inválida | Não se Aplica |\n| 1057 | Payment date invalid | Data de pagamento inválida | Não se Aplica |\n| 1060 | Transaction did not complete normally at terminal | Transação não completou normalmente no terminal | Não se Aplica |\n| 1061 | Transaction not supported by the card issuer | Transação não suportada pelo emissor | Não se Aplica |\n| 1062 | Cashback not allowed | Saque fácil não disponível | Não se Aplica |\n| 1063 | Cashback amount exceeded | Limite de saque fácil excedido | Não se Aplica |\n| 1064 | Declined, transaction processed offline by terminal | Negado offline pelo terminal | Não se Aplica |\n| 1065 | Declined, terminal unable to process offline | Negado, não foi possível processar offline | Não se Aplica |\n| 2000 | Do not honour | Não aprovado | Não se Aplica |\n| 2001 | Expired card | Cartão vencido | Não se Aplica |\n| 2002 | Suspected fraud | Suspeita de fraude | Não se Aplica |\n| 2003 | Card acceptor contact acquirer | Estabelecimento entrar em contato com emissor | Não se Aplica |\n| 2004 | Restricted card | Cartão com restrição | Não se Aplica |\n| 2005 | Card acceptor call acquirer's security department | Estabelecimento entrar em contato com departamento de segurança do adquirente | Não se Aplica |\n| 2006 | Allowable PIN tries exceeded | Tentativas de senha excedidas | Não se Aplica |\n| 2007 | Special conditions | Condições especiais | Não se Aplica |\n| 2008 | Lost card | Cartão perdido | Não se Aplica |\n| 2009 | Stolen card | Cartão roubado | Não se Aplica |\n| 2010 | Suspected counterfeit card | Suspeita de cartão falso | Não se Aplica |\n| 2011 | Daily withdrawal uses exceeded | Limite de quantidade de saques excedido | Não se Aplica |\n| 2012 | Daily withdrawal amount exceeded | Limite de valor para saque excedido | Não se Aplica |\n| 9100 | One or more data element errors (see message error indicator) | Erro no formato da mensagem | Não se Aplica |\n| 9102 | Invalid transaction | Transação inválida | Não se Aplica |\n| 9103 | Re-enter transaction | Tente novamente | Não se Aplica |\n| 9105 | Acquirer not supported by switch | Adquirente não suportado pelo switch | Não se Aplica |\n| 9107 | Card issuer or switch inoperative | Emissor fora de operação | Não se Aplica |\n| 9108 | Transaction destination cannot be found for routing | Não foi possível enviar a transação para o destinatário | Sim |\n| 9109 | System malfunction | Erro no sistema | Sim |\n| 9110 | Card issuer signed off | Emissor se desconectou | Não se Aplica |\n| 9111 | Card issuer timed out | Emissor não respondeu em tempo | Sim |\n| 9112 | Card issuer unavailable | Emissor indisponível | Sim |\n| 9113 | Duplicate transmission | Transmissão duplicada | Não se Aplica |\n| 9114 | Not able to trace back to original transaction | Não foi possível encontrar a transação original | Não se Aplica |\n| 9116 | MAC incorrect | MAC incorreto | Não se Aplica |\n| 9117 | MAC key sync error | Erro de sincronização de chave de MAC | Não se Aplica |\n| 9118 | No communication keys available for use | Nenhuma chave de comunicação disponível | Não se Aplica |\n| 9119 | Encryption key sync error | Erro de sincronização de chave de encriptação | Não se Aplica |\n| 9120 | Security software/hardware error – try again | Erro de segurança de software/hardware, tente novamente | Não se Aplica |\n| 9121 | Security software/hardware error – no action | Erro de segurança de software/hardware | Não se Aplica |\n| 9122 | Message number out of sequence | Número da mensagem fora de sequência | Não se Aplica |\n| 9123 | Request in progress | Requisição em progresso | Não se Aplica |\n| 9124 | Invalid security code | Código de segurança inválido | Não se Aplica |\n| 9125 | Database error | Erro no banco de dados | Não se Aplica |\n| 9132 | Recurring data error | Erro nos dados de recorrência | Não se Aplica |\n| 9133 | Update not allowed | Atualização não permitida | Não se Aplica |\n| 9350 | Violation of business arrangement | Violação de acordo comercial | Não se Aplica |\n| 9999 | Other errors | Erro não especificado | Não se Aplica |\n|UNPR| Rejection | Não Foi possível processar – Não foi possível processar a mensagem. Tente novamente. | Não se Aplica |\n| IMSG | Rejection | Mensagem Invalida – A mensagem enviada possui um formato inválido. | Não se Aplica |\n| PARS | Rejection | Erro na leitura da mensagem – Algum campo obrigatório não esta sendo enviado | Não se Aplica |\n| SECU | Rejection | Segurança – Algum erro no processo de segurança. A chave de criptografia pode não estar presente no terminal. | Não se Aplica |\n| INTP | Rejection | SAK Invalido – O SAK enviado não foi reconhecido | Não se Aplica |\n| RCPP | Rejection | Destinatario Invalido – O local para aonde a mensagem foi enviada esta invalida | Não se Aplica |\n| DPMG | Rejection | Mensagem Duplicada – Esta mensagem já foi recebida pela Stone. | Não se Aplica |\n| VERS | Rejection | Protocolo – A versão do protocolo enviada não é suportada. | Não se Aplica |\n| MSGT| Rejection | Tipo da Mensagem – o Message Type enviado não é reconhecido. | Não se Aplica |","excerpt":"","slug":"códigos-de-retorno-2","type":"basic","title":"Códigos de retorno","__v":0,"parentDoc":null,"childrenPages":[]}

Códigos de retorno


[block:api-header] {} [/block] [block:api-header] {} [/block] | Código de Retorno | Descrição | Mensagem | Pode retentar? | | ----------------- | --------- | -------- | -------------- | | 1000 | Do not honour | Não aprovado | Não se Aplica | | 1001 | Expired card | Cartão vencido | Não se Aplica | | 1002 | Suspected fraud | Suspeita de fraude | Não se Aplica | | 1003 | Card acceptor contact acquirer | Estabelecimento entrar em contato com emissor | Não se Aplica | | 1004 | Restricted card | Cartão com restrição | Não se Aplica | | 1005 | Card acceptor call acquirer's security department | Estabelecimento entrar em contato com departamento de segurança do adquirente | Não se Aplica | | 1006 | Allowable PIN tries exceeded | Tentativas de senha excedidas | Não se Aplica | | 1007 | Refer to card issuer | Consultar o emissor | Não se Aplica | | 1008 | Refer to card issuer's special conditions | Consultar as condições especiais do emissor | Não se Aplica | | 1009 | Invalid card acceptor | Estabelecimento inválido | Não se Aplica | | 1010 | Invalid amount | Valor inválido | Não se Aplica | | 1011 | Invalid card number | Cartão inválido | Não se Aplica | | 1012 | PIN data required | Senha necessária | Não se Aplica | | 1014 | No account of type requested | Nenhuma conta do tipo selecionado | Não se Aplica | | 1015 | Requested function not supported | Função selecionada não suportada | Não se Aplica | | 1016 | Not sufficient funds | Saldo insuficiente | Sim | | 1017 | Incorrect PIN | Senha inválida | Sim | | 1019 | Transaction not permitted to cardholder | Transação não permitida para o portador | Não se Aplica | | 1020 | Transaction not permitted to terminal | Transação não permitida para o terminal | Não se Aplica | | 1021 | Exceeds withdrawal amount limit | Limite de valor para saque excedido | Não se Aplica | | 1022 | Security violation | Violação de segurança | Não se Aplica | | 1023 | Exceeds withdrawal frequency limit | Limite de quantidade de saques excedido | Não se Aplica | | 1024 | Violation of law | Violação da lei | Não se Aplica | | 1025 | Card not effective | Cartão bloqueado | Não se Aplica | | 1026 | Invalid PIN block | Dados de senha inválidos | Não se Aplica | | 1027 | PIN length error | Erro no tamanho da senha | Não se Aplica | | 1028 | PIN key sync error | Erro de sincronia de chave de senha | Não se Aplica | | 1029 | Suspected counterfeit card | Suspeita de cartão falso | Não se Aplica | | 1030 | Currency unacceptable to card issuer | Moeda inaceitável para o emissor | Não se Aplica | | 1032 | Lost/stolen card | Cartão perdido ou roubado | Não se Aplica | | 1035 | Closed account | Conta encerrada | Não se Aplica | | 1036 | Closed savings account, or restricted for closing | Conta poupança encerrada ou bloqueada para encerramento | Não se Aplica | | 1037 | Closed credit account or restricted for closing | Conta de crédito encerrada ou bloqueada para encerramento | Não se Aplica | | 1039 | Closed cheque account or restricted for closing | Conta corrente encerrada ou bloquada para encerramento | Não se Aplica | | 1041 | From account bad status | Status ruim para conta de origem | Não se Aplica | | 1042 | To account bad status | Status ruim para conta de destino | Não se Aplica | | 1045 | Card verification data failed | Código de segurança inválido | Sim | | 1047 | PIN change required | Troca de senha necessária | Não se Aplica | | 1048 | New PIN invalid | Nova senha inválida | Não se Aplica | | 1057 | Payment date invalid | Data de pagamento inválida | Não se Aplica | | 1060 | Transaction did not complete normally at terminal | Transação não completou normalmente no terminal | Não se Aplica | | 1061 | Transaction not supported by the card issuer | Transação não suportada pelo emissor | Não se Aplica | | 1062 | Cashback not allowed | Saque fácil não disponível | Não se Aplica | | 1063 | Cashback amount exceeded | Limite de saque fácil excedido | Não se Aplica | | 1064 | Declined, transaction processed offline by terminal | Negado offline pelo terminal | Não se Aplica | | 1065 | Declined, terminal unable to process offline | Negado, não foi possível processar offline | Não se Aplica | | 2000 | Do not honour | Não aprovado | Não se Aplica | | 2001 | Expired card | Cartão vencido | Não se Aplica | | 2002 | Suspected fraud | Suspeita de fraude | Não se Aplica | | 2003 | Card acceptor contact acquirer | Estabelecimento entrar em contato com emissor | Não se Aplica | | 2004 | Restricted card | Cartão com restrição | Não se Aplica | | 2005 | Card acceptor call acquirer's security department | Estabelecimento entrar em contato com departamento de segurança do adquirente | Não se Aplica | | 2006 | Allowable PIN tries exceeded | Tentativas de senha excedidas | Não se Aplica | | 2007 | Special conditions | Condições especiais | Não se Aplica | | 2008 | Lost card | Cartão perdido | Não se Aplica | | 2009 | Stolen card | Cartão roubado | Não se Aplica | | 2010 | Suspected counterfeit card | Suspeita de cartão falso | Não se Aplica | | 2011 | Daily withdrawal uses exceeded | Limite de quantidade de saques excedido | Não se Aplica | | 2012 | Daily withdrawal amount exceeded | Limite de valor para saque excedido | Não se Aplica | | 9100 | One or more data element errors (see message error indicator) | Erro no formato da mensagem | Não se Aplica | | 9102 | Invalid transaction | Transação inválida | Não se Aplica | | 9103 | Re-enter transaction | Tente novamente | Não se Aplica | | 9105 | Acquirer not supported by switch | Adquirente não suportado pelo switch | Não se Aplica | | 9107 | Card issuer or switch inoperative | Emissor fora de operação | Não se Aplica | | 9108 | Transaction destination cannot be found for routing | Não foi possível enviar a transação para o destinatário | Sim | | 9109 | System malfunction | Erro no sistema | Sim | | 9110 | Card issuer signed off | Emissor se desconectou | Não se Aplica | | 9111 | Card issuer timed out | Emissor não respondeu em tempo | Sim | | 9112 | Card issuer unavailable | Emissor indisponível | Sim | | 9113 | Duplicate transmission | Transmissão duplicada | Não se Aplica | | 9114 | Not able to trace back to original transaction | Não foi possível encontrar a transação original | Não se Aplica | | 9116 | MAC incorrect | MAC incorreto | Não se Aplica | | 9117 | MAC key sync error | Erro de sincronização de chave de MAC | Não se Aplica | | 9118 | No communication keys available for use | Nenhuma chave de comunicação disponível | Não se Aplica | | 9119 | Encryption key sync error | Erro de sincronização de chave de encriptação | Não se Aplica | | 9120 | Security software/hardware error – try again | Erro de segurança de software/hardware, tente novamente | Não se Aplica | | 9121 | Security software/hardware error – no action | Erro de segurança de software/hardware | Não se Aplica | | 9122 | Message number out of sequence | Número da mensagem fora de sequência | Não se Aplica | | 9123 | Request in progress | Requisição em progresso | Não se Aplica | | 9124 | Invalid security code | Código de segurança inválido | Não se Aplica | | 9125 | Database error | Erro no banco de dados | Não se Aplica | | 9132 | Recurring data error | Erro nos dados de recorrência | Não se Aplica | | 9133 | Update not allowed | Atualização não permitida | Não se Aplica | | 9350 | Violation of business arrangement | Violação de acordo comercial | Não se Aplica | | 9999 | Other errors | Erro não especificado | Não se Aplica | |UNPR| Rejection | Não Foi possível processar – Não foi possível processar a mensagem. Tente novamente. | Não se Aplica | | IMSG | Rejection | Mensagem Invalida – A mensagem enviada possui um formato inválido. | Não se Aplica | | PARS | Rejection | Erro na leitura da mensagem – Algum campo obrigatório não esta sendo enviado | Não se Aplica | | SECU | Rejection | Segurança – Algum erro no processo de segurança. A chave de criptografia pode não estar presente no terminal. | Não se Aplica | | INTP | Rejection | SAK Invalido – O SAK enviado não foi reconhecido | Não se Aplica | | RCPP | Rejection | Destinatario Invalido – O local para aonde a mensagem foi enviada esta invalida | Não se Aplica | | DPMG | Rejection | Mensagem Duplicada – Esta mensagem já foi recebida pela Stone. | Não se Aplica | | VERS | Rejection | Protocolo – A versão do protocolo enviada não é suportada. | Não se Aplica | | MSGT| Rejection | Tipo da Mensagem – o Message Type enviado não é reconhecido. | Não se Aplica |
[block:api-header] {} [/block] [block:api-header] {} [/block] | Código de Retorno | Descrição | Mensagem | Pode retentar? | | ----------------- | --------- | -------- | -------------- | | 1000 | Do not honour | Não aprovado | Não se Aplica | | 1001 | Expired card | Cartão vencido | Não se Aplica | | 1002 | Suspected fraud | Suspeita de fraude | Não se Aplica | | 1003 | Card acceptor contact acquirer | Estabelecimento entrar em contato com emissor | Não se Aplica | | 1004 | Restricted card | Cartão com restrição | Não se Aplica | | 1005 | Card acceptor call acquirer's security department | Estabelecimento entrar em contato com departamento de segurança do adquirente | Não se Aplica | | 1006 | Allowable PIN tries exceeded | Tentativas de senha excedidas | Não se Aplica | | 1007 | Refer to card issuer | Consultar o emissor | Não se Aplica | | 1008 | Refer to card issuer's special conditions | Consultar as condições especiais do emissor | Não se Aplica | | 1009 | Invalid card acceptor | Estabelecimento inválido | Não se Aplica | | 1010 | Invalid amount | Valor inválido | Não se Aplica | | 1011 | Invalid card number | Cartão inválido | Não se Aplica | | 1012 | PIN data required | Senha necessária | Não se Aplica | | 1014 | No account of type requested | Nenhuma conta do tipo selecionado | Não se Aplica | | 1015 | Requested function not supported | Função selecionada não suportada | Não se Aplica | | 1016 | Not sufficient funds | Saldo insuficiente | Sim | | 1017 | Incorrect PIN | Senha inválida | Sim | | 1019 | Transaction not permitted to cardholder | Transação não permitida para o portador | Não se Aplica | | 1020 | Transaction not permitted to terminal | Transação não permitida para o terminal | Não se Aplica | | 1021 | Exceeds withdrawal amount limit | Limite de valor para saque excedido | Não se Aplica | | 1022 | Security violation | Violação de segurança | Não se Aplica | | 1023 | Exceeds withdrawal frequency limit | Limite de quantidade de saques excedido | Não se Aplica | | 1024 | Violation of law | Violação da lei | Não se Aplica | | 1025 | Card not effective | Cartão bloqueado | Não se Aplica | | 1026 | Invalid PIN block | Dados de senha inválidos | Não se Aplica | | 1027 | PIN length error | Erro no tamanho da senha | Não se Aplica | | 1028 | PIN key sync error | Erro de sincronia de chave de senha | Não se Aplica | | 1029 | Suspected counterfeit card | Suspeita de cartão falso | Não se Aplica | | 1030 | Currency unacceptable to card issuer | Moeda inaceitável para o emissor | Não se Aplica | | 1032 | Lost/stolen card | Cartão perdido ou roubado | Não se Aplica | | 1035 | Closed account | Conta encerrada | Não se Aplica | | 1036 | Closed savings account, or restricted for closing | Conta poupança encerrada ou bloqueada para encerramento | Não se Aplica | | 1037 | Closed credit account or restricted for closing | Conta de crédito encerrada ou bloqueada para encerramento | Não se Aplica | | 1039 | Closed cheque account or restricted for closing | Conta corrente encerrada ou bloquada para encerramento | Não se Aplica | | 1041 | From account bad status | Status ruim para conta de origem | Não se Aplica | | 1042 | To account bad status | Status ruim para conta de destino | Não se Aplica | | 1045 | Card verification data failed | Código de segurança inválido | Sim | | 1047 | PIN change required | Troca de senha necessária | Não se Aplica | | 1048 | New PIN invalid | Nova senha inválida | Não se Aplica | | 1057 | Payment date invalid | Data de pagamento inválida | Não se Aplica | | 1060 | Transaction did not complete normally at terminal | Transação não completou normalmente no terminal | Não se Aplica | | 1061 | Transaction not supported by the card issuer | Transação não suportada pelo emissor | Não se Aplica | | 1062 | Cashback not allowed | Saque fácil não disponível | Não se Aplica | | 1063 | Cashback amount exceeded | Limite de saque fácil excedido | Não se Aplica | | 1064 | Declined, transaction processed offline by terminal | Negado offline pelo terminal | Não se Aplica | | 1065 | Declined, terminal unable to process offline | Negado, não foi possível processar offline | Não se Aplica | | 2000 | Do not honour | Não aprovado | Não se Aplica | | 2001 | Expired card | Cartão vencido | Não se Aplica | | 2002 | Suspected fraud | Suspeita de fraude | Não se Aplica | | 2003 | Card acceptor contact acquirer | Estabelecimento entrar em contato com emissor | Não se Aplica | | 2004 | Restricted card | Cartão com restrição | Não se Aplica | | 2005 | Card acceptor call acquirer's security department | Estabelecimento entrar em contato com departamento de segurança do adquirente | Não se Aplica | | 2006 | Allowable PIN tries exceeded | Tentativas de senha excedidas | Não se Aplica | | 2007 | Special conditions | Condições especiais | Não se Aplica | | 2008 | Lost card | Cartão perdido | Não se Aplica | | 2009 | Stolen card | Cartão roubado | Não se Aplica | | 2010 | Suspected counterfeit card | Suspeita de cartão falso | Não se Aplica | | 2011 | Daily withdrawal uses exceeded | Limite de quantidade de saques excedido | Não se Aplica | | 2012 | Daily withdrawal amount exceeded | Limite de valor para saque excedido | Não se Aplica | | 9100 | One or more data element errors (see message error indicator) | Erro no formato da mensagem | Não se Aplica | | 9102 | Invalid transaction | Transação inválida | Não se Aplica | | 9103 | Re-enter transaction | Tente novamente | Não se Aplica | | 9105 | Acquirer not supported by switch | Adquirente não suportado pelo switch | Não se Aplica | | 9107 | Card issuer or switch inoperative | Emissor fora de operação | Não se Aplica | | 9108 | Transaction destination cannot be found for routing | Não foi possível enviar a transação para o destinatário | Sim | | 9109 | System malfunction | Erro no sistema | Sim | | 9110 | Card issuer signed off | Emissor se desconectou | Não se Aplica | | 9111 | Card issuer timed out | Emissor não respondeu em tempo | Sim | | 9112 | Card issuer unavailable | Emissor indisponível | Sim | | 9113 | Duplicate transmission | Transmissão duplicada | Não se Aplica | | 9114 | Not able to trace back to original transaction | Não foi possível encontrar a transação original | Não se Aplica | | 9116 | MAC incorrect | MAC incorreto | Não se Aplica | | 9117 | MAC key sync error | Erro de sincronização de chave de MAC | Não se Aplica | | 9118 | No communication keys available for use | Nenhuma chave de comunicação disponível | Não se Aplica | | 9119 | Encryption key sync error | Erro de sincronização de chave de encriptação | Não se Aplica | | 9120 | Security software/hardware error – try again | Erro de segurança de software/hardware, tente novamente | Não se Aplica | | 9121 | Security software/hardware error – no action | Erro de segurança de software/hardware | Não se Aplica | | 9122 | Message number out of sequence | Número da mensagem fora de sequência | Não se Aplica | | 9123 | Request in progress | Requisição em progresso | Não se Aplica | | 9124 | Invalid security code | Código de segurança inválido | Não se Aplica | | 9125 | Database error | Erro no banco de dados | Não se Aplica | | 9132 | Recurring data error | Erro nos dados de recorrência | Não se Aplica | | 9133 | Update not allowed | Atualização não permitida | Não se Aplica | | 9350 | Violation of business arrangement | Violação de acordo comercial | Não se Aplica | | 9999 | Other errors | Erro não especificado | Não se Aplica | |UNPR| Rejection | Não Foi possível processar – Não foi possível processar a mensagem. Tente novamente. | Não se Aplica | | IMSG | Rejection | Mensagem Invalida – A mensagem enviada possui um formato inválido. | Não se Aplica | | PARS | Rejection | Erro na leitura da mensagem – Algum campo obrigatório não esta sendo enviado | Não se Aplica | | SECU | Rejection | Segurança – Algum erro no processo de segurança. A chave de criptografia pode não estar presente no terminal. | Não se Aplica | | INTP | Rejection | SAK Invalido – O SAK enviado não foi reconhecido | Não se Aplica | | RCPP | Rejection | Destinatario Invalido – O local para aonde a mensagem foi enviada esta invalida | Não se Aplica | | DPMG | Rejection | Mensagem Duplicada – Esta mensagem já foi recebida pela Stone. | Não se Aplica | | VERS | Rejection | Protocolo – A versão do protocolo enviada não é suportada. | Não se Aplica | | MSGT| Rejection | Tipo da Mensagem – o Message Type enviado não é reconhecido. | Não se Aplica |
{"_id":"591445adbb92601b00a4fae1","api":{"auth":"required","params":[],"url":"","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"status":400,"name":"","code":"{}","language":"json"}]},"settings":""},"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":"591445abbb92601b00a4facb","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"type":"basic","next":{"description":"","pages":[]},"createdAt":"2016-12-16T20:02:43.325Z","isReference":true,"excerpt":"","title":"Tipo das TAGs XML","project":"583f0fb04828d50f00126d4d","__v":0,"user":"57ea79f61780cd170064f273","version":"591445aabb92601b00a4fac8","updates":[],"order":2,"slug":"tipo-das-tags-xml","parentDoc":null,"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>