O conteúdo desta página foi extraído na íntegra de Consultar acúmulo de pontos | Desenvolvedores | LATAM Pass.

Consultar acúmulo de pontos

GET

Após uma solicitação de sucesso no método POST, é possível verificar o progresso da ordem através do método GET conforme documentação Swagger Retrieve Accrual GET.

Pelo menos 2 campos são obrigatórios na requisição, que é o partnerIdentifier (é o campo partner.id enviado no POST) e os demais campos ficam a seu critério para realizar a busca, seja por nosso ID ou pelo partner transaction que foi enviado no request do método POST (por favor conferir os campos disponíveis no link Swagger Retrieve Accrual GET).

Segue CURL exemplo para requisição:

curl --location --globoff 
'https://api.latampass.com/sandbox/v1/customer/loyalty/partner/accrual?partner
Identifier=1234\&id=1234\&ffn=1234\&partnerAccrualId=1234\&partnerTransaction
Id=1234\&createdStart=2023-09-01\&createdEnd=2023-09-30\&size=10' \\
--header 'client\_id: {{client\_id}}' \\
--header 'access\_token: {{access\_token}}' \\
--data ''

Segue abaixo exemplo de response de sucesso:

{
    "accruals": [
        {
            "id": 192,
            "correlationId": "bcd48e63-049a-417b-a23b-a98cd0a1b34b",
            "partnerAccrualId": "37fab402-a7cc-451a-8802-ff1c83e1f58d",
            "points": 3000,
            "productId": "001",
            "partnerTransactionId": "50db5dbf-7bbe-4baa-b4be-a3ffaa390a36",
            "partnerOriginDate": "2022-06-19T17:10:36.177-04:00",
            "description": "Blanditiis eius vitae sunt.",
            "ffn": "74613880610",
            "status": "PROCESSED",
            "latamAccrualId": "123456",
            "email": "Odessa99@hotmail.com",
            "createdAt": "2022-07-27T15:49:22.298376-04:00",
            "updatedAt": "2022-07-27T15:49:46.002400-04:00"
        }
    ],
    "totalPages": 1,
    "currentPage": 1,
    "totalItens": 1
}

---

Assincronismo das transações

Nosso processamento é realizado de forma assíncrona por conter diversas orquestrações, por isso, a nossa API possui status transitórios que servem para informar ao consumidor qual progresso da transação. Sendo assim, os status transitórios são importantes somente para acompanhamento e análise. Os status possíveis a serem retornados no endpoint do GET de consulta da transação:

• Status transitórios:
  • ACCRUAL_REQUESTED → Acúmulo solicitado; Status transitório do fluxo.
  • ACCRUED → Acúmulo finalizado; Status transitório do fluxo.
  • ERROR → Transação com erro; (Este status é a sinalização que algum ponto do nosso fluxo teve problema, porém não deve ser considerado como status final, pois em nosso sistema de re-tentativas ele pode ser alterado).
  • MEMBER_ENROLL_REQUESTED → Criação do membro solicitada; Status transitório do fluxo.
  • MEMBER_ENROLLED → Criação do membro finalizada; Status transitório do fluxo.
  • PROCESSING → Início do fluxo quando a transação é recebida;
  • SEARCHING_MEMBER → Busca do membro; Status transitório do fluxo.
• Status finais:
  • CANCELLED → Transação Cancelada; (ESTE É O ÚNICO STATUS A SER CONSIDERADO COMO GATILHO PARA ESTORNO DA TRANSAÇÃO)
  • PROCESSED → Final do fluxo quando a transação é processada com sucesso;

As ordens somente devem ser canceladas e os pontos devolvidos aos clientes em caso da nossa devolutiva de status CANCELLED.

Caso alguma transação não tenha status alterado em 24h vocês podem nos acionar para uma análise.

Portanto enquanto a transação estiver em algum status transitório, ele está sob nossa responsabilidade, tendo inúmeras possibilidades como: atraso no processamento, instabilidade ou erro em alguma parte do nosso fluxo ou nossas integrações, inconsistência de dados do cliente, dentre outras, porém ainda não há uma resolução para o parceiro.

Pedimos que o estorno seja feito somente no status CANCELLED.

---