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

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 conciliaçã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:

ContainerDescrição
HeaderContém as informações do lojista e do arquivo.
FinancialTransactionsContém as transações e eventos de transações do dia requisitado
FinancialEventsConté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.