Roteiro para teste do endpoint de transações D+0
Este tutorial tem como objetivo conduzir o usuário pelas transações realizadas em um estabelecimento utilizando a API de transações D+0 no ambiente de Sandbox.
GET
/reconciliation/v2/transactions?merchant={merchant}&startDate={startDate}&endDate={endDate}&page={page}&size={size}
Considerações
O valor do campo “merchant” utilizado será sempre “46993945000152” para estes testes. O filtro por data e hora possibilita “navegar” pelas transações realizadas utilizando os parâmetros “startDate” e “endDate” aplicados ao campo “updated-time” com o formato “YYYY-mm-ddTHH:mm”(Exemplo: “2022-06-15T12:56”).
Para testar a API, foi elaborada uma “massa de dados” que abrange registros diversos ao longo do dia 15 de Junho de 2022(2022-06-15).
Exemplos dos tipos de transação
| Tipo | URL |
|---|---|
| Venda crédito autorizada | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T08:56&endDate=2022-06-15T08:58 |
| Venda crédito cancelada | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T09:56&endDate=2022-06-15T09:57 |
| Venda crédito parcelada, financiada pelo estabelecimento(autorizada) | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T10:22&endDate=2022-06-15T10:23 |
| Venda crédito parcelada, financiada pelo emissor(autorizada) | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T10:53&endDate=2022-06-15T10:53 |
| Venda débito autorizada | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T11:12&endDate=2022-06-15T11:13 |
| Venda débito cancelada | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T14:03&endDate=2022-06-15T14:03 |
| Cancelamento de débito autorizado | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T13:30&endDate=2022-06-15T13:32 |
| Venda e-wallet autorizada | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T16:48&endDate=2022-06-15T16:48 |
| Venda e-wallet cancelada | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T23:17&endDate=2022-06-15T23:18 |
| Cancelamento e-wallet autorizado | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T23:26&endDate=2022-06-15T23:26 |
| Venda voucher autorizada | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T23:27&endDate=2022-06-15T23:27 |
| Venda voucher cancelada | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T23:28&endDate=2022-06-15T23:28 |
| Cancelamento voucher autorizado | /reconciliation/v2/transactions?merchant=46993945000152&startDate=2022-06-15T23:30&endDate=2022-06-15T23:30 |
Sugestão de extração diária em dois períodos
É possível, como exemplo, realizar duas extrações abrangendo partes distintas do dia, como das 00:00H até 11:59H e depois 12:00H até 23:59H:
Paginação
A fim de testar a paginação da API é possível reduzir o número de transações por página, adicionando o parâmetro size à URL. No caso abaixo o parâmetro size foi estipulado em 5, obtendo 6 páginas com 5 registros e a última com um registro apenas, totalizando 7 páginas, já que o total de registros para este dia é de 31:
Updated almost 2 years ago