Visão geral
A API de Evidência registra, numa transação já enviada à Rapid, os fatos que sustentam uma defesa: aceite de termos, acesso ao produto, confirmação de entrega, uso e comunicação com o cliente.
É um canal de entrada: você chama a Rapid. O registro fica anexado à transação e é usado na montagem da defesa quando aquela transação vira disputa.
O que ela não é
Seção intitulada “O que ela não é”- Não é upload de arquivo. Cada evidência é um registro JSON com teto de 32 KB. Comprovante em PDF, print e contrato ficam na biblioteca de evidências do painel, não aqui.
- Não cria transação. A transação precisa existir antes, enviada pela API de Transações. Se não existir, a chamada volta
404 TRANSACTION_NOT_FOUND.
Fluxo resumido
Seção intitulada “Fluxo resumido”- Você envia a transação de venda pela API de Transações
- No seu sistema acontece algo que sustenta a venda: o cliente aceitou os termos, acessou o produto, recebeu a entrega
- Você registra esse fato com
POST /evidence, apontando para a transação - Se aquela transação virar disputa, a Rapid usa os registros na defesa
Autenticação
Seção intitulada “Autenticação”Basic Auth com client_id:client_secret, igual aos outros canais. Ver Autenticação.
Endpoints
Seção intitulada “Endpoints”| Endpoint | O que faz |
|---|---|
POST /evidence | Registra uma evidência numa transação |
GET /evidence | Lista as evidências de uma transação |