Conciliação

Bem vindo a Stone Conciliação!

Get Started    
Suggest Edits

Bem vindo à Conciliação

 

Bem vindo à Conciliação Stone esta é uma aplicação que disponibiliza diariamente aos estabelecimentos a demonstração das transações e eventos ocorridos no dia referenciado e suas respectivas informações financeiras. Esta ferramenta permite o acompanhamento desde a captura até o pagamento/desconto de cada uma das transações e lançamentos realizados.

É possível que o lojista consiga visualizar de forma bastante clara, o valor líquido e bruto de cada parcela, o valor líquido e bruto de cancelamento parcial e total, quais parcelas da transação foram antecipadas e qual foi o custo da antecipação de cada parcela, chargebacks a serem descontados, etc.

Nossa Conciliação funciona através da obtenção do arquivo diretamente conosco, de forma segura, através de um API.

Juntamos todas essas informações em um único arquivo, para que possamos de forma simples e direta, eliminar a utilização de inumeros arquvos e layouts diferentes em busca de uma ferramenta de gestão cada vez mellhor para nossos clientes.

Suggest Edits

Overview da API

 

Códigos de Retorno HTTP

As operações são feitas através de requests ao endpoint, de acordo com os verbos HTTP.
As respostas da API podem ser as seguintes:

HTTP Status Code

  • 200 OK
  • 400 BAD REQUEST
  • 401 UNAUTHORIZED
  • 500 INTERNAL SERVER ERROR
  • 503 SERVICE UNAVAILABLE

O único verbo HTTP usado é GET.

Arquivo de Conciliação

O arquivo contém todas as transações que foram capturadas no dia solicitado, ou seja, todas as transações capturadas no dia para o qual a reconciliação está sendo gerada.

O arquivo adota o modelo de liquidação da agenda, diferente do que é praticado no mercado. Isso significa que no arquivo de conciliação da Stone fornecemos, para o mesmo dia, as informações sobre as transações financeiras, eventos e ajustes ocorridos; e as transações e eventos financeiros que serão liquidados e os pagamentos.

Transações apresentadas no arquivo

É importante lembrar que no arquivo estarão prensentes as transações que foram capturadas e não aquelas que foram apenas autorizadas, sendo que esse tipo de transação não gera movimento financeiro.

O arquivo disponibilizado via API tem uma estrutura de 7 conteiners, que trazem o detalhamento transacional do cliente de forma estruturada. São eles:

  • Header;
  • FinancialTransactions;
  • FinancialEvents;
  • FinancialTransactionsAccounts;
  • FinancialEventsAccounts;
  • Payments;
  • Trailer.

Abaixo uma explicação sobre cada um dos containers:

Container
Descrição

Header

Contém as informações do lojista e do arquivo.

FinancialTransactions

Contém as transações e eventos de transações do dia requisitado

FinancialEvents

Contém os eventos financeiros lançados para o lojista no dia.

FinancialTransactionsAccounts

Contém as transações que foram pagas/cobradas ao lojista no dia requisitado

FinancialEventsAccounts

Contém os eventos que foram pagos/cobrados ao lojista no dia requisistado

Payments

Contém informações dos pagamentos efetuados relativos as transações e eventos financeiros do arquivo.

Trailer

Contém os totalizadores e contadores do arquivo.

Suggest Edits

Fluxo Operacional

 

Antes de integrar a nossa solução, é necessário que você entenda o fluxo operacional para que sua integração possa ocorrer sem problemas.

Como já foi dito na visão geral, nossa API usa apenas o verbo HTTP GET.

Credenciais

As chaves para acesso aos arquivos de conciliação dos clientes são: ClientApplicationKey e a SecretKey.

Como obter as chaves ClientApplicationKey e SecretKey?

É necessário entrar em contato conosco através do email integracoes@stone.com.br com o assunto "Credenciais de Conciliação"

Para enviar as solicitações para a API, algumas informações são necessárias:

  1. ClientApplicationKey: Chave pública da aplicação gerada pela Stone.
    O ClientApplicationKey deve ser enviado no cabeçalho da solicitação na chave Authorization

  2. ClientEncryptionString: Chave aleatória que será gerada pela aplicação cliente.
    A ClientEncryptionString deve ser enviada no cabeçalho da solicitação na chave X-Authorization-Raw-Data

  3. Signature: Chave ClientEncryptionString cifrada utilizando a SecretKey fornecida juntamente com a chave pública (ClientApplicationKey) gerada pela Stone.
    A Signature deve ser enviada no cabeçalho da solicitação na chave X-Authorization-Encrypted-Data

A Signature é um HMAC gerado com algoritmo SHA-512. Deve-se utilizar como String de codificação o ClientEncryptionString juntamente do SecretKey gerado pela Stone.

HMAC SHA-512

É possível encontrar diversas plataformas web que geram a conversão HMAC com o algoritimo SHA-512, como, por exemplo, o Freeformatter.

Header

"Authorization: {Bearer ClientApplicationKey}"
"X-Authorization-Raw-Data: {ClientEncryptionString}"
"X-Authorization-Encrypted-Data: {Signature}"

  1. Data de referência: Dia para o qual você deseja solicitar o arquivo. (Formato yyyyMMdd ).
    A data de referência devem ser usadas para completar a URL do endpoint

  2. Código de afiliação Stone: Stone Code do cliente.
    O Stone Code deve ser usado como parametro para completar a URL do endpoint

Quando o arquivo está disponível

O pedido deve ser feito somente depois das 5:00 da manhã do dia seguinte ao qual você deseja conciliar

AffiliationCode ≠ AffiliationKey

O AffiliationCode nada mais é que o StoneCode do cliente.

Como comprimir o arquivo de conciliação?

Para acelerar a transferência de arquivos, você pode solicita-los em formato compactado. Para fazer isso, é necessário incluir a chave Accept-Encoding com o valorqzip no cabeçalho da requisição.

Comprimindo o arquivo

"Accept-Encoding: gzip"

Pontos Adicionais

Nossos pagamentos são feitos através da CIP e seguindo essas regras utilizamos o conceito de carteiras nos pagamentos dos nossos clientes, ou seja, os pagamentos são agrupados por bandeiras e produtos, reunindo todos os valores e efetuados de uma única vez dentro do grupo bandeira/produto.

As carterias são divididas da seguinte forma:

  • Stone - Mastercard Débito - Saldo das transações Mastercard Débito
  • Stone - Mastercard Crédito- Saldo das transações Mastercard Crédito
  • Stone - Mastercacard Antecipação- Saldo das transações Mastercard Antecipação
  • Stone - Visa Débito - Saldo das transações Visa Débito
  • Stone - Visa Crédito- Saldo das transações Visa Crédito
  • Stone - Visa Antecipação- Saldo das transações Visa Antecipação
  • Stone - Elo Débito- Saldo das transações Elo Débito
  • Stone - Elo Crédito- Saldo das transações Elo Crédito
  • Stone - Elo Antecipação- Saldo das transações Elo Antecipação
  • Stone - Hiper Crédito- Saldo das transações Hiper Crédito
  • Stone - Hiper Antecipação- Saldo das transações Hiper Antecipação
  • Stone - Amex Crédito- Saldo das transações Amex Crédito
  • Stone - Amex Antecipação- Saldo das transações Amex Antecipação
  • Stone - Boleto - Saldo das transações via boleto
  • Stone - Movimentos Não Transacionais- Saldo dos Movimentos Não Transacionais

Carteira com Saldo Negativo

Caso uma carteira fique com saldo negativo, o valor será descontado da carteira com maior saldo positivo.

Abaixo um exemplo dos recebíveis divididos em suas respectivas carteiras:

Stone - Mastercard Débito

R$ 100,00

Stone - Mastercard Crédito

R$ 50,00

Stone - Visa Débito

R$ 150,00

Stone - Visa Crédito

R$ 30,00

TOTAL

R$ 330,00

Caso, em algum momento esse cliente receba um chargeback, há a possibilidade de uma carteira ficar negativa e automaticamente o valor será retirado da carteira com maior valor. Por exemplo, caso o cliente receba um chargeback de R$ 50,00 da bandeira Visa no produto Crédito o cenário seria o seguinte:

Stone - Mastercard Débito

R$ 100,00

Stone - Mastercard Crédito

R$ 50,00

Stone - Visa Débito

R$ 130,00

Stone - Visa Crédito

R$ 0,00

TOTAL

R$ 280,00

Ou seja, o valor foi descontado sobre a carteira que sofreu o chargeback (Stone - Visa Crédito) e como ela ficou negativa em R$ 15,00, o valor foi descontado da carteira com maior saldo positivo (Stone - Visa Débito).

Também descontamos dos pagamentos do cliente o valor do aluguel do terminal que ele utiliza, isso e todos os ajustes financeiros sempre estarão descritos nos FinancialEvents e seguem a regra de descontar sempre da carteira com maior saldo positivo.

Suggest Edits

Gerando o Arquivo Manualmente

 

Sempre que um problema é encontrado em alguma informação da conciliação é de extrema importancia de o arquivo original seja extraido novamente e validado manualmente.

Como efetuar o download manualmente

É possível enviar a requisição do download do arquivo manualmente, utilizando algum software de teste de web services.

Softwares

Apache JMeter
SoapUI
Postman
Wizdler
Etc.

Postman

É a ferramenta mais utilizada para esse tipo de testes.

É necessário que seja seguido o método GET explicado aqui

Importante lembrar

É necessário estar munido das seguintes informações para fazer o uso de algum destes softwares:
URL do endpoint
Data da informação
ClientApplicationKey
SecretKey

Suggest Edits

Comunicação

 

O protocolo de comunicação utilizado para se conectar a Stone é o HTTPS. O http verbo a ser utilizado será sempre GET.
As respostas da API tem os seguintes HTTP Status Code:

  • 200 (OK);
  • 400 (BAD REQUEST);
  • 401 (UNAUTHORIZED);
  • 500 (INTERNAL SERVER ERROR);
  • 503 (SERVICE UNAVAILABLE).

A API de conciliação consiste em uma requisição HTTP autenticada, utilizando uma camada segura - SSL/TLS, para a obtenção de um arquivo com todos os eventos ocorridos no dia requisitado.

Certificado SSL

A comunicação deve utilizar TLS 1.2 de acordo com as normas de PCI

Suggest Edits

Ambientes

 

Sandbox

Hoje ainda não oferecemos um ambiente de teste para integração.

Você pode realizar seus testes utilizando nossos exemplos Exemplo de arquivo completo.

Produção

Uma vez que a etapa de homologação for concluída, você poderá solicitar as credenciais (ClientApplicationKey e SecretKey) dos seus clientes.

O endpoint de produção é:
https://conciliation.stone.com.br/conciliation-file/v2.2/{referenceDate}?affiliationCode={affiliationCode}

Como ter acesso aos dados de conciliação do seu cliente?

Por segurança, não liberamos o acesso aos dados dos clientes diretamente para terceiros.

É necessário que o nosso Cliente solicite diretamente à Stone (por qualquer canal de contato) que o stonecode deles seja liberado para a credencial da Conciliadora. É responsabilidade do Cliente definir quais Conciliadoras terão acesso aos seus dados de conciliação

Suggest Edits

Gerando seu token de acesso

 

Para enviar as solicitações para a API, algumas informações são necessárias:

  1. ClientApplicationKey: Chave pública da aplicação gerada pela Stone.
    O ClientApplicationKey deve ser enviado no cabeçalho da solicitação na chave Authorization

  2. ClientEncryptionString: Chave aleatória que será gerada pela aplicação cliente.
    A ClientEncryptionString deve ser enviada no cabeçalho da solicitação na chave X-Authorization-Raw-Data

  3. Signature: Chave ClientEncryptionString cifrada utilizando a SecretKey fornecida juntamente com a chave pública (ClientApplicationKey) gerada pela Stone.
    A Signature deve ser enviada no cabeçalho da solicitação na chave X-Authorization-Encrypted-Data

HMAC SHA-512

A Signature é um HMAC gerado com algoritmo SHA-512. Deve-se utilizar como String de codificação o ClientEncryptionString juntamente do SecretKey gerado pela Stone.

É possível encontrar diversas plataformas web que geram a conversão HMAC com o algoritimo SHA-512, como, por exemplo, o Freeformatter.

  1. Data de referência: Dia para o qual você deseja solicitar o arquivo. (Formato yyyyMMdd ).
    A data de referência devem ser usadas para completar a URL do endpoint

  2. Código de afiliação Stone: Stone Code do cliente.
    O Stone Code deve ser usado como parametro para completar a URL do endpoint

EXEMPLO

Abaixo segue um exemplo utilizando credenciais inválidas. Após solicitada sua credencial para nossa API de Conciliação V2.2, lhe encaminharemos duas chaves:

Campo
Valor

Chave da aplicação cliente (ClientApplicationKey)

Bearer 21e6a65b-234d-43e4-21r7-6c767890d2qt

Chave secreta da aplicação cliente (SecretKey)

Dre2VsFGTHYqHht0Yi66FTRmLTkzsderFGthbvWQY6RfAtY9

Com essas duas informações em mãos, temos:

Campo
Valor

ClientApplicationKey (authorization)

Bearer 21e6a65b-234d-43e4-21r7-6c767890d2qt

x-authorization-raw-data

String-XPTO

x-authorization-encrypted-data

//No próximo passo vamos demonstrar como gerar essa chave.

StoneCode

123456987

Date

20181112

x-authorization-raw-data

Essa chave é livre e deverá ser mantida em sigilo pelo parceiro. Ex: ChaveParceiroTeste

Neste momento precisamos gerar a chave x-authorization-encrypted-data. Com os seguintes dados:

Campo
Valor

Chave secreta da aplicação cliente (SecretKey)

Dre2VsFGTHYqHht0Yi66FTRmLTkzsderFGthbvWQY6RfAtY9

x-authorization-raw-data

String-XPTO

Algorítimo de criptografia

SHA512

Podemos gerar a chave x-authorization-encrypted-data utilizando bibliotecas, algorítimos específicos ou mesmo por plataformas como: Freeformatter.

Utilizando esses três dados, devemos ter o seguinte dado criptografado:

Campo
Valor

x-authorization-encrypted-data

4b74dc82fc7589e6aafda8fcca1f061b7aee48b48013fd52bb7e8e68bf895504d4544a5d02508f8408a645e8fd8da57582580925be4a353db8e312d87f3897f0

Dessa forma temos todos os dados necessários:

Campo
Valor

ClientApplicationKey (authorization)

Bearer 21e6a65b-234d-43e4-21r7-6c767890d2qt

x-authorization-raw-data

String-XPTO

x-authorization-encrypted-data

4b74dc82fc7589e6aafda8fcca1f061b7aee48b48013fd52bb7e8e68bf895504d4544a5d02508f8408a645e8fd8da57582580925be4a353db8e312d87f3897f0

StoneCode

123456987

Date

20181112

Suggest Edits

Conciliation file

Um simples GET para obter seu arquivo

 
gethttps://conciliation.stone.com.br/conciliation-file/v2.2/referenceDate?affiliationCode=StoneCode
curl --request GET \
  --url 'https://conciliation.stone.com.br/conciliation-file/v2.2/referenceDate?affiliationCode=StoneCode' \
  --header 'authorization: Bearer  82b555b8-3757-4d88-9646-7d0a46aa80e9' \
  --header 'x-authorization-encrypted-data: b926e1e74c00008af22e3eeaad52f8ce808b99276bd6a2de4c6b39a2fd94d31e' \
  --header 'x-authorization-raw-data: Teste'
var request = require("request");

var options = { method: 'GET',
  url: 'https://conciliation.stone.com.br/conciliation-file/v2.2/referenceDate',
  qs: { affiliationCode: 'StoneCode' },
  headers: 
   { 'x-authorization-encrypted-data': 'b926e1e74c00008af22e3eeaad52f8ce808b99276bd6a2de4c6b39a2fd94d31e',
     'x-authorization-raw-data': 'Teste',
     authorization: 'Bearer  82b555b8-3757-4d88-9646-7d0a46aa80e9' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
require 'uri'
require 'net/http'

url = URI("https://conciliation.stone.com.br/conciliation-file/v2.2/referenceDate?affiliationCode=StoneCode")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["authorization"] = 'Bearer  82b555b8-3757-4d88-9646-7d0a46aa80e9'
request["x-authorization-raw-data"] = 'Teste'
request["x-authorization-encrypted-data"] = 'b926e1e74c00008af22e3eeaad52f8ce808b99276bd6a2de4c6b39a2fd94d31e'

response = http.request(request)
puts response.read_body
var data = JSON.stringify(false);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://conciliation.stone.com.br/conciliation-file/v2.2/referenceDate?affiliationCode=StoneCode");
xhr.setRequestHeader("authorization", "Bearer  82b555b8-3757-4d88-9646-7d0a46aa80e9");
xhr.setRequestHeader("x-authorization-raw-data", "Teste");
xhr.setRequestHeader("x-authorization-encrypted-data", "b926e1e74c00008af22e3eeaad52f8ce808b99276bd6a2de4c6b39a2fd94d31e");

xhr.send(data);
import requests

url = "https://conciliation.stone.com.br/conciliation-file/v2.2/referenceDate"

headers = {
    'authorization': "Bearer  82b555b8-3757-4d88-9646-7d0a46aa80e9",
    'x-authorization-raw-data': "Teste",
    'x-authorization-encrypted-data': "b926e1e74c00008af22e3eeaad52f8ce808b99276bd6a2de4c6b39a2fd94d31e"
    }

response = requests.request("GET", url, headers=headers)

print(response.text)
A binary file was returned

You couldn't be authenticated

<?xml version="1.0" encoding="utf-8"?>
<Conciliation>
    <Header>
        <GenerationDateTime>20160613231510</GenerationDateTime>
        <StoneCode>185346049</StoneCode>
        <LayoutVersion>2</LayoutVersion>
        <FileId>0</FileId>
        <ReferenceDate>20160512</ReferenceDate>
    </Header>
    <FinancialTransactions />
    <FinancialEvents />
    <FinancialTransactionsAccounts />
    <FinancialEventAccounts />
    <Payments />
    <Trailer>
        <CapturedTransactionsQuantity>0</CapturedTransactionsQuantity>
        <CanceledTransactionsQuantity>0</CanceledTransactionsQuantity>
        <PaidInstallmentsQuantity>0</PaidInstallmentsQuantity>
        <ChargedCancellationsQuantity>0</ChargedCancellationsQuantity>
        <ChargebacksQuantity>0</ChargebacksQuantity>
        <ChargebacksRefundQuantity>0</ChargebacksRefundQuantity>
        <ChargedChargebacksQuantity>0</ChargedChargebacksQuantity>
        <PaidChargebacksRefundQuantity>0</PaidChargebacksRefundQuantity>
        <PaidEventsQuantity>0</PaidEventsQuantity>
        <ChargedEventsQuantity>0</ChargedEventsQuantity>
    </Trailer>
</Conciliation>
<error>
 <message>
 You must send a value to the reference date param.
 </message>
</error>
<error>
 <message>
 Incorrect authentication values.
 </message>
</error> 
<error>
 <message>
 The service is currently unavaliable to update its data, try again at 5AM Brasilia time.
 </message>
</error> 
<error>
 <message>
 Internal server error.
 </message>
</error> 

Path Params

referenceDate
string
required

Data de referência yyyymmdd

Query Params

affiliationCode
string

Stonecode do cliente

Headers

Authorization
string
required

Chave da sua Aplicação (ClientApplicationKey)

X-Authorization-Raw-Data
string
required

RawString

X-Authorization-Encrypted-Data
string
required

Signature

Accept-Encoding
string

Compactar arquivo de conciliação

 
Suggest Edits

Mensageria de retorno

 

Abaixo estão os possíveis códigos de retorno e o descritivo de cada um.

StatusCode
Mensagem
Descrição

200

OK

Siginifica que sua requisição foi bem sucedida e o recurso GET que foi buscado está transmitido no corpo da mensagem.

400

Bad Request

Você deve enviar um valor para o parâmetro de data de referência.

401

Unauthorized

Valores de autenticação incorretos.

500

Internal Server Error

Significa que o servidor encontrou uma situação que não soube como manipular a informação.

503

Service Unavailable

Atualmente, o serviço não está disponível para atualizar seus dados, tente novamente às 5h, horário de Brasília.

Suggest Edits

Conciliation

Nó principal do arquivo de conciliação

 

O arquivo disponibilizado via API tem uma estrutura de 7 containers, que trazem o detalhamento transacional do cliente de forma estruturada. São eles:

  • Header;
  • FinancialTransactions;
  • FinancialEvents;
  • FinancialTransactionsAccounts;
  • FinancialEventsAccounts;
  • Payments;
  • Trailer.

Abaixo uma explicação sobre cada um dos containers:

Container
Descrição

Header

Contém as informações do lojista e do arquivo

FinancialTransactions

Contém as transações e eventos de transações do dia requisitado

FinancialEvents

Contém os eventos financeiros lançados para o lojista no dia

FinancialTransactionsAccounts

Contém as transações que foram pagas/cobradas ao lojista no dia requisitado

FinancialEventAccounts

Contém os eventos que foram pagos/cobrados ao lojista no dia requisistado

Payments

Contém informações dos pagamentos efetuados relativos as transações e eventos financeiros do arquivo.

Trailer

Contém os totalizadores e contadores do arquivo

Suggest Edits

FinancialTransactions

Descrição dos Containers dentro de FinancialTransactions.

 

Então presentes os seguintes containers em FinancialTransactions, que trazem as transações e eventos de transações do dia requisitado pelo cliente:

  • Transaction
  • Events
  • POI
  • Cancellations
  • Billing
  • Installments
  • Chargeback
  • ChargebackRefund

Abaixo uma explicação sobre cada um dos containers:

Container
Discrição

Transaction

Contém as informações referentes à transação, como valor total, número de parcelas e etc.

Events

Contém contadores dos eventos da transação no dia de referência do arquivo.

POI

Contém dados do Ponto de Interação (terminal) que realizou a transação.

Cancellations

Contém informações referentes aos cancelamentos, como data de desconto do cancelamento e valor total do cancelamento.

Billing

Lista de cobranças relativa ao cancelamento.

Installments

Contém as parcelas da transação.

Chargeback

Contém chargebacks relativos a parcela.

ChargebackRefund

Contém estornos de chargeback relativos a parcela.

Suggest Edits

Transaction

Descrição do Container e atributos dentro de Transaction.

 

Transaction

Nó filho de FinancialTransactions que contém as informações referentes à transação, como valor total, número de parcelas e etc.

Campo
Tipo
Tamanho
Descrição

Events

Container

#

Contém contadores dos eventos da transação no dia de referência do arquivo.

AcquirerTransactionKey

Num

14

Identificador único da transação (NSU) gerado pela adquirente

InitiatorTransactionKey^

Alfa

128

Código recebido pelo sistema cliente

AuthorizationDateTime

Datetime

14

Datetime da autorização (Formato: aaaammddHHmmss)

CaptureLocalDateTime

Datetime

14

Datetime da captura (Formato: aaaammddHHmmss) no horario local da adquirente

International*

Bool

#

Indica se é um cartão internacional (True/False)

Alfa

4

Tipo de conta utilizada na transação crédito, débito, etc…

Alfa

60

Tipo de parcelamento utilizado na transação lojista/emissor

NumberOfInstallments*

Num

4

Número de parcelas

AuthorizedAmount*

Float

20

Valor autorizado

CapturedAmount*

Float

20

Valor capturado

CanceledAmount*

Float

20

Total cancelado

AuthorizationCurrencyCode*

Num

4

Código da moeda de acordo com a ISO 4217

IssuerAuthorizationCode*

Alfa

6

Código da autorização fornecido pelo emissor.

Num

4

Identificador da bandeira do cartão

CardNumber*

Alfa

19

Número do cartão (truncado)

Poi

Container

#

Contém dados do Ponto de Interação (terminal) que realizou a transação

Num

2

Código que identifica o modo de captura da transação

Cancellations **

Container

#

Contém informações referentes aos cancelamentos, como data de desconto do cancelamento e valor total do cancelamento.

Installments

Container

#

Contém as parcelas da transação

Informativo (Transaction)

* Elementos que aparecem apenas quando há um evento de captura (<Captures>1</Captures>)
** Elemento que aparece apenas quando há um evento de de cancelamento (<Cancellations>1</Cancellations>)
^ No caso de BOLETO, o valor do campo InitiatorTransactionKey representa o Nosso Número

Suggest Edits

Events

Descrição dos atributos dentro de Events.

 

Events

Nó que contém contadores dos eventos da transação no dia de referência do arquivo.

Campo
Tipo
Tamanho
Descrição

CancellationCharges

Num

9

Número de descontos de cancelamento

Cancellations

Num

9

Número de cancelamentos

Captures

Num

9

Número de capturas

ChargebackRefunds

Num

9

Número de estornos de chargeback

Chargebacks

Num

9

Número de chargebacks

Payments

Num

9

Número de pagamentos

Suggest Edits

POI

Descrição dos atributos dentro de POI.

 

Poi

Nó que contém dados do Ponto de Interação (terminal) que realizou a transação.

Campo
Tipo
Tamanho
Descrição

Num

4

Tipo do ponto de interação (e-commerce, pos, mobile, etc).

SerialNumber

Alfa

32

Número de série do terminal, se existir

Informativo (POI Tag)

A tag relacionada ao número serial só será enviada nos casos em que o tipo de terminal é credenciado como POS (Ex: <PoiType>1</PoiType>).

Suggest Edits

Cancellations

Descrição do Container e atributos dentro de Cancellations.

 

Cancellations

Contém uma lista de Cancellation

Cancellation

Nó filho de Cancellations que contém as informações sobre o cancelamento de uma transação

Campo
Tipo
Tamanho
Descrição

PaymentId

Num

9

Identificador do Pagamento

OperationKey

Alfa

32

identificador único da operação de cancelamento

InstallmentNumber

Num

2

Parcela a ser descontada

CancellationDateTime

Datetime

14

Data hora do cancelamento (Formato: aaaammddHHmmss)

ReturnedAmount

Float

20

Valor revertido e devolvido ao portador do cartão

Billing *

Container

#

Lista de cobranças relativa ao cancelamento

Informativo (Cancellation)

* Container aparece apenas se a transação não tiver sido cancelada no mesmo dia da captura

Suggest Edits

Billing

Descrição dos atributos dentro de Billing.

 

Billing

Nó que contém a lista de cobranças relativa ao cancelamento.

Campo
Tipo
Tamanho
Descrição

ChargedAmount

Float

20

Valor de desconto do cancelamento (descontado do lojista)

PrevisionChargeDate

Datetime

8

Data prevista para cobrança (Formato: aaaammdd)

Suggest Edits

Installments

Descrição do Container e atributos dentro de Installments.

 

Installments

Contém uma lista de Installment (parcelas)

Installment

Nó filho de Installments que contém as informações sobre as parcelas de uma transação

Campo
Tipo
Tamanho
Descrição

InstallmentNumber

Num

2

Número da parcela

GrossAmount

Float

20

Valor bruto da parcela

NetAmount

Float

20

Valor líquido da parcela

PrevisionPaymentDate *

Datetime

8

Previsão da data de pagamento (Formato: aaaammdd)

SuspendedByChargeback **

Bool

#

Este elemento aparecerá nas parcelas ainda não liquidadas quando uma transação sofrer Chargeback (Nunca aparecerá junto com PrevisionPaymentDate)

Chargeback ^

Container

#

Contém chargebacks relativos a parcela

ChargebackRefund ^^

Container

#

Contém estornos de chargeback relativos a parcela

Informativo (Installment)

* Elemento que aparecerá apenas quando a parcela não estiver suspensa por Chargeback
** Elemento que aparecerá apenas nas parcelas posteriores à parcela que sofreu Chargeback
^ Elemento só aparece quando houver Chargeback
^^ Elemento só aparece quando houver Chargeback > Liquidação do Chargeback > Reapresentação de Chargeback

Suggest Edits

Chargebacks

Descrição dos atributos dentro de Chargebacks.

 

Chargebacks

Contém uma lista de Chargeback

Chargeback

Nó filho de Chargebacks que contém informações sobre o chargeback, como data de desconto, Id do chargeback, data em que ocorreu e etc.

Campo
Tipo
Tamanho
Descrição

PaymentId

Num

9

Identificador do pagamento

Id

Num

10

Identificador do chargeback

Amount

Float

20

Valor do chargeback

Date

Datetime

8

Data em que ocorreu o chargeback. (Formato: aaaammdd)

ChargeDate

Datetime

8

Data em que o chargeback será descontado. (Formato: aaaammdd)

ReasonCode

Num

8

Código de motivo do chargeback informado pelo banco emissor

Suggest Edits

ChargebackRefunds

Descrição dos atributos dentro de ChargebackRefunds.

 

ChargebackRefunds

Contém uma lista de ChargebackRefund

ChargebackRefund

Nó filho de ChargebackRefundsque contém informações sobre a reapresentação do chargeback, como a data em que ocorreu a reapresentação, data de pagamento, etc.

Campo
Tipo
Tamanho
Descrição

PaymentId

Num

9

Identificador do pagamento

Id

Num

10

Identificador da reapresentação do chargeback

Amount

Float

20

Valor da reapresentação do chargeback

Date

Datetime

8

Data em que ocorreu a reapresentação do chargeback. (Formato: aaaammdd)

PaymentDate

Datetime

8

Data em que a reapresentação o chargeback será creditada. (Formato: aaaammdd)

ReasonCode*

Num

8

Código de motivo do chargeback informado pelo banco emissor

Informativo (ReasonCode)

* Este campo pode vir com valor zerado (NULL) uma vez que o motivo de Chargeback seja classificado como Compliance e não é originado pelo banco.

Suggest Edits

FinancialEvents

Descrição do Container dentro de FinancialEvents.

 

Está presente o seguinte container em FinancialEvents, que trás os eventos financeiros lançados para o lojista no dia requisitado pelo cliente.

  • Event

Abaixo uma explicação sobre o container:

Container
Discrição

Event

Contém os detalhes do evento ocorrido

Suggest Edits

Event

Descrição dos atributos dentro de Event.

 

Event

Nó filho de FinancialEvents , descreve os detalhes do evento ocorrido.

Campo
Tipo
Tamanho
Descrição

PaymentId

Num

9

Identificador do pagamento

EventId

Alfa

36

Código identificador do evento

Description

Alfa

60

Descrição do evento

Num

2

Tipo do evento

PrevisionPaymentDate

Date

8

Previsão da data de cobrança

Amount

Float

20

Valor do evento

Linked Merchant*

Num

9

StoneCode do remetente ou destinatário de uma transferência interna

Informativo (Linked Merchant)

* Elemento que aparece quando há uma transferência interna.

Se o arquivo for do lojista que transferiu o dinheiro, o valor será negativo e o LinkedMerchant será o StoneCode do lojista que recebeu a transferência.

Se o arquivo for do lojista que recebeu o dinheiro, o valor será positivo e o LinkedMerchant será o StoneCode do lojista que transferiu o dinheiro.

Suggest Edits

FinancialTransactionsAccounts

Descrição dos Containers dentro de FinancialTransactionsAccounts.

 

Então presentes os seguintes containers em FinancialTransactionsAccounts, que trazem as transações que foram pagas/cobradas ao lojista no dia requisitado pelo cliente:

  • Transaction
  • Cancellations
  • Billing
  • Installments

Abaixo uma explicação sobre cada um dos containers:

Container
Discrição

Transaction

Contém as informações referentes à transação, como valor total, número de parcelas e etc.

Cancellations

Contém informações referentes aos cancelamentos, como data de desconto do cancelamento e valor total do cancelamento.

Billing

Lista de cobranças relativa ao cancelamento.

Installments

Contém as parcelas da transação.

Suggest Edits

Transaction

Descrição do Container e atributos dentro de Transaction.

 

Transaction

Nó filho de FinancialTransactionsAccounts que contém as informações referentes à transação, como valor total, número de parcelas e etc.

Campo
Tipo
Tamanho
Descrição

Events

Container

#

Igual ao descrito em FinancialTransactions

AcquirerTransactionKey

Num

14

Identificador único da transação (NSU) gerado pela adquirente

InitiatorTransactionKey*

Alfa

128

Código recebido pelo sistema cliente

AuthorizationDateTime

Datetime

14

Datetime da autorização (Formato: aaaammddHHmmss)

CaptureLocalDateTime

Datetime

14

Datetime da captura (Formato: aaaammddHHmmss) no horario local da adquirente

Poi

Container

#

Igual ao descrito em FinancialTransactions

Cancellations*

Container

#

Igual ao descrito em FinancialTransactions, com algumas mudanças

Installments

Container

#

Igual ao descrito em FinancialTransactions, com algumas mudanças

Informativo (Transaction)

* Elemento que aparecerá quando houver o desconto de um cancelamento (<CancellationCharges>1</CancellationCharges>)
* No caso de BOLETO, o valor do campo InitiatorTransactionKey representa o Nosso Número**

Alerta

É importante armazenar as informações como IssuerAuthorizationCode, CardNumber, BrandId e etc, durante o evento de captura. Pois quando a transação aparecer em FinancialTransactionsAccounts (liquidação), virá apenas com os NSU para que possa identificar qual transação está sendo paga/descontada.

Suggest Edits

Cancellations

Descrição do Container e atributos dentro de Cancellations.

 

Cancellations

Contém uma lista de Cancellation

Cancellation

Nó filho de Cancellations que contém as informações sobre o desconto de um cancelamento

Campo
Tipo
Tamanho
Descrição

InstallmentNumber

Num

2

identificador único da operação de cancelamento

OperationKey

Alfa

32

Identificador da parcela que foi descontada

CancellationDateTime

Datetime

14

Data hora do cancelamento (Formato: aaaammddHHmmss)

ReturnedAmount

Float

20

Valor revertido e devolvido ao portador do cartão

Billing

Container

#

Lista de cobranças relativa ao cancelamento

Suggest Edits

Billing

Descrição dos atributos dentro de Billing.

 

Billing

Nó que contém a lista de cobranças relativa ao cancelamento.

Campo
Tipo
Tamanho
Descrição

ChargedAmount

Float

20

Valor de desconto do cancelamento (descontado do lojista)

ChargeDate

Datetime

8

Data da cobrança (Formato: aaaammdd)

Suggest Edits

Installments

Descrição dos Containers e atributos dentro de Installments.

 

Installments

Contém uma lista de Installment (parcelas)

Installment

Nó filho de Installments que contém as informações sobre as parcelas de uma transação

Campo
Tipo
Tamanho
Descrição

InstallmentNumber

Num

2

Número da parcela

GrossAmount

Float

20

Valor bruto da parcela

NetAmount

Float

20

Valor liquido da parcela

PaymentDate

Datetime

8

Data de pagamento da parcela. (Formato: aaaammdd)

AdvanceRateAmount*

Float

20

Valor cobrado pela antecipação de recebível

AdvancedReceivableOriginalPaymentDate*

Datetime

8

Data original de pagamento do recebível adiantado

PaymentId

Num

9

Referência do elemento de pagamento (Payments) no qual a liquidação dessa parcela foi incluída

Chargeback^

Container

#

Igual ao descrito em FinancialTransactions

ChargebackRefund^^

Container

#

Igual ao descrito em FinancialTransactions

Informativo (Installment | FinancialTransactionsAccounts)

* Elementos que só aparecem quando houver Antecipação
** Elemento que aparecerá apenas nas parcelas posteriores à parcela que sofreu Chargeback
^ Elemento só aparece quando houver Chargeback > Liquidação do Chargeback
^^ Elemento só aparece quando houver Chargeback > Liquidação do Chargeback > Reapresentação de Chargeback > Liquidação da Reapresentação do Chargeback

Suggest Edits

FinancialEventsAccounts

Descrição do Container dentro de FinancialEventsAccounts.

 

Está presente o seguinte container em FinancialEventsAccounts, que trás os eventos que foram pagos/cobrados ao lojista no dia requisistado pelo cliente.

  • Event

Abaixo uma explicação sobre o container:

Container
Discrição

Event

Contém os detalhes do evento ocorrido

Suggest Edits

Event

Descrição dos atributos dentro de Event.

 

Event

Nó filho de FinancialEventsAccounts, contém as informações dos eventos financeiros pagos ou descontados no dia de referência do arquivo (ajustes financeiros, aluguel de pos, etc…)

Campo
Tipo
Tamanho
Descrição

EventId

Num

10

Código identificador do evento

Description

Alfa

60

Descrição do evento

Type

Num

2

Tipo do evento (Poderá identificar se é uum crédito ou um débito através do sinal. Ex: -22 (Débito), 5 (Crédito)

PaymentDate

Datetime

8

Data em que o evento foi pago. (Formato: aaaammdd)

Amount

Float

20

Valor do evento

Suggest Edits

Payments

Descrição dos Containers e atributos dentro de Payments.

 

Estão presentes os seguintes containers em Payments, que trazem as informações dos pagamentos efetuados relativos as transações e eventos financeiros do arquivo no dia requisitado:

  • Payment
  • FavoredBankAccount

Abaixo uma explicação sobre cada um dos containers:

Container
Discrição

Payment

Contém um pagamento efetuado para o lojista.

FavoredBankAccount

Informações bancárias da conta favorecida pelo pagamento.

Suggest Edits

Payment

Descrição do Container e atributos dentro de Payment.

 

Payment

Nó filho de Payments, representa um pagamento efetuado para o lojista

Campo
Tipo
Tamanho
Descrição

Id*

Num

9

Identificador do pagamento (PaymentId)

Num

2

Identificador do arranjo do pagamento

TotalAmount

Float

20

Valor total depositado na conta do lojista

TotalFinancialAccountsAmount**

Float

24

Valor total que o lojista tem disponível para receber no dia

LastNegativeAmount^

Float

24

Valor negativo que o cliente tem pendente com a Stone

FavoredBankAccount

Container

#

Informações bancárias da conta favorecida pelo pagamento

Informativo (Payments)

* Campo será enviado preenchido somente em dias que houver pagamentos liquidados.

** Quando o valor desse elemento for negativo, o valor total pago no dia ao lojista TotalAmount será zero. (Campo descontinuado do arquivo, será enviado sempre preenchido com 0)

^ Campo será preenchido somente quando o cliente tiver algum valor em aberto com a Stone.

Suggest Edits

FavoredBankAccount

Descrição do Container e atributos dentro de FavoredBankAccount.

 

FavoredBankAccount

Nó filho de Payment. Contém as informações bancárias da conta em que foi feito o depósito.

Campo
Tipo
Tamanho
Descrição

BankCode

Num

4

Código do banco favorecido de acordo com o Banco Central

BankBranch

Alfa

10

Código da agência do banco de acordo com o Banco Central

BankAccountNumber

Num

12

Número da conta favorecida

Suggest Edits

Trailer

Descrição dos atributos dentro de Trailer

 

Estão presentes os totalizadores e contadores do arquivo, contendo as informações dos totais de transações capturadas, canceladas, pagas, cancelamento e etc.:

  • CapturedTransactionsQuantity
  • CanceledTransactionsQuantity
  • PaidInstallmentsQuantity
  • ChargedCancellationsQuantity
  • ChargebacksQuantity
  • ChargebacksRefundQuantity
  • ChargedChargebacksQuantity
  • PaidChargebacksRefundQuantity
  • PaidEventsQuantity
  • ChargedEventsQuantity

Abaixo uma explicação sobre cada um dos atributos:

Campo
Tipo
Tamanho
Descrição

CapturedTransactionsQuantity

Num

9

Número de transações capturada

CanceledTransactionsQuantity

Num

9

Número de transações canceladas

PaidInstallmentsQuantity

Num

9

Número de transações pagas

ChargedCancellationsQuantity

Num

9

Número de cancelamentos descontados

ChargebacksQuantity

Num

9

Número de chargebacks

ChargebacksRefundQuantity

Num

9

Número de estornos de chargeback

ChargedChargebacksQuantity

Num

9

Número de chargebacks descontados

PaidChargebacksRefundQuantity

Num

9

Número de estornos de chargebacks pagos

PaidEventsQuantity

Num

9

Número de eventos financeiros pagos

ChargedEventsQuantity

Num

9

Número de eventos financeiros descontados

Suggest Edits

AccountType

 

Estão presentes as informações de quais os tipos da conta utilizada na transação.

Retornar à FinancialTransactions

Valor
Descrição

1

Debit (Débito)

2

Credit (Crédito)

10

Boleto

Suggest Edits

InstallmentType

 

Estão presentes as informações de qual o tipo de parcelamento foi utilizado na transação.

Retornar à FinancialTransactions

Valor
Descrição

1

À vista lojista

2

Parcelado lojista

3

Parcelado emissor

 

Estão presentes as informações de qual a bandeira foi utilizada na transação.

Retornar à FinancialTransactions

Valor
Descrição

1

Visa

2

MasterCard

3

AMEX

9

Hipercard

171

Elo

Boleto

O BrandId para transações de boleto será composto por 1 + número do banco que emitiu o boleto. Por exemplo: 1033 para boletos emitidos pelo banco Santander.

 

Estão presentes as informações de qual ponto de interação foi utilizado na transação.

Retornar à FinancialTransactions

Valor
Descrição

1

POS

2

MICRO POS

3

TEF

4

ECOMMERCE

Estão presentes os possíveis tipos de eventos dentro do arquivo.

Retornar à FinancialEvents

Valor
Descrição

2

InternalTransfer (Transferência Interna)

5

FinancialAdjustment (Ajuste financeiro)

22

PosRent (Aluguel de POS) até 30/06/2017

3

PosRent (Aluguel de POS) após 01/07/2017

Desconto do Aluguel

O desconto do aluguel é realizado na Bandeira + Tipo (Crédito ou Débito) com maior saldo.

Suggest Edits

EntryMode

 

Estão presentes as informações de qual tipo de meio de captura foi utilizado na transação.

Retornar à EntryMode

Valor
Descrição

1

Chip & Pin

2

Magnetic Stripe Reader

3

Bar Code

4

Optical Character Recognition (OCR)

5

Integrated Circuit Card 1

7

Proximity Payment Using ICC Data

80

ICC Fallback To Magnetic Stripe

81

Electronic Commerce

90

Complete contents of magnetic stripe, track 2 have been read and checked

91

Proximity payment using magnetic stripe data

Suggest Edits

WalletTypeId

 

Estão presentes os identificadores do arranjo de pagamentos utilizado no pagamento.

Retornar à WalletTypeId

1

Movimentos Não Transacionais

2

Visa Débito

3

Visa Crédito

4

Visa Antecipação

5

Mastercard Débito

6

Mastercard Crédito

7

Mastercard Antecipação

8

Hiper Débito

9

Hiper Crédito

10

Hiper Antecipação

11

Elo Débito

12

Elo Crédito

13

Elo Antecipação

15

American Express Crédito

16

American Express Antecipação

17

Boleto

Suggest Edits

Visa ReasonCode

 

A VISA realizou uma mudança em seu sistema de envio de chargebacks, isso resultou na alteração dos valores enviados no campo ReasonCode.

Por isso, fizemos uma alteração neste campo para refletir os novos valores de categoria da VISA. Disponibilizamos um campo adicional chamado dispute_condition que contém o detalhamento dos códigos de chargebacks fornecidos pela VISA.

Segue tabela com os códigos de chargebacks:

ReasonCode
DisputeCondition
ReasonCode Description
DisputeCondition Description

10

1

Fraude

Fraude de falsificação na transferência de responsabilidade EMV

10

2

Fraude

Fraude não cometida com cartão falsificado na transferência de responsabilidade EMV

10

3

Fraude

Outro tipo de Fraude - Ambiente com presença do cartão

10

4

Fraude

Outro tipo de Fraude - Ambiente sem presença do cartão

10

5

Fraude

Programa VISA de monitoramento de fraude

11

1

Autorização

Boletim de recuperação de cartães

11

2

Autorização

Autorização recusada

11

3

Autorização

Sem autorização

12

1

Erro no processamento

Apresentação tardia

12

2

Erro no processamento

Código de transação incorreto

12

3

Erro no processamento

Moeda incorreta

12

4

Erro no processamento

Número de conta incorreto

12

5

Erro no processamento

Valor incorreto

12

6

Erro no processamento

Processamento duplicado/pago por outros meios

12

7

Erro no processamento

Dados inválidos

13

1

Disputa dos consumidores

Serviços não prestados ou mercadoria não recebida

13

2

Disputa dos consumidores

Transação recorrente cancelada

13

3

Disputa dos consumidores

Mercadoria/Serviços defeituosos ou não coincidem com a descrição

13

4

Disputa dos consumidores

Mercadoria falsificada

13

5

Disputa dos consumidores

Declaração enganosa

13

6

Disputa dos consumidores

Crédito não processado

13

7

Disputa dos consumidores

Mercadorias/Serviços cancelados

13

8

Disputa dos consumidores

Transação de crédito original não aceita

13

9

Disputa dos consumidores

Não recebimento de dinheiro ou de valor de transação de carga

Exemplo:

...
<Installment>
    ...
    <Chargebacks>
        <Chargeback>
            ...
            <ReasonCode>10</ReasonCode>
            <DisputeCondition>2</DisputeCondition>
            ...
        </Chargeback>
        ...
    </Chargebacks>
    <ChargebackRefunds>
        <ChargebackRefund>
            ...
            <ReasonCode>10</ReasonCode>
            <DisputeCondition>2</DisputeCondition>
            ...
        </ChargebackRefund>
        ...
    </ChargebackRefunds>
    ...
...
Suggest Edits

Ciclos de vida da captura

 

CAPTURA

Quando uma transação é realizada, um nó Transaction referente à ela aparecerá sob FinancialTransactions no arquivo de conciliação desse dia com o evento Captures com o valor 1 em Event, dentro do nó transaction se encontrará todas as parcelas dessa transação representadas pelos nós Installment.

Exemplos de ciclos de vida da captura:

Captura (10/05) > Liquidação da Parcela (09/06)

Nesse exemplo da aba de Captura, temos o evento Captures com o valor 1, indicando que esse evento ocorreu. Já na aba Liquidação Parcela 1, temos o evento Payments como 1, indicando que essa parcela será paga no dia.

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>1</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <International>True</International>
        <AccountType>2</AccountType>
        <InstallmentType>1</InstallmentType>
        <NumberOfInstallments>1</NumberOfInstallments>
        <AuthorizedAmount>694.000000</AuthorizedAmount>
        <CapturedAmount>694.000000</CapturedAmount>
        <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
        <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
        <BrandId>1</BrandId>
        <CardNumber>411111******1111</CardNumber>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode) <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
            </Installment>
            </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>1</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PaymentDate>20160609</PaymentDate>
                <PaymentId>1234567</PaymentId>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>
...
<Payments>
    <Payment>
        <Id>1234567</Id>
        <WalletTypeId>3</WalletTypeId>
        <TotalAmount>14185.81</TotalAmount>
        <TotalFinancialAccountsAmount>14185.81</TotalFinancialAccountsAmount>
        <LastNegativeAmount>0.00</LastNegativeAmount>
        <FavoredBankAccount>
            <BankCode>XX</BankCode>
            <BankBranch>XXXX</BankBranch>
            <BankAccountNumber>XXXXXXXXX</BankAccountNumber>
        </FavoredBankAccount>
    </Payment>
</Payments>
Suggest Edits

Ciclos de vida do cancelamento

 

CANCELAMENTO

Quando uma transação é cancelada no dia de referência, um nó Transaction referente a ela aparecerá sob FinancialTransactions no arquivo de conciliação desse dia com o evento Cancellations com o valor 1 em Event, dentro do nó Transaction aparecerá um nó chamado Cancellations que descreve cada cancelamento (vários se houver cancelamentos parciais, ou apenas um se for cancelamento total)

Exemplos de ciclos de vida do cancelamento:

Captura (10/05) > Liquidação da Parcela (09/06) > Cancelamento (10/06) > Desconto do Cancelamento (12/06)

Note que no dia 10/06 encaminhamos o aviso sobre a transação cancelada e passamos a data prevista para sensibilizarmos o saldo do lojista.

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>1</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <International>True</International>
        <AccountType>2</AccountType>
        <InstallmentType>1</InstallmentType>
        <NumberOfInstallments>1</NumberOfInstallments>
        <AuthorizedAmount>694.000000</AuthorizedAmount>
        <CapturedAmount>694.000000</CapturedAmount>
        <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
        <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
        <BrandId>1</BrandId>
        <CardNumber>411111******1111</CardNumber>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>1</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PaymentDate>20160609</PaymentDate>
                <PaymentId>1234567</PaymentId>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>
...
<Payments>
    <Payment>
        <Id>1234567</Id>
        <WalletTypeId>3</WalletTypeId>
        <TotalAmount>14185.81</TotalAmount>
        <TotalFinancialAccountsAmount>14185.81</TotalFinancialAccountsAmount>
        <LastNegativeAmount>0.00</LastNegativeAmount>
        <FavoredBankAccount>
            <BankCode>XX</BankCode>
            <BankBranch>XXXX</BankBranch>
            <BankAccountNumber>XXXXXXXXX</BankAccountNumber>
        </FavoredBankAccount>
    </Payment>
</Payments>
<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>1</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Cancellations>
            <Cancellation>
                <InstallmentNumber>1</InstallmentNumber>
                <OperationKey>2276000071307928</OperationKey>
                <CancellationDateTime>20160610040236</CancellationDateTime>
                <ReturnedAmount>694.000000</ReturnedAmount>
                <Billing>
                    <ChargedAmount>678.454400</ChargedAmount>
                    <PrevisionChargeDate>20160613</PrevisionChargeDate>
                </Billing>
            </Cancellation>
        </Cancellations>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>1</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Cancellations>
            <Cancellation>
                <InstallmentNumber>1</InstallmentNumber>
                <OperationKey>2276000071307928</OperationKey>
                <CancellationDateTime>20160610040236</CancellationDateTime>
                <ReturnedAmount>694.000000</ReturnedAmount>
                <Billing>
                    <ChargedAmount>678.454400</ChargedAmount>
                    <ChargeDate>20160613</ChargeDate>
                </Billing>
            </Cancellation>
        </Cancellations>
    </Transaction>
    ...
</FinancialTransactionsAccounts>

Captura (10/05) > Liquidação da Parcela (09/06) > Cancelamento (10/06) > Desconto do Cancelamento (12/06)

Nesse cenário temos o Cancelamento sendo feito após a liquidação da parcela.

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>1</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <International>True</International>
        <AccountType>2</AccountType>
        <InstallmentType>1</InstallmentType>
        <NumberOfInstallments>3</NumberOfInstallments>
        <AuthorizedAmount>1099.000000</AuthorizedAmount>
        <CapturedAmount>694.000000</CapturedAmount>
        <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
        <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
        <BrandId>1</BrandId>
        <CardNumber>411111******1111</CardNumber>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>366.340000</GrossAmount>
                <NetAmount>357.657742</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
            </Installment>
            <Installment>
                <InstallmentNumber>2</InstallmentNumber>
                <GrossAmount>366.330000</GrossAmount>
                <NetAmount>357.647979</NetAmount>
                <PrevisionPaymentDate>20160709</PrevisionPaymentDate>
            </Installment>
            <Installment>
                <InstallmentNumber>3</InstallmentNumber>
                <GrossAmount>366.330000</GrossAmount>
                <NetAmount>357.647979</NetAmount>
                <PrevisionPaymentDate>20160809</PrevisionPaymentDate>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>1</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>366.340000</GrossAmount>
                <NetAmount>357.657742</NetAmount>
                <PaymentDate>20160609</PaymentDate>
                <PaymentId>1234567</PaymentId>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>
...
<Payments>
    <Payment>
        <Id>1234567</Id>
        <WalletTypeId>3</WalletTypeId>
        <TotalAmount>14185.81</TotalAmount>
        <TotalFinancialAccountsAmount>14185.81</TotalFinancialAccountsAmount>
        <LastNegativeAmount>0.00</LastNegativeAmount>
        <FavoredBankAccount>
            <BankCode>XX</BankCode>
            <BankBranch>XXXX</BankBranch>
            <BankAccountNumber>XXXXXXXXX</BankAccountNumber>
        </FavoredBankAccount>
    </Payment>
</Payments>
<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>1</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Cancellations>
            <Cancellation>
                <InstallmentNumber>1</InstallmentNumber>
                <OperationKey>2276000071307928</OperationKey>
                <CancellationDateTime>20160610040236</CancellationDateTime>
                <ReturnedAmount>366.340000</ReturnedAmount>
                <Billing>
                    <ChargedAmount>357.657742</ChargedAmount>
                    <PrevisionChargeDate>20160612</PrevisionChargeDate>
                </Billing>
            </Cancellation>
            <Cancellation>
                <InstallmentNumber>2</InstallmentNumber>
                <OperationKey>2276000071307928</OperationKey>
                <CancellationDateTime>20160610040236</CancellationDateTime>
                <ReturnedAmount>366.330000</ReturnedAmount>
                <Billing>
                    <ChargedAmount>357.647979</ChargedAmount>
                    <PrevisionChargeDate>20160612</PrevisionChargeDate>
                </Billing>
            </Cancellation>
            <Cancellation>
                <InstallmentNumber>3</InstallmentNumber>
                <OperationKey>2276000071307928</OperationKey>
                <CancellationDateTime>20160610040236</CancellationDateTime>
                <ReturnedAmount>366.330000</ReturnedAmount>
                <Billing>
                    <ChargedAmount>357.647979</ChargedAmount>
                    <PrevisionChargeDate>20160612</PrevisionChargeDate>
                </Billing>
            </Cancellation>
        </Cancellations>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>3</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>2</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <!--Aceleração das parcelas-->
            <Installment>
                <InstallmentNumber>2</InstallmentNumber>
                <GrossAmount>366.330000</GrossAmount>
                <NetAmount>357.647979</NetAmount>
                <PaymentDate>20160612</PaymentDate>
                <PaymentId>1234567</PaymentId>
            </Installment>
            <Installment>
                <InstallmentNumber>3</InstallmentNumber>
                <GrossAmount>366.330000</GrossAmount>
                <NetAmount>357.647979</NetAmount>
                <PaymentDate>20160612</PaymentDate>
                <PaymentId>1234567</PaymentId>
            </Installment>
        </Installments>
        <Cancellations>
            <!--Cancelamento das parcelas aceleradas-->
            <Cancellation>
                <InstallmentNumber>1</InstallmentNumber>
                <OperationKey>2276000071307928</OperationKey>
                <CancellationDateTime>20160610040236</CancellationDateTime>
                <ReturnedAmount>366.340000</ReturnedAmount>
                <Billing>
                    <ChargedAmount>357.657742</ChargedAmount>
                    <ChargeDate>20160612</ChargeDate>
                </Billing>
            </Cancellation>
            <Cancellation>
                <InstallmentNumber>2</InstallmentNumber>
                <OperationKey>2276000071307928</OperationKey>
                <CancellationDateTime>20160610040236</CancellationDateTime>
                <ReturnedAmount>366.330000</ReturnedAmount>
                <Billing>
                    <ChargedAmount>357.647979</ChargedAmount>
                    <ChargeDate>20160612</ChargeDate>
                </Billing>
            </Cancellation>
            <Cancellation>
                <InstallmentNumber>3</InstallmentNumber>
                <OperationKey>2276000071307928</OperationKey>
                <CancellationDateTime>20160610040236</CancellationDateTime>
                <ReturnedAmount>366.330000</ReturnedAmount>
                <Billing>
                    <ChargedAmount>357.647979</ChargedAmount>
                    <ChargeDate>20160612</ChargeDate>
                </Billing>
            </Cancellation>
        </Cancellations>
    </Transaction>
    ...
</FinancialTransactionsAccounts>

Aceleração de parcelas

Acima podemos ver o exemplo de um fluxo de Aceleração de parcelas. Ou seja, se eu tenho uma transação de 2 parcelas, e após a liquidação da primeira parcela é enviado um cancelamento, no dia do desconto do cancelamento, é feita a aceleração da liquidação das parcelas restantes para liberar o saldo do cliente. Perceba que a PaymentDate no dia 12/06 foi antecipada.

Captura (10/05) > Cancelamento (10/05)

Quando temos o Cancelamento sendo efetivado no mesmo dia da Captura, temos tanto a flag de Capture como Cancellations habilitadas,

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>1</Cancellations>
            <Captures>1</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <International>True</International>
        <AccountType>2</AccountType>
        <InstallmentType>1</InstallmentType>
        <NumberOfInstallments>3</NumberOfInstallments>
        <AuthorizedAmount>1099.000000</AuthorizedAmount>
        <CapturedAmount>694.000000</CapturedAmount>
        <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
        <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
        <BrandId>1</BrandId>
        <CardNumber>411111******1111</CardNumber>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Cancellations>
            <Cancellation>
                <OperationKey>2316000073093085</OperationKey>
                <CancellationDateTime>20160510104014</CancellationDateTime>
                <ReturnedAmount>694.000000</ReturnedAmount>
            </Cancellation>
        </Cancellations>
    </Transaction>
    ...
</FinancialTransactions>

Captura + cancelamento

Repare que quando o cancelamento é feito no mesmo dia da captura, o nó Billing não aparece, ou seja, não é agendado uma data de desconto do cancelamento.

Suggest Edits

Ciclos de vida do chargeback

 

Chargeback

Quando uma transação sofre chargeback ela aparece tanto em FinancialTransactions no dia em que sofreu o chargeback, e em FinancialTransactionAccounts no dia em que foi descontada

Exemplos de ciclos de vida do Chargeback:

Captura (10/05) > Liquidação da Parcela (09/06) > Chargeback + Desconto do Chargeback (10/06)

Neste momento temos um Chargeback após a liquidação da parcela.

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>1</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <International>True</International>
        <AccountType>2</AccountType>
        <InstallmentType>1</InstallmentType>
        <NumberOfInstallments>1</NumberOfInstallments>
        <AuthorizedAmount>694.000000</AuthorizedAmount>
        <CapturedAmount>694.000000</CapturedAmount>
        <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
        <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
        <BrandId>1</BrandId>
        <CardNumber>411111******1111</CardNumber>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>1</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PaymentDate>20160609</PaymentDate>
                <PaymentId>1234567</PaymentId>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>
...
<Payments>
    <Payment>
        <Id>1234567</Id>
        <WalletTypeId>3</WalletTypeId>
        <TotalAmount>14185.81</TotalAmount>
        <TotalFinancialAccountsAmount>14185.81</TotalFinancialAccountsAmount>
        <LastNegativeAmount>0.00</LastNegativeAmount>
        <FavoredBankAccount>
            <BankCode>XX</BankCode>
            <BankBranch>XXXX</BankBranch>
            <BankAccountNumber>XXXXXXXXX</BankAccountNumber>
        </FavoredBankAccount>
    </Payment>
</Payments>
<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>1</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>187384389</Id>
                        <Amount>678.454400</Amount>
                        <Date>20160610</Date>
                        <ChargeDate>20160610</ChargeDate>
                        <ReasonCode>83</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>

Chargeback após liquidação da parcela

Caso o chargeback ocorra após a liquidação da parcela, ele reaparecerá dentro de Installment e sua liquidação será imediata, sem a necessidade de aparecer novamente dentro de FinancialTransactionsAccounts

Captura (10/05) > Chargeback (20/05) > Liquidação Parcela + Desconto do Chargeback (09/06)

Neste momento temos um Chargeback antes da liquidação da parcela.

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>1</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <International>True</International>
        <AccountType>2</AccountType>
        <InstallmentType>1</InstallmentType>
        <NumberOfInstallments>1</NumberOfInstallments>
        <AuthorizedAmount>694.000000</AuthorizedAmount>
        <CapturedAmount>694.000000</CapturedAmount>
        <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
        <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
        <BrandId>1</BrandId>
        <CardNumber>411111******1111</CardNumber>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>1</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>149222320</Id>
                        <Amount>678.454400</Amount>
                        <Date>20160520</Date>
                        <ChargeDate>20160609</ChargeDate>
                        <ReasonCode>83</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>1</Chargebacks>
            <Payments>1</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>149222320</Id>
                        <Amount>678.454400</Amount>
                        <Date>20160520</Date>
                        <ChargeDate>20160609</ChargeDate>
                        <ReasonCode>83</ReasonCode>
                    </Chargeback>
                </Chargebacks>
                <PaymentId>71385326</PaymentId>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>

Chargeback antes da liquidação da parcela

Caso o Chargeback ocorra antes da liquidação da parcela, o desconto virá no dia do pagamento da parcela, como no exemplo acima. Como o pagamento é igual ao desconto, os dois se anulam.

Captura (10/05) > Chargeback (20/05) > Liquidação Parcela + Desconto do Chargeback (09/06)

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>1</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <International>True</International>
        <AccountType>2</AccountType>
        <InstallmentType>1</InstallmentType>
        <NumberOfInstallments>3</NumberOfInstallments>
        <AuthorizedAmount>1099.000000</AuthorizedAmount>
        <CapturedAmount>694.000000</CapturedAmount>
        <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
        <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
        <BrandId>1</BrandId>
        <CardNumber>411111******1111</CardNumber>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>366.340000</GrossAmount>
                <NetAmount>357.657742</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
            </Installment>
            <Installment>
                <InstallmentNumber>2</InstallmentNumber>
                <GrossAmount>366.330000</GrossAmount>
                <NetAmount>357.647979</NetAmount>
                <PrevisionPaymentDate>20160709</PrevisionPaymentDate>
            </Installment>
            <Installment>
                <InstallmentNumber>3</InstallmentNumber>
                <GrossAmount>366.330000</GrossAmount>
                <NetAmount>357.647979</NetAmount>
                <PrevisionPaymentDate>20160809</PrevisionPaymentDate>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>1</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>366.340000</GrossAmount>
                <NetAmount>357.657742</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                <Chargeback>
                    <Id>149222320</Id>
                    <Amount>357.657742</Amount>
                    <Date>20160520</Date>
                    <ChargeDate>20160609</ChargeDate>
                    <ReasonCode>83</ReasonCode>
                </Chargeback>
            </Installment>
            <Installment>
                <InstallmentNumber>2</InstallmentNumber>
                <GrossAmount>366.330000</GrossAmount>
                <NetAmount>357.647979</NetAmount>
                <Chargeback>
                    <Id>149222321</Id>
                    <Amount>357.657742</Amount>
                    <Date>20160520</Date>
                    <ChargeDate>20160709</ChargeDate>
                    <ReasonCode>83</ReasonCode>
                </Chargeback>
            </Installment>
            <Installment>
                <InstallmentNumber>3</InstallmentNumber>
                <GrossAmount>366.330000</GrossAmount>
                <NetAmount>357.647979</NetAmount>
                <Chargeback>
                    <Id>149222322</Id>
                    <Amount>357.657742</Amount>
                    <Date>20160520</Date>
                    <ChargeDate>20160809</ChargeDate>
                    <ReasonCode>83</ReasonCode>
                </Chargeback>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>1</Chargebacks>
            <Payments>1</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>366.340000</GrossAmount>
                <NetAmount>357.657742</NetAmount>
                <PaymentDate>20160609</PaymentDate>
                <Chargeback>
                    <Id>149222320</Id>
                    <Amount>357.657742</Amount>
                    <Date>20160520</Date>
                    <ChargeDate>20160609</ChargeDate>
                    <ReasonCode>83</ReasonCode>
                </Chargeback>
                <PaymentId>123123</PaymentId>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>

Captura (26/03) > Chargeback (25/06) > Liquidação do Chargeback (24/07)

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>6</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>26208938621004</AcquirerTransactionKey>
        <InitiatorTransactionKey>66a36d2a05211308</InitiatorTransactionKey>
        <AuthorizationDateTime>20180326054446000</AuthorizationDateTime>
        <CaptureLocalDateTime>20180326024447020</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>100.000000</GrossAmount>
                <NetAmount>96.776100</NetAmount>
                <PrevisionPaymentDate>20180425</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>7546450012</Id>
                        <Amount>100.000000</Amount>
                        <Date>20180625</Date>
                        <ChargeDate>20180625</ChargeDate>
                        <ReasonCode>4837</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
            <Installment>
                <InstallmentNumber>2</InstallmentNumber>
                <GrossAmount>100.000000</GrossAmount>
                <NetAmount>96.776100</NetAmount>
                <PrevisionPaymentDate>20180525</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>7546450013</Id>
                        <Amount>100.000000</Amount>
                        <Date>20180625</Date>
                        <ChargeDate>20180625</ChargeDate>
                        <ReasonCode>4837</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
            <Installment>
                <InstallmentNumber>3</InstallmentNumber>
                <GrossAmount>100.000000</GrossAmount>
                <NetAmount>96.776100</NetAmount>
                <PrevisionPaymentDate>20180625</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>7546450014</Id>
                        <Amount>100.000000</Amount>
                        <Date>20180625</Date>
                        <ChargeDate>20180625</ChargeDate>
                        <ReasonCode>4837</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
            <Installment>
                <InstallmentNumber>4</InstallmentNumber>
                <GrossAmount>100.000000</GrossAmount>
                <NetAmount>96.776100</NetAmount>
                <PrevisionPaymentDate>20180724</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>7546450015</Id>
                        <Amount>100.000000</Amount>
                        <Date>20180625</Date>
                        <ChargeDate>20180724</ChargeDate>
                        <ReasonCode>4837</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
            <Installment>
                <InstallmentNumber>5</InstallmentNumber>
                <GrossAmount>100.000000</GrossAmount>
                <NetAmount>96.776100</NetAmount>
                <PrevisionPaymentDate>20180823</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>7546450016</Id>
                        <Amount>100.000000</Amount>
                        <Date>20180625</Date>
                        <ChargeDate>20180823</ChargeDate>
                        <ReasonCode>4837</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
            <Installment>
                <InstallmentNumber>6</InstallmentNumber>
                <GrossAmount>100.000000</GrossAmount>
                <NetAmount>96.776100</NetAmount>
                <PrevisionPaymentDate>20180924</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>7546450017</Id>
                        <Amount>100.000000</Amount>
                        <Date>20180625</Date>
                        <ChargeDate>20180924</ChargeDate>
                        <ReasonCode>4837</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>1</Chargebacks>
            <Payments>1</Payments>
        </Events>
        <AcquirerTransactionKey>26208938621004</AcquirerTransactionKey>
        <InitiatorTransactionKey>66a36d2a05211308</InitiatorTransactionKey>
        <AuthorizationDateTime>20180326054446000</AuthorizationDateTime>
        <CaptureLocalDateTime>20180326024447020</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <Installments>
            <Installment>
                <InstallmentNumber>4</InstallmentNumber>
                <GrossAmount>100.000000</GrossAmount>
                <NetAmount>96.776100</NetAmount>
                <Chargebacks>
                    <Chargeback>
                        <Id>7546450015</Id>
                        <Amount>100.000000</Amount>
                        <Date>20180625</Date>
                        <ChargeDate>20180724</ChargeDate>
                        <ReasonCode>4837</ReasonCode>
                    </Chargeback>
                </Chargebacks>
                <PaymentId>123321</PaymentId>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>

Desangendamento do Chargeback

Chargebacks de desagendamento tem exatamente o mesmo comportamento de chargebacks normais, a diferença é que eles aguardam até o momento de vencimento da parcela para serem descontados.

Suggest Edits

Ciclos de vida do ChargebackRefund

 

ChargebackRefund

Se uma parcela é reapresentada após chargeback ela aparecerá em FinancialTransaction no dia em que foi realizado a reapresentação e em FinancialTransactionsAccounts no dia que for pago ao lojista a reapresentação.

Exemplos de ciclos de vida do ChargebackRefund:

Captura (10/05) > Chargeback (20/05) > Liquidação Parcela + Desconto do Chargeback (09/06) > ChargebackRefund (10/06) > Liquidação ChargebackRefund (11/06)

Nesse caso, temos uma solicitação de Chargeback sendo cancelada e gerando um Refund.

<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>1</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <International>True</International>
        <AccountType>2</AccountType>
        <InstallmentType>1</InstallmentType>
        <NumberOfInstallments>1</NumberOfInstallments>
        <AuthorizedAmount>694.000000</AuthorizedAmount>
        <CapturedAmount>694.000000</CapturedAmount>
        <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
        <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
        <BrandId>1</BrandId>
        <CardNumber>411111******1111</CardNumber>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>1</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>149222320</Id>
                        <Amount>678.454400</Amount>
                        <Date>20160520</Date>
                        <ChargeDate>20160609</ChargeDate>
                        <ReasonCode>83</ReasonCode>
                    </Chargeback>
                </Chargebacks>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>0</ChargebackRefunds>
            <Chargebacks>1</Chargebacks>
            <Payments>1</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PaymentDate>20160609</PaymentDate>
                <Chargebacks>
                    <Chargeback>
                        <Id>149222320</Id>
                        <Amount>678.454400</Amount>
                        <Date>20160520</Date>
                        <ChargeDate>20160609</ChargeDate>
                        <ReasonCode>83</ReasonCode>
                    </Chargeback>
                </Chargebacks>
                <PaymentId>1234567</PaymentId>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>
<FinancialTransactions>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>1</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                <ChargebackRefunds>
                    <ChargebackRefund>
                        <Id>149222320</Id>
                        <Amount>678.454400</Amount>
                        <Date>20160610</Date>
                        <PaymentDate>20160611</PaymentDate>
                        <ReasonCode>83</ReasonCode>
                    </ChargebackRefund>
                </ChargebackRefunds>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
    ...
    <Transaction>
        <Events>
            <CancellationCharges>0</CancellationCharges>
            <Cancellations>0</Cancellations>
            <Captures>0</Captures>
            <ChargebackRefunds>1</ChargebackRefunds>
            <Chargebacks>0</Chargebacks>
            <Payments>0</Payments>
        </Events>
        <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
        <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
        <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
        <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
        <Poi>
            <PoiType>4</PoiType>
        </Poi>
        <EntryMode>1</EntryMode>
        <Installments>
            <Installment>
                <InstallmentNumber>1</InstallmentNumber>
                <GrossAmount>694.000000</GrossAmount>
                <NetAmount>678.454400</NetAmount>
                <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                <ChargebackRefunds>
                    <ChargebackRefund>
                        <Id>149222320</Id>
                        <Amount>678.454400</Amount>
                        <Date>20160610</Date>
                        <PaymentDate>20160611</PaymentDate>
                        <ReasonCode>83</ReasonCode>
                    </ChargebackRefund>
                </ChargebackRefunds>
            </Installment>
        </Installments>
    </Transaction>
    ...
</FinancialTransactionsAccounts>

Atenção

Se com uma mesma transação ocorrer mais de um evento no mesmo dia, apenas um nó Transaction é criado para essa transação e as diversas modificações estarão descritas no nó Events (Ex: Uma transação capturada e cancelada no mesmo dia aparecerá com os nós Captures e Cancellations com o valor diferente de zero)

Suggest Edits

Ciclos de vida do Evento

 

Event

Além das transações do cliente a conciliação contempla eventos financeiros, como aluguéis de POS, ajustes financeiros e transferência interna

Quando ocorre um lançamento de um evento financeiro para o cliente um nó event é criado em FinancialEvents, no dia em que esse evento for pago o mesmo nó aparecerá sob FinancialEventsAccounts

Exemplos de ciclos de vida do Evento:

Evento (10/05) > Liquidação Evento (20/05)

<FinancialEvents>
    ...
    <Event>
        <EventId>53162534</EventId>
        <Description>c</Description>
        <Type>22</Type>
        <PrevisionPaymentDate>20150511</PrevisionPaymentDate>
        <Amount>-99.000000</Amount>
    </Event>
    ...
</FinancialEvents>
<FinancialEventsAccounts>
    ...
    <Event>
        <EventId>53162534</EventId>
        <Description>PosRent</Description>
        <Type>22</Type>
        <PaymentDate>20150511</PaymentDate>
        <Amount>-99.000000</Amount>
    </Event>
    ...
</FinancialEventsAccounts>
Suggest Edits

Arquivo completo

 

Nesse exemplo reunimos diversos cenários que podem ocorrer, por exemplo, Autorização, Cancelamento, Chargeback, Transações Parceladas, Liquidação, etc

<Conciliation>
	<Header>
		<GenerationDateTime>20151013145131</GenerationDateTime>
		<StoneCode>123456789</StoneCode>
		<LayoutVersion>2</LayoutVersion>
		<FileId>020202</FileId>
		<ReferenceDate>20150920</ReferenceDate>
	</Header>
	<FinancialTransactions>
		<Transaction>
			<Events>
				<CancellationCharges>0</CancellationCharges>
				<Cancellations>1</Cancellations>
				<Captures>0</Captures>
				<ChargebackRefunds>0</ChargebackRefunds>
				<Chargebacks>0</Chargebacks>
				<Payments>0</Payments>
			</Events>
			<AcquirerTransactionKey>12345678912356</AcquirerTransactionKey>
			<InitiatorTransactionKey>1117737</InitiatorTransactionKey>
			<AuthorizationDateTime>20150818155931</AuthorizationDateTime>
			<CaptureLocalDateTime>20150818125935</CaptureLocalDateTime>
			<Poi>
				<PoiType>4</PoiType>
			</Poi>
			<EntryMode>1</EntryMode>
			<Cancellations>
				<Cancellation>
					<OperationKey>3635000017434024</OperationKey>
					<CancellationDateTime>20150920034340</CancellationDateTime>
					<ReturnedAmount>20.000000</ReturnedAmount>
					<Billing>
						<ChargedAmount>19.602000</ChargedAmount>
						<PrevisionChargeDate>20150921</PrevisionChargeDate>
					</Billing>
				</Cancellation>
			</Cancellations>
		</Transaction>
    
		<Transaction>
			<Events>
				<CancellationCharges>0</CancellationCharges>
				<Cancellations>0</Cancellations>
				<Captures>1</Captures>
				<ChargebackRefunds>0</ChargebackRefunds>
				<Chargebacks>0</Chargebacks>
				<Payments>0</Payments>
			</Events>
			<AcquirerTransactionKey>12345678912345</AcquirerTransactionKey>
			<InitiatorTransactionKey>1331632</InitiatorTransactionKey>
			<AuthorizationDateTime>20150920030009</AuthorizationDateTime>
			<CaptureLocalDateTime>20150920000010</CaptureLocalDateTime>
			<AccountType>2</AccountType>
			<InstallmentType>1</InstallmentType>
			<NumberOfInstallments>1</NumberOfInstallments>
			<AuthorizedAmount>50.000000</AuthorizedAmount>
			<CapturedAmount>50.000000</CapturedAmount>
			<AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
			<IssuerAuthorizationCode>094736</IssuerAuthorizationCode>
			<International>True</International>
			<BrandId>2</BrandId>
			<CardNumber>132456******1122</CardNumber>
			<Poi>
				<PoiType>4</PoiType>
			</Poi>
			<EntryMode>1</EntryMode>
			<Installments>
				<Installment>
					<InstallmentNumber>1</InstallmentNumber>
					<GrossAmount>50.000000</GrossAmount>
					<NetAmount>49.005000</NetAmount>
					<PrevisionPaymentDate>20151020</PrevisionPaymentDate>
				</Installment>
			</Installments>
		</Transaction>
    <Transaction>
    <Events>
      <CancellationCharges>0</CancellationCharges>
      <Cancellations>0</Cancellations>
      <Captures>0</Captures>
      <ChargebackRefunds>1</ChargebackRefunds>
      <Chargebacks>0</Chargebacks>
      <Payments>0</Payments>
    </Events>
    <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
    <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
    <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
    <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
    <Poi>
      <PoiType>4</PoiType>
    </Poi>
    <EntryMode>1</EntryMode>
    <Installments>
      <Installment>
        <InstallmentNumber>1</InstallmentNumber>
        <GrossAmount>694.000000</GrossAmount>
        <NetAmount>678.454400</NetAmount>
        <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
        <ChargebackRefund>
          <Id>149222320</Id>
          <Amount>678.454400</Amount>
          <Date>20160610</Date>
          <PaymentDate>20160611</PaymentDate>
          <ReasonCode>83</ReasonCode>
        </ChargebackRefund>
      </Installment>
    </Installments>
    </Transaction>
    	<Transaction>
		<Events>
			<CancellationCharges>0</CancellationCharges>
			<Cancellations>0</Cancellations>
			<Captures>0</Captures>
			<ChargebackRefunds>0</ChargebackRefunds>
			<Chargebacks>1</Chargebacks>
			<Payments>0</Payments>
		</Events>
		<AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
		<InitiatorTransactionKey>123456789</InitiatorTransactionKey>
		<AuthorizationDateTime>20160509154748</AuthorizationDateTime>
		<CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
		<Poi>
			<PoiType>4</PoiType>
		</Poi>
		<EntryMode>1</EntryMode>
		<Installments>
                <Installment>
                    <InstallmentNumber>1</InstallmentNumber>
                    <GrossAmount>694.000000</GrossAmount>
                    <NetAmount>678.454400</NetAmount>
                    <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                    <Chargebacks>
                        <Chargeback>
                            <Id>187384389</Id>
                            <Amount>678.454400</Amount>
                            <Date>20160610</Date>
                            <ChargeDate>20160610</ChargeDate>
                            <ReasonCode>83</ReasonCode>
                        </Chargeback>
                    </Chargebacks>
                </Installment>
            </Installments>
	</Transaction>
		<Transaction>
			<Events>
				<CancellationCharges>0</CancellationCharges>
				<Cancellations>1</Cancellations>
				<Captures>1</Captures>
				<ChargebackRefunds>0</ChargebackRefunds>
				<Chargebacks>0</Chargebacks>
				<Payments>0</Payments>
			</Events>
			<AcquirerTransactionKey>36350017433715</AcquirerTransactionKey>
			<InitiatorTransactionKey>1331697</InitiatorTransactionKey>
			<AuthorizationDateTime>20150920033610</AuthorizationDateTime>
			<CaptureLocalDateTime>20150920003610</CaptureLocalDateTime>
			<AccountType>2</AccountType>
			<InstallmentType>1</InstallmentType>
			<NumberOfInstallments>1</NumberOfInstallments>
			<AuthorizedAmount>125.790000</AuthorizedAmount>
			<CapturedAmount>125.790000</CapturedAmount>
			<CanceledAmount>125.790000</CanceledAmount>
			<AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
			<IssuerAuthorizationCode>661137</IssuerAuthorizationCode>
			<International>True</International>
			<BrandId>1</BrandId>
			<CardNumber>123456******1122</CardNumber>
			<Poi>
				<PoiType>4</PoiType>
			</Poi>
			<EntryMode>1</EntryMode>
			<Cancellations>
				<Cancellation>
					<CancellationDateTime>20150920000000</CancellationDateTime>
					<ReturnedAmount>125.790000</ReturnedAmount>
				</Cancellation>
			</Cancellations>
			<Installments>
				<Installment>
					<InstallmentNumber>1</InstallmentNumber>
					<GrossAmount>125.790000</GrossAmount>
					<NetAmount />
				</Installment>
			</Installments>
		</Transaction>
	</FinancialTransactions>
	<FinancialEvents>
		<Event>
			<EventId>29869413</EventId>
			<Description>PosRent</Description>
			<Type>-22</Type>
			<PrevisionPaymentDate>20150923</PrevisionPaymentDate>
			<Amount>-590.000000</Amount>
		</Event>
	</FinancialEvents>
	<FinancialTransactionsAccounts>
		<Transaction>
			<Events>
				<CancellationCharges>0</CancellationCharges>
				<Cancellations>0</Cancellations>
				<Captures>0</Captures>
				<ChargebackRefunds>0</ChargebackRefunds>
				<Chargebacks>0</Chargebacks>
				<Payments>1</Payments>
			</Events>
			<AcquirerTransactionKey>31550012403598</AcquirerTransactionKey>
			<InitiatorTransactionKey>ad50f27deee549b2</InitiatorTransactionKey>
			<AuthorizationDateTime>20150803210946</AuthorizationDateTime>
			<CaptureLocalDateTime>20150803182445</CaptureLocalDateTime>
			<Poi>
				<PoiType>4</PoiType>
			</Poi>
			<EntryMode>1</EntryMode>
			<Installments>
				<Installment>
					<InstallmentNumber>1</InstallmentNumber>
					<GrossAmount>123.440000</GrossAmount>
					<NetAmount>120.354375</NetAmount>
					<PaymentDate>20150920</PaymentDate>
					<PaymentId>109963</PaymentId>
				</Installment>
			</Installments>
		</Transaction>
		<Transaction>
			<Events>
				<CancellationCharges>0</CancellationCharges>
				<Cancellations>0</Cancellations>
				<Captures>0</Captures>
				<ChargebackRefunds>0</ChargebackRefunds>
				<Chargebacks>0</Chargebacks>
				<Payments>1</Payments>
			</Events>
			<AcquirerTransactionKey>31550012405762</AcquirerTransactionKey>
			<InitiatorTransactionKey>f172e42e9aa7446e</InitiatorTransactionKey>
			<AuthorizationDateTime>20150803212449</AuthorizationDateTime>
			<CaptureLocalDateTime>20150803183941</CaptureLocalDateTime>
			<Poi>
				<PoiType>4</PoiType>
			</Poi>
			<EntryMode>1</EntryMode>
			<Installments>
				<Installment>
					<InstallmentNumber>1</InstallmentNumber>
					<GrossAmount>468.400000</GrossAmount>
					<NetAmount>457.533120</NetAmount>
					<PaymentDate>20150920</PaymentDate>
					<PaymentId>109963</PaymentId>
				</Installment>
			</Installments>
		</Transaction>
	</FinancialTransactionsAccounts>
	<FinancialEventAccounts>
		<Event>
			<EventId>38883564</EventId>
			<PaymentId>109863</PaymentId>
			<Description>FinancialAdjustment</Description>
			<Type>5</Type>
			<PaymentDate>20150920</PaymentDate>
			<Amount>900.890000</Amount>
		</Event>
	</FinancialEventAccounts>
	<Payments>
		<Payment>
			<Id>109963</Id>
			<WalletTypeId>3</WalletTypeId>
			<TotalAmount>577.88</TotalAmount>
			<TotalFinancialAccountsAmount>577.88</TotalFinancialAccountsAmount>
			<LastNegativeAmount>0.00</LastNegativeAmount>
			<FavoredBankAccount>
				<BankCode>1</BankCode>
				<BankBranch>24111</BankBranch>
				<BankAccountNumber>0123456</BankAccountNumber>
			</FavoredBankAccount>
		</Payment>
		<Payment>
			<Id>109863</Id>
			<WalletTypeId>1</WalletTypeId>
			<TotalAmount>900.89</TotalAmount>
			<TotalFinancialAccountsAmount>900.89</TotalFinancialAccountsAmount>
			<LastNegativeAmount>0.00</LastNegativeAmount>
			<FavoredBankAccount>
				<BankCode>1</BankCode>
				<BankBranch>24111</BankBranch>
				<BankAccountNumber>0123456</BankAccountNumber>
			</FavoredBankAccount>
		</Payment>
	</Payments>
	<Trailer>
		<CapturedTransactionsQuantity>2</CapturedTransactionsQuantity>
		<CanceledTransactionsQuantity>3</CanceledTransactionsQuantity>
		<PaidInstallmentsQuantity>2</PaidInstallmentsQuantity>
		<ChargedCancellationsQuantity>0</ChargedCancellationsQuantity>
		<ChargebacksQuantity>0</ChargebacksQuantity>
		<ChargebacksRefundQuantity>0</ChargebacksRefundQuantity>
		<ChargedChargebacksQuantity>0</ChargedChargebacksQuantity>
		<PaidChargebacksRefundQuantity>0</PaidChargebacksRefundQuantity>
		<PaidEventsQuantity>1</PaidEventsQuantity>
		<ChargedEventsQuantity>0</ChargedEventsQuantity>
	</Trailer>
</Conciliation>
Suggest Edits

Antecipação

 

Captura de uma transação >> Arquivo de conciliação da data prevista para a antecipação dessa transação.

 <Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>1</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>0</Payments>
	</Events>
	<AcquirerTransactionKey>12580999995211</AcquirerTransactionKey>
	<InitiatorTransactionKey>39d8acc169cd49ac</InitiatorTransactionKey>
	<AuthorizationDateTime>20180125214829</AuthorizationDateTime>
	<CaptureLocalDateTime>20180129194835</CaptureLocalDateTime>
	<International>False</International>
	<AccountType>2</AccountType>
	<InstallmentType>1</InstallmentType>
	<NumberOfInstallments>1</NumberOfInstallments>
	<AuthorizedAmount>29.980000</AuthorizedAmount>
	<CapturedAmount>29.980000</CapturedAmount>
	<AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
	<IssuerAuthorizationCode>038043</IssuerAuthorizationCode>
	<BrandId>2</BrandId>
	<CardNumber>554927******6131</CardNumber>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>29.980000</GrossAmount>
			<NetAmount>29.509314</NetAmount>
			<PrevisionPaymentDate>20180228</PrevisionPaymentDate>
		</Installment>
	</Installments>
</Transaction>
<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>0</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>1</Payments>
	</Events>
	<AcquirerTransactionKey>12580999995211</AcquirerTransactionKey>
	<InitiatorTransactionKey>39d8acc169cd49ac</InitiatorTransactionKey>
	<AuthorizationDateTime>20180125214829</AuthorizationDateTime>
	<CaptureLocalDateTime>20180129194835</CaptureLocalDateTime>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>29.980000</GrossAmount>
			<NetAmount>29.402600</NetAmount>
			<PaymentDate>20180209</PaymentDate>
			<AdvanceRateAmount>0.106714</AdvanceRateAmount>
			<AdvancedReceivableOriginalPaymentDate>20180228</AdvancedReceivableOriginalPaymentDate>
			<PaymentId>27772099</PaymentId>
		</Installment>
	</Installments>
</Transaction>
Suggest Edits

Cancelamento no dia

 

Transação Captura, porém Cancelada no mesmo dia >> Transação cancelada no arquivo da data prevista para pagamento.

<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>1</Cancellations>
		<Captures>1</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>0</Payments>
	</Events>
	<AcquirerTransactionKey>10480929020132</AcquirerTransactionKey>
	<InitiatorTransactionKey>ce15d6751fdb49fa</InitiatorTransactionKey>
	<AuthorizationDateTime>20180104132400</AuthorizationDateTime>
	<CaptureLocalDateTime>20180104112400</CaptureLocalDateTime>
	<International>False</International>
	<AccountType>2</AccountType>
	<InstallmentType>1</InstallmentType>
	<NumberOfInstallments>1</NumberOfInstallments>
	<AuthorizedAmount>4279.060000</AuthorizedAmount>
	<CapturedAmount>4279.060000</CapturedAmount>
	<AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
	<IssuerAuthorizationCode>086788</IssuerAuthorizationCode>
	<BrandId>1</BrandId>
	<CardNumber>407505******3358</CardNumber>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Cancellations>
		<Cancellation>
			<OperationKey>1048000930653812</OperationKey>
			<CancellationDateTime>20180104182533</CancellationDateTime>
			<ReturnedAmount>4279.060000</ReturnedAmount>
			<Billing>
				<ChargedAmount>4214.874100</ChargedAmount>
				<PrevisionChargeDate>20180105</PrevisionChargeDate>
			</Billing>
		</Cancellation>
	</Cancellations>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>4279.060000</GrossAmount>
			<NetAmount>4214.874100</NetAmount>
			<PrevisionPaymentDate>20180105</PrevisionPaymentDate>
			<OriginalPaymentDate>20180205</OriginalPaymentDate>
		</Installment>
	</Installments>
</Transaction>
<FinancialTransactionsAccounts>
	<Transaction>
		<Events>
			<CancellationCharges>1</CancellationCharges>
			<Cancellations>0</Cancellations>
			<Captures>0</Captures>
			<ChargebackRefunds>0</ChargebackRefunds>
			<Chargebacks>0</Chargebacks>
			<Payments>1</Payments>
		</Events>
		<AcquirerTransactionKey>10480929020132</AcquirerTransactionKey>
		<InitiatorTransactionKey>ce15d6751fdb49fa</InitiatorTransactionKey>
		<AuthorizationDateTime>20180104132400</AuthorizationDateTime>
		<CaptureLocalDateTime>20180104112400</CaptureLocalDateTime>
		<Poi>
			<PoiType>4</PoiType>
		</Poi>
		<EntryMode>1</EntryMode>
		<Cancellations>
			<Cancellation>
				<OperationKey>1048000930653812</OperationKey>
				<CancellationDateTime>20180104182533</CancellationDateTime>
				<ReturnedAmount>4279.060000</ReturnedAmount>
				<Billing>
					<ChargedAmount>4214.874100</ChargedAmount>
					<ChargeDate>20180105</ChargeDate>
				</Billing>
			</Cancellation>
		</Cancellations>
		<Installments>
			<Installment>
				<InstallmentNumber>1</InstallmentNumber>
				<GrossAmount>4279.060000</GrossAmount>
				<NetAmount>4214.874100</NetAmount>
				<PaymentDate>20180105</PaymentDate>
				<PaymentId>20722474</PaymentId>
			</Installment>
		</Installments>
	</Transaction>
</FinancialTransactionsAccounts>

Cancelamentos feitos em menos de 1h após a captura, não serão apresentados na Conciliação.

Suggest Edits

Cancelamento antes da liquidação

 

Captura de uma transação >> Arquivo de conciliação da data prevista para pagamento.

<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>1</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>0</Payments>
	</Events>
	<AcquirerTransactionKey>10280923997024</AcquirerTransactionKey>
	<InitiatorTransactionKey>36910568f1f44c29</InitiatorTransactionKey>
	<AuthorizationDateTime>20180102173705</AuthorizationDateTime>
	<CaptureLocalDateTime>20180102153705</CaptureLocalDateTime>
	<International>False</International>
	<AccountType>2</AccountType>
	<InstallmentType>1</InstallmentType>
	<NumberOfInstallments>1</NumberOfInstallments>
	<AuthorizedAmount>306.740000</AuthorizedAmount>
	<CapturedAmount>306.740000</CapturedAmount>
	<AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
	<IssuerAuthorizationCode>035777</IssuerAuthorizationCode>
	<BrandId>1</BrandId>
	<CardNumber>464294******3521</CardNumber>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>306.740000</GrossAmount>
			<NetAmount>302.138900</NetAmount>
			<PrevisionPaymentDate>20180201</PrevisionPaymentDate>
		</Installment>
	</Installments>
</Transaction>
<FinancialTransactionsAccounts>
	<Transaction>
		<Events>
			<CancellationCharges>1</CancellationCharges>
			<Cancellations>0</Cancellations>
			<Captures>0</Captures>
			<ChargebackRefunds>0</ChargebackRefunds>
			<Chargebacks>0</Chargebacks>
			<Payments>1</Payments>
		</Events>
		<AcquirerTransactionKey>10280923997024</AcquirerTransactionKey>
		<InitiatorTransactionKey>36910568f1f44c29</InitiatorTransactionKey>
		<AuthorizationDateTime>20180102173705</AuthorizationDateTime>
		<CaptureLocalDateTime>20180102153705</CaptureLocalDateTime>
		<Poi>
			<PoiType>4</PoiType>
		</Poi>
		<EntryMode>1</EntryMode>
		<Cancellations>
			<Cancellation>
				<OperationKey>1038000927462882</OperationKey>
				<CancellationDateTime>20180103181008</CancellationDateTime>
				<ReturnedAmount>306.740000</ReturnedAmount>
				<Billing>
					<ChargedAmount>302.138900</ChargedAmount>
					<ChargeDate>20180104</ChargeDate>
				</Billing>
			</Cancellation>
		</Cancellations>
		<Installments>
			<Installment>
				<InstallmentNumber>1</InstallmentNumber>
				<GrossAmount>306.740000</GrossAmount>
				<NetAmount>302.138900</NetAmount>
				<PaymentDate>20180104</PaymentDate>
				<PaymentId>20484224</PaymentId>
			</Installment>
		</Installments>
	</Transaction>
</FinancialTransactionsAccounts>	
Suggest Edits

Cancelamento de uma transação após liquidação

 

Captura de uma Transação. >> Pagamento da Transação >> Cancelamento da liquidação referente a transação liquidada anteriormente.

<FinancialTransactions>
  ...
   <Transaction>
            <Events>
                <CancellationCharges>0</CancellationCharges>
                <Cancellations>0</Cancellations>
                <Captures>1</Captures>
                <ChargebackRefunds>0</ChargebackRefunds>
                <Chargebacks>0</Chargebacks>
                <Payments>0</Payments>
            </Events>
            <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
            <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
            <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
            <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
            <International>True</International>
            <AccountType>2</AccountType>
            <InstallmentType>1</InstallmentType>
            <NumberOfInstallments>1</NumberOfInstallments>
            <AuthorizedAmount>694.000000</AuthorizedAmount>
            <CapturedAmount>694.000000</CapturedAmount>
            <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
            <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
            <BrandId>1</BrandId>
            <CardNumber>411111******1111</CardNumber>
            <Poi>
                <PoiType>4</PoiType>
            </Poi>
            <EntryMode>1</EntryMode>
            <Installments>
                <Installment>
                    <InstallmentNumber>1</InstallmentNumber>
                    <GrossAmount>694.000000</GrossAmount>
                    <NetAmount>678.454400</NetAmount>
                    <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                </Installment>
            </Installments>
        </Transaction>
  ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
  ...
    <Transaction>
            <Events>
                <CancellationCharges>0</CancellationCharges>
                <Cancellations>0</Cancellations>
                <Captures>0</Captures>
                <ChargebackRefunds>0</ChargebackRefunds>
                <Chargebacks>0</Chargebacks>
                <Payments>1</Payments>
            </Events>
            <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
            <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
            <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
            <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
            <Poi>
                <PoiType>4</PoiType>
            </Poi>
            <EntryMode>1</EntryMode>
            <Installments>
                <Installment>
                    <InstallmentNumber>1</InstallmentNumber>
                    <GrossAmount>694.000000</GrossAmount>
                    <NetAmount>678.454400</NetAmount>
                    <PaymentDate>20160609</PaymentDate>
                    <PaymentId>1234567</PaymentId>
                </Installment>
            </Installments>
       </Transaction>
    ...
<FinancialTransactionsAccounts>
 ...
<Payments>
        <Payment>            
            <Id>1234567</Id>
            <WalletTypeId>3</WalletTypeId>
            <TotalAmount>14185.81</TotalAmount>
            <TotalFinancialAccountsAmount>14185.81</TotalFinancialAccountsAmount>
            <LastNegativeAmount>0.00</LastNegativeAmount>
            <FavoredBankAccount>
                <BankCode>XX</BankCode>
                <BankBranch>XXXX</BankBranch>
                <BankAccountNumber>XXXXXXXXX</BankAccountNumber>
            </FavoredBankAccount>
        </Payment>
</Payments>
<FinancialTransactionsAccounts>
  ...
    <Transaction>
            <Events>
                <CancellationCharges>1</CancellationCharges>
                <Cancellations>0</Cancellations>
                <Captures>0</Captures>
                <ChargebackRefunds>0</ChargebackRefunds>
                <Chargebacks>0</Chargebacks>
                <Payments>0</Payments>
            </Events>
            <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
            <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
            <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
            <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
            <Poi>
                <PoiType>4</PoiType>
            </Poi>
            <EntryMode>1</EntryMode>
            <Cancellations>
                <Cancellation>
                    <InstallmentNumber>1</InstallmentNumber>
                    <OperationKey>2276000071307928</OperationKey>
                    <CancellationDateTime>20160610040236</CancellationDateTime>
                    <ReturnedAmount>694.000000</ReturnedAmount>
                    <Billing>
                        <ChargedAmount>678.454400</ChargedAmount>
                        <ChargeDate>20160612</ChargeDate>
                    </Billing>
                </Cancellation>
            </Cancellations>
       </Transaction>
    ...
<FinancialTransactionsAccounts>
Suggest Edits

Chargeback antes da liquidação

 

Captura de uma Transação. >> Evento Chargeback de uma Transação. >> Chargeback e Liquidação de uma Transação

Note que na data prevista para a liquidação, temos no arquivo tanto a flag de Payment como de Chargebacks habilitadas.

<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>1</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>0</Payments>
	</Events>
	<AcquirerTransactionKey>11680968943988</AcquirerTransactionKey>
	<InitiatorTransactionKey>c7022bfeafd24930</InitiatorTransactionKey>
	<AuthorizationDateTime>20180116163816</AuthorizationDateTime>
	<CaptureLocalDateTime>20180116143816</CaptureLocalDateTime>
	<International>False</International>
	<AccountType>2</AccountType>
	<InstallmentType>1</InstallmentType>
	<NumberOfInstallments>1</NumberOfInstallments>
	<AuthorizedAmount>2011.660000</AuthorizedAmount>
	<CapturedAmount>2011.660000</CapturedAmount>
	<AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
	<IssuerAuthorizationCode>017357</IssuerAuthorizationCode>
	<BrandId>1</BrandId>
	<CardNumber>498453******2364</CardNumber>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>2011.660000</GrossAmount>
			<NetAmount>1981.485100</NetAmount>
			<PrevisionPaymentDate>20180215</PrevisionPaymentDate>
		</Installment>
	</Installments>
</Transaction>
<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>0</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>1</Chargebacks>
		<Payments>0</Payments>
	</Events>
	<AcquirerTransactionKey>11680968943988</AcquirerTransactionKey>
	<InitiatorTransactionKey>c7022bfeafd24930</InitiatorTransactionKey>
	<AuthorizationDateTime>20180116163816</AuthorizationDateTime>
	<CaptureLocalDateTime>20180116143816</CaptureLocalDateTime>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>2011.660000</GrossAmount>
			<NetAmount>1981.485100</NetAmount>
			<PrevisionPaymentDate>20180215</PrevisionPaymentDate>
			<Chargeback>
				<Id>2040876281</Id>
				<Amount>1981.485100</Amount>
				<Date>20180121</Date>
				<ChargeDate>20180215</ChargeDate>
				<ReasonCode>83</ReasonCode>
			</Chargeback>
		</Installment>
	</Installments>
</Transaction>
<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>0</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>1</Chargebacks>
		<Payments>1</Payments>
	</Events>
	<AcquirerTransactionKey>11680968943988</AcquirerTransactionKey>
	<InitiatorTransactionKey>c7022bfeafd24930</InitiatorTransactionKey>
	<AuthorizationDateTime>20180116163816</AuthorizationDateTime>
	<CaptureLocalDateTime>20180116143816</CaptureLocalDateTime>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>2011.660000</GrossAmount>
			<NetAmount>1981.485100</NetAmount>
			<PaymentDate>20180215</PaymentDate>
			<Chargeback>
				<Id>2040876281</Id>
				<Amount>1981.485100</Amount>
				<Date>20180121</Date>
				<ChargeDate>20180215</ChargeDate>
				<ReasonCode>83</ReasonCode>
			</Chargeback>
			<PaymentId>28092846</PaymentId>
		</Installment>
	</Installments>
</Transaction>
Suggest Edits

Chargeback após liquidação

 

Captura de uma Transação >> Pagamento de uma Transação >> Chargeback Liquidação de uma Transação.

Note que na data prevista para a liquidação, temos no arquivo apenas a flag Chargebacks habilitada.

<FinancialTransactions>
  ...
   <Transaction>
            <Events>
                <CancellationCharges>0</CancellationCharges>
                <Cancellations>0</Cancellations>
                <Captures>1</Captures>
                <ChargebackRefunds>0</ChargebackRefunds>
                <Chargebacks>0</Chargebacks>
                <Payments>0</Payments>
            </Events>
            <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
            <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
            <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
            <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
            <International>True</International>
            <AccountType>2</AccountType>
            <InstallmentType>1</InstallmentType>
            <NumberOfInstallments>1</NumberOfInstallments>
            <AuthorizedAmount>694.000000</AuthorizedAmount>
            <CapturedAmount>694.000000</CapturedAmount>
            <AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
            <IssuerAuthorizationCode>054973</IssuerAuthorizationCode>
            <BrandId>1</BrandId>
            <CardNumber>411111******1111</CardNumber>
            <Poi>
                <PoiType>4</PoiType>
            </Poi>
            <EntryMode>1</EntryMode>
            <Installments>
                <Installment>
                    <InstallmentNumber>1</InstallmentNumber>
                    <GrossAmount>694.000000</GrossAmount>
                    <NetAmount>678.454400</NetAmount>
                    <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                </Installment>
            </Installments>
        </Transaction>
  ...
</FinancialTransactions>
<FinancialTransactionsAccounts>
  ...
    <Transaction>
            <Events>
                <CancellationCharges>0</CancellationCharges>
                <Cancellations>0</Cancellations>
                <Captures>0</Captures>
                <ChargebackRefunds>0</ChargebackRefunds>
                <Chargebacks>0</Chargebacks>
                <Payments>1</Payments>
            </Events>
            <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
            <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
            <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
            <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
            <Poi>
                <PoiType>4</PoiType>
            </Poi>
            <EntryMode>1</EntryMode>
            <Installments>
                <Installment>
                    <InstallmentNumber>1</InstallmentNumber>
                    <GrossAmount>694.000000</GrossAmount>
                    <NetAmount>678.454400</NetAmount>
                    <PaymentDate>20160609</PaymentDate>
                    <PaymentId>1234567</PaymentId>
                </Installment>
            </Installments>
       </Transaction>
    ...
<FinancialTransactionsAccounts>
 ...
<Payments>
        <Payment>            
            <Id>1234567</Id>
            <WalletTypeId>3</WalletTypeId>
            <TotalAmount>14185.81</TotalAmount>
            <TotalFinancialAccountsAmount>14185.81</TotalFinancialAccountsAmount>
            <LastNegativeAmount>0.00</LastNegativeAmount>
            <FavoredBankAccount>
                <BankCode>XX</BankCode>
                <BankBranch>XXXX</BankBranch>
                <BankAccountNumber>XXXXXXXXX</BankAccountNumber>
            </FavoredBankAccount>
        </Payment>
</Payments>
<FinancialTransactions>
  ...
    <Transaction>
            <Events>
                <CancellationCharges>0</CancellationCharges>
                <Cancellations>0</Cancellations>
                <Captures>0</Captures>
                <ChargebackRefunds>0</ChargebackRefunds>
                <Chargebacks>1</Chargebacks>
                <Payments>0</Payments>
            </Events>
            <AcquirerTransactionKey>99960072739732</AcquirerTransactionKey>
            <InitiatorTransactionKey>123456789</InitiatorTransactionKey>
            <AuthorizationDateTime>20160509154748</AuthorizationDateTime>
            <CaptureLocalDateTime>20160510082639</CaptureLocalDateTime>
            <Poi>
                <PoiType>4</PoiType>
            </Poi>
            <EntryMode>1</EntryMode>
            <Installments>
                <Installment>
                    <InstallmentNumber>1</InstallmentNumber>
                    <GrossAmount>694.000000</GrossAmount>
                    <NetAmount>678.454400</NetAmount>
                    <PrevisionPaymentDate>20160609</PrevisionPaymentDate>
                    <Chargeback>
                        <Id>187384389</Id>
                        <Amount>678.454400</Amount>
                        <Date>20160610</Date>
                        <ChargeDate>20160610</ChargeDate>
                        <ReasonCode>83</ReasonCode>
                    </Chargeback>
                </Installment>
            </Installments>
       </Transaction>
    ...
<FinancialTransactions>

Chargeback após liquidação (Transação Parcelada)

Captura da transação >> Pagamentos das parcelas >> Chargeback

<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>1</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>0</Payments>
	</Events>
	<AcquirerTransactionKey>43210911520203</AcquirerTransactionKey>
	<InitiatorTransactionKey>9bbe23c0a1a84cdd</InitiatorTransactionKey>
	<AuthorizationDateTime>20171228213205</AuthorizationDateTime>
	<CaptureLocalDateTime>20171228193205</CaptureLocalDateTime>
	<International>False</International>
	<AccountType>2</AccountType>
	<InstallmentType>2</InstallmentType>
	<NumberOfInstallments>3</NumberOfInstallments>
	<AuthorizedAmount>4940.270000</AuthorizedAmount>
	<CapturedAmount>4940.270000</CapturedAmount>
	<AuthorizationCurrencyCode>986</AuthorizationCurrencyCode>
	<IssuerAuthorizationCode>585029</IssuerAuthorizationCode>
	<BrandId>2</BrandId>
	<CardNumber>552937******1025</CardNumber>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>1646.750000</GrossAmount>
			<NetAmount>1617.108500</NetAmount>
			<PrevisionPaymentDate>20180129</PrevisionPaymentDate>
		</Installment>
		<Installment>
			<InstallmentNumber>2</InstallmentNumber>
			<GrossAmount>1646.760000</GrossAmount>
			<NetAmount>1617.118320</NetAmount>
			<PrevisionPaymentDate>20180226</PrevisionPaymentDate>
		</Installment>
		<Installment>
			<InstallmentNumber>3</InstallmentNumber>
			<GrossAmount>1646.760000</GrossAmount>
			<NetAmount>1617.118320</NetAmount>
			<PrevisionPaymentDate>20180328</PrevisionPaymentDate>
		</Installment>
	</Installments>
</Transaction>
<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>0</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>1</Payments>
	</Events>
	<AcquirerTransactionKey>43210911520203</AcquirerTransactionKey>
	<InitiatorTransactionKey>9bbe23c0a1a84cdd</InitiatorTransactionKey>
	<AuthorizationDateTime>20171228213205</AuthorizationDateTime>
	<CaptureLocalDateTime>20171228193205</CaptureLocalDateTime>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>1646.750000</GrossAmount>
			<NetAmount>1617.108500</NetAmount>
			<PaymentDate>20180129</PaymentDate>
			<PaymentId>24852070</PaymentId>
		</Installment>
	</Installments>
</Transaction>
<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>0</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>1</Payments>
	</Events>
	<AcquirerTransactionKey>43210911520203</AcquirerTransactionKey>
	<InitiatorTransactionKey>9bbe23c0a1a84cdd</InitiatorTransactionKey>
	<AuthorizationDateTime>20171228213205</AuthorizationDateTime>
	<CaptureLocalDateTime>20171228193205</CaptureLocalDateTime>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>2</InstallmentNumber>
			<GrossAmount>1646.760000</GrossAmount>
			<NetAmount>1617.118320</NetAmount>
			<PaymentDate>20180226</PaymentDate>
			<PaymentId>30151961</PaymentId>
		</Installment>
	</Installments>
</Transaction>
<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>0</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>0</Chargebacks>
		<Payments>1</Payments>
	</Events>
	<AcquirerTransactionKey>43210911520203</AcquirerTransactionKey>
	<InitiatorTransactionKey>9bbe23c0a1a84cdd</InitiatorTransactionKey>
	<AuthorizationDateTime>20171228213205</AuthorizationDateTime>
	<CaptureLocalDateTime>20171228193205</CaptureLocalDateTime>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>3</InstallmentNumber>
			<GrossAmount>1646.760000</GrossAmount>
			<NetAmount>1617.118320</NetAmount>
			<PaymentDate>20180328</PaymentDate>
			<PaymentId>37116960</PaymentId>
		</Installment>
	</Installments>
</Transaction>
<Transaction>
	<Events>
		<CancellationCharges>0</CancellationCharges>
		<Cancellations>0</Cancellations>
		<Captures>0</Captures>
		<ChargebackRefunds>0</ChargebackRefunds>
		<Chargebacks>3</Chargebacks>
		<Payments>0</Payments>
	</Events>
	<AcquirerTransactionKey>43210911520203</AcquirerTransactionKey>
	<InitiatorTransactionKey>9bbe23c0a1a84cdd</InitiatorTransactionKey>
	<AuthorizationDateTime>20171228213205</AuthorizationDateTime>
	<CaptureLocalDateTime>20171228193205</CaptureLocalDateTime>
	<Poi>
		<PoiType>4</PoiType>
	</Poi>
	<EntryMode>1</EntryMode>
	<Installments>
		<Installment>
			<InstallmentNumber>1</InstallmentNumber>
			<GrossAmount>1646.750000</GrossAmount>
			<NetAmount>1617.108500</NetAmount>
			<PrevisionPaymentDate>20180129</PrevisionPaymentDate>
			<Chargeback>
				<Id>2461876089</Id>
				<Amount>1617.108500</Amount>
				<Date>20180404</Date>
				<ChargeDate>20180404</ChargeDate>
				<ReasonCode>4837</ReasonCode>
			</Chargeback>
		</Installment>
		<Installment>
			<InstallmentNumber>2</InstallmentNumber> 
			<GrossAmount>1646.760000</GrossAmount>
			<NetAmount>1617.118320</NetAmount>
			<PrevisionPaymentDate>20180226</PrevisionPaymentDate> 
			<Chargeback> 
				<Id>2461876090</Id>
				<Amount>1617.118320</Amount>
				<Date>20180404</Date>
				<ChargeDate>20180404</ChargeDate>
			</Chargeback>
		</Installment>
		<Installment>
			<InstallmentNumber>3</InstallmentNumber>
			<GrossAmount>1646.760000</GrossAmount>
			<NetAmount>1617.118320</NetAmount>
			<PrevisionPaymentDate>20180328</PrevisionPaymentDate> 
			<Chargeback> 
				<Id>2461876091</Id>
				<Amount>1617.118320</Amount>
				<Date>20180404</Date>
				<ChargeDate>20180404</ChargeDate>
			</Chargeback>
		</Installment>
	</Installments>
</Transaction>

A quantidade de Chargebacks no evento se refere à quantidade de parcelas (Installments) que sofreram chargeback

Suggest Edits

FAQ - Perguntas e Respostas

 

O que é Conciliação?

Conciliação é a demonstração de todo o movimento financeiro processado com a adquirente (vendas, recebimentos, cancelamentos, ajustes, chargebacks e taxas), mostrando o valor líquido e bruto de cada movimentação. Você pode fazer também o cruzamento das informações da adquirente com as informações enviadas no extrato bancário.
A conciliação diz a real situação financeira do seu negócio, auxiliando na tomada de decisões importantes.

Como funciona a Conciliação da Stone?

Na Stone os seus arquivos de conciliação são gerados a partir do momento que você começa a transacionar no ambiente de produção. Ou seja, não é necessária nenhuma habilitação específica no cadastro para que isso aconteça.
Os arquivos da Stone são entregues no formato XML e ficam disponíveis no webservice de conciliação. Para baixar os arquivos, você precisa enviar uma requisição para a API de conciliação informando sempre uma data e a affiliation key correspondente à sua loja."

Como faço para começar a usar?

Para receber os arquivos de conciliação da Stone, você já precisa ser um cliente credenciado. Depois disso, é necessário solicitar o seu código AffiliationKey para o seu contato comercial ou para nosso time de Relacionamento com o Cliente, pelo e-mail meajuda@stone.com.br.
Com o código em mãos, você precisa apenas configurar a requisição para baixar os arquivos. Você pode ver mais detalhes sobre como fazer isso na nossa documentação.

O que é AK?

AK é a abreviação de AffiliationKey, que você pode utilizar como uma chave individual para baixar o arquivo de conciliação. Cada loja (ou seja, cada StoneCode) possui uma AffiliationKey correspondente, então essa chave é única e identifica a sua operação, não sendo possível agrupar as informações de diferentes StoneCodes em uma mesma AK.

Posso receber o arquivo no formato posicional ao invés do XML?

Infelizmente não, o formato atual do arquivo de conciliação da Stone é apenas XML.

Existe um limite de tempo para baixar arquivos retroativos?

Não, os arquivos ficam disponíveis por tempo indeterminado na API de conciliação. No endereço da requisição, você pode informar qualquer data para receber o arquivo correspondente, desde que seja de um período no qual a sua loja já estava credenciada na Stone.

Quais são as informações que o arquivo de Conciliação entrega?

O arquivo de Conciliação da Stone demostra todas as transações e eventos ocorridos no dia referenciado, junto com as suas respectivas informações financeiras. O arquivo permite o acompanhamento desde a captura até o pagamento/desconto de cada uma das transações e lançamentos realizados.
Com a Conciliação Stone, você consegue visualizar de forma bastante clara o valor líquido e bruto de cada parcela, o valor líquido e bruto de cancelamentos, quais parcelas da transação foram antecipadas e qual foi o custo da antecipação de cada parcela, além de todas as informações referentes à chargebacks.
O arquivo contempla também eventos financeiros, como aluguéis de POS, ajustes financeiros e transferência interna.

Como identificar uma transação cancelada?

Quando ocorre o cancelamento de uma transação, a tag <Cancellations> dentro do nó Events é preenchida com o valor 1.
Quando ocorre o desconto de um cancelamento, a tag <CancellationCharges> dentro do nó Events é preenchida com o valor 1.

Posso realizar um cancelamento parcial?

Sim, é possível realizar o cancelamento parcial ou total de uma transação, independentemente de ser ou não uma transação parcelada. É possível realizar essa operação com a ajuda do nosso time de Relacionamento com o Cliente, através do e-mail meajuda@stone.com.br, ou através do portal da Stone.

Quais ações podem ser um "evento financeiro"?

O aluguel é enviado como um evento dentro de FinancialEvents. Nesse caso, a tag <Type> é preenchida com o valor 3 (código referente ao evento aluguel) e a tag <Amount> demonstra o valor do aluguel.

É possível enxergar os dados das outras adquirentes neste arquivo?

Não. Cada adquirente é responsável pela apresentação dos seus dados ao cliente final.
Ou seja, a partir do arquivo de Conciliação da Stone é possível enxergar todos os dados transacionais e eventos que passaram pela adquirência da Stone. "

Com qual periodicidade recebo os dados para conciliar?

Os arquivos são disponibilizados diariamente e você pode baixá-los através da API a partir das 4h da manhã do dia posterior ao qual se deseja conciliar.

É gerado algum código único apresentado no arquivo?

Sim, toda transação gera um código único da transação, que é nomeado como AcquirerTransactionKey (também chamado de Stone Id).
No caso da Stone, esse código pode ter até 14 dígitos.

Existe um ambiente de homologação para a conciliação?

Não temos um ambiente de homologação para a conciliação.
Se você estiver em homologação e quiser saber mais sobre este recurso, entre em contato com o nosso time de Integrações através do e-mail integracoes@stone.com.br para que possamos realizar alguns testes em produção com a sua operação.

Existe uma documentação para os termos "próprios" que são mostrados no arquivo de conciliação?

Os termos que aparecem no arquivo de conciliação estão explicados na nossa documentação: http://conciliacao.stone.com.br/v1.0/docs

Quais são as possíveis mensagens de erro?

As mensagens de retorno de erro mais comuns são as três abaixo:

  • "Conciliation generation is only permitted in past dates." ​

    A requisição para obter o arquivo de um determinado dia deve ser feita após as 5:00 da manhã do dia posterior.

  • "Missing or invalid authorization security header"
    Essa mensagem é retornada quando algum campo no header da requisição está incorreto.

  • "Message": "An error has occured."
    Esse erro acontece quando existe alguma indisponibilidade na API de conciliação. Nesses casos, por favor entre em contato com o time de Integrações (integrações@stone.com.br) ou Relacionamento com o Cliente (meajuda@stone.com.br).

Caso você receba um retorno diferente, por favor entre em contato com o time de Integrações pelo e-mail integracoes@stone.com.br para maiores esclarecimentos.

Existem arquivos com transações de venda, porém sem eventos de pagamento?

Sim, existem arquivos que não apresentam nenhum pagamento.
Essa situação ocorre em dias que a sua loja efetuou vendas normalmente, mas não recebeu nenhum pagamento de transações anteriores.

Como é demonstrado o fluxo de uma transação parcelada?

Em uma transação parcelada, o container "Installments", dentro do nó "Transactions", é gerado para cada parcela da transação. Ou seja, para uma transação parcelada em 6 vezes são gerados 6 nós "Installments" e cada um contém a informação de uma parcela.

Quanto tempo as informações para Conciliação demoram para serem disponibilizadas?

As informações são disponibilizadas sempre em D+1. Ou seja, se você realizou uma venda no sexta-feira, poderá ver os dados referentes a ela no arquivo do sábado. É recomendado que o arquivo seja baixado após ás 6h, para garantir que todas as informações do dia anterior estejam carregadas.

É possível passar um período de datas na API de conciliação?

Não, cada requisição baixa o arquivo apenas para um dia. Porém é possível configurar, através de desenvolvimento no seu sistema, uma série de requisições simultâneas para baixar arquivos correspondentes a um período de datas.

É possível obter um arquivo contendo informações de mais de um estabelecimento comercial (Stone Code)?

Não. A requisição é feita informando uma Affiliation Key (AK), que é uma chave única por estabelecimento (StoneCode), ou seja, para cada estabelecimento que se deseja obter um arquivo, é necessário realizar uma chamada diferente, contendo a AK do estabelecimento em questão.

O que fazer se não encontrei transações no arquivo?

Verifique a tag <GenerationDateTime>. Ela informa a data e hora em que o arquivo foi gerado no formato aaaammddHHmmss. A hora de geração é informada com 3 horas a mais, portanto se a hora informada for anterior à 8h da manhã (080000), significa que o arquivo esta sendo gerado antes das 5h da manhã.

Neste caso, passe a realizar a requisição somente após as 5h, e mande um email para integracoes@stone.com.br, solicitando a limpeza do cache, conforme o template sugerido.

Qual é a regra de arredondamento de centavos?

A regra é a seguinte:

  1. Dividir o valor total pela quantidade de parcelas (Por exemplo R$170,03 em 4 parcelas. 170,03/4 = 42,5075);
  2. Arredondar o resultado do item 1 para cima ou para baixo (o valor com duas casas decimais mais próximo. No exemplo acima é 42,51) e atribuir este valor a todas as parcelas, exceto à primeira;
  3. Atribuir o valor restante à primeira parcela (No exemplo acima é 42,50).

Vamos à alguns exemplos:
R$170,03 em 4 parcelas
| 1 | 42.50 |
|---|-------|
| 2 | 42.51 |
| 3 | 42.51 |
| 4 | 42.51 |

R$192,65 em 4 parcelas
| 1 | 48.17 |
|---|-------|
| 2 | 48.16 |
| 3 | 48.16 |
| 4 | 48.16 |

R$550,00 em 4 parcelas
| 1 | 137.50 |
|---|-------|
| 2 | 137.50 |
| 3 | 137.50 |
| 4 | 137.50 |

R$264,56 em 6 parcelas
| 1 | 44.11 |
|---|-------|
| 2 | 44.09 |
| 3 | 44.09 |
| 4 | 44.09 |
| 5 | 44.09 |
| 6 | 44.09 |

Suggest Edits

Fale conosco

Template para solicitações

 

Em caso de dúvidas durante sua integração, encaminhe um e-mail para: integracoes@stone.com.br, com as seguintes informações:

Em caso de problemas ou dúvidas operacionais, encaminhe um e-mail para: alodigital@stone.com.br, com as seguintes informações:

Assunto

  • API Conciliação: [Erro ou Dúvida]

Mensagem

  • Empresa: Nome da empresa ou conciliadora que está realizando a solicitação
  • Stone Code: Caso já esteja credenciado
  • Data: Data ou período dos arquivos que geraram erro ou dúvida
  • Tag: Tag ao qual se refere o erro ou dúvida
  • Descrição: Breve descrição do erro ou dúvida
  • Evidência: Requisição e response, prints, logs, etc
  • Anexo: Arquivo *.xml no qual o erro ou dúvida foi observada

Solicitações fora do template podem ter um tempo de resposta maior por não conterem as informações necessárias para análise.

A bandeiras que não são liquidadas pela Stone não são apresentadas no arquivo de conciliação, neste ponto se enquadram as bandeiras no modelo VAN e os vouchers.

SLA

SLA de antedimento do time de integrações de até 2 dias.

Atenção

Antes de encaminhar um e-mails para o nosso time de atendimento, certifique-se que sua dúvida não está presente na nossa documentação. Simples verificações tornam nosso atendimento mais rápido e eficiente.

Gostaria de se tornar um parceiro Stone?

Favor preencher o seguinte formulário para que nosso time entre em contato com você: clique aqui

Suggest Edits

ChangeLog

 

v2.2

  • Adição do campo Payment ID em Chargebacks, ChargebackRefunds, FinancialEvents e Cancellations;
  • Suporte à liquidação de múltiplos Chargebacks em uma mesma transação;
  • Remoção da suspensão de Chargeback;
  • Suporte aos novos códigos de disputa da bandeira Visa;
  • Melhoria no processo de autenticação;
  • Padronização das mensagens de erro.