Integração feita por terceiros

Para quando a integração for realizada por uma equipe externa

Nessa modalidade, a equipe da Troque & Devolva atua como suporte, oferecendo toda a ajuda necessária para que os desenvolvedores da sua plataforma realizem a integração com o nosso sistema

Requisitos mínimos para integração

Sua equipe técnica deverá desenvolver e disponibilizar os seguintes endpoints:

• Consulta de pedidos por número, e-mail ou CPF

• Criação e consulta de cupons de desconto, utilizados como vale-trocas (opcional, mas recomendado)

• Criação de reembolsos, parciais ou totais (opcional)

Abaixo, explicamos como a integração funciona em detalhes.

Instruções gerais

Utilizamos JSON como formato padrão nas integrações. Tanto o payload enviado quanto a resposta recebida devem estar estruturados em JSON.

Códigos de status HTTP esperados:

• 200 – Requisição processada com sucesso

• 201 – Vale-trocas criado com sucesso

• 400 – Erro na requisição (ex: dados inválidos)

Formato esperado da resposta:

{
  "success": true,
  "message": "Mensagem opcional",
  "data": { /* conteúdo da resposta */ },
}

Em caso de erro:

{
  "success": false,
  "message": "Descrição do erro"
}