Visão geral

A integração com Repasso Cursos se dá por meio de requisições HTTP em que estão disponíveis endpoints que permitem fazer a troca de info produtos entre dois alunos.

Todas requisições devem ser realizadas no seguinte endereço da API: https://login.xgrow.com no respectivo caminho de cada endpoint detalhado abaixo

Header de autenticação

Todas as requisições devem obrigatoriamente conter o header X-Repasso-Cursos-Token com o respectivo token para que as requisições sejam válidas.

Realizando a troca de um produto de um aluno para outro

Para obter o order code confira o passo a passo em Obtendo order code

Realiza a troca de uma curso de um aluno de origem possuidor do curso para o aluno de destino, atual detentor do curso. Ao realizar a troca disparar os respectivos acessos ao novo aluno e cancelar os produtos da venda do aluno de origem removendo o acesso.

POST /api/webhooks/repasso-cursos/subscribers/swap
{
  "order_code": "D24NTRTOQ6",
  "student_from": "student_from@email.com",
  "student_to": "student_to@email.com",
  "name_to": "Nome do aluno",
  "document_to": "012.345.678-90",
  "phone_to": "(99) 99999-9999",
  "address_to": "Avenida Principal 123"
}

Parâmetro	Obrigatoriedade	Tipo	Descrição

Parâmetro	Obrigatoriedade	Tipo	Descrição
order_code	Obrigatório	String	Curso
student_from	Obrigatório	String	Email do Aluno Origem
student_to	Obrigatório	String	Email do Aluno Destino
name_to	Obrigatório	String	Nome do Aluno de Destino
document_to	Opcional	String	Documento do Aluno de Destino
phone_to	Opcional	String	Telefone do Aluno de Destino
address_to	Opcional	String	Endereço do Aluno de Destino

Critérios de aceitação

Endpoints com caminho especifico para a repasso (Ser restrito o caminho no WAF para somente requisições dos servidores da repasso)
Middleware específico semelhante a General bank com uma chave especifica para a Repasso para liberar acesso aos endpoints
Toda interação com alunos deve ser registrado tanto no log para conferencia quanto no nas respectivas tabelas (ex subscribers.source) para identificar facilmente nos logs ou no motivo de cancelamento do produto

Exemplo de Log

Os logs poderão ser encontrados no Log Explorer ou Cloud Watch ou ferramenta semelhantes seguindo o padrão abaixo:

{
    "path": "/api/webhooks/repasso-cursos/subscribers/swap",
    "method": "POST",
    "ip": "192.168.1.10",
    "http_version": "HTTP/1.1",
    "timestamp": "2025-03-25 14:45:30",
    "headers": {
        "user-agent": "axios/1.7.7",
        "referer": null,
        "origin": null,
        "accept": "application/json, text/plain, */*",
        "content-type": "application/json",
        "accept-encoding": "gzip, compress, deflate, br",
        "x-repasso-cursos-token": <TOKEN>
    },
    "request": {
        "order_code": "D24NTRTOQ6",
        "student_from": "45ff6a037600d61@dev.xgrow",
        "student_to": "student_to@email.com",
        "name_to": "Nome do aluno",
        "document_to": "012.345.678-90",
        "phone_to": "(99) 99999-9999",
        "address_to": "Avenida Principal 123"
    },
    "response": {
        "success": true,
        "message": "Sucesso"
    }
}

Respostas da API

Exemplo de Falha quando o aluno de destino já possuir o curso, outro erro similar poderá acontecer caso o aluno alvo não possua o curso informado.

Exemplo de Falha, de quando o aluno já possui o curso escolhido no corpo da requisição

Exemplo de Falha, de quando o aluno não é o comprador do curso escolhido no corpo da requisição

Exemplo de Falha, de quando ambos os alunos são iguais no corpo da requisição

Exemplo de Sucesso, quando todos os passos forem cumpridos e de acordo com os critérios pré-estabelecidos.

Documentações