Novidades da API
Mudanças na API de integração, da mais recente para a mais antiga. Mudança só no painel não entra aqui.
Outubro de 2026: nova API
Seção intitulada “Outubro de 2026: nova API”A versão atual da API, que substitui a do sistema anterior. Se você já integrava com a Rapid, esta é a lista do que muda.
- API de Transações em
/api/v1/transactions: criar, enviar em lote (até 1000 por chamada), consultar pelo ID da Rapid ou pelo ID do seu sistema, atualizar e deletar. - Listar merchants, para achar o
merchant_idpela API. - Consultar alertas com filtros (status, datas, cartão, ID do provedor) e paginação.
- Atualizar status do alerta em
PATCH /api/v1/chargeback-alert/alerts/:id/status. - Webhook no formato
v2: entrega assinada com HMAC-SHA256 e timestamp, evento identificado no corpo e no header, e um canal só para todos os produtos. - Evidência e Captura, que alimentam a defesa da Disputa.
- Erros num formato único em toda a API, inclusive em rota que não existe (
404 NOT_FOUND). Omessagevem em inglês; decida pelocode(ver Códigos de resposta). - Ferramentas para devs: a documentação no seu assistente de IA (MCP), em Markdown e em
llms.txt, e a coleção do Postman.
- Webhook só em HTTPS e em endereço público de internet. Redirecionamento que troca o POST por GET (
301,302,303) não é seguido. Ver Retries e logs. - Limite de requisições por IP, contado também nas respostas
401, comRetry-Afterno429. Ver Códigos de resposta. - Retentativas do webhook com intervalos definidos. Ver Retries e logs.
Continua funcionando, do sistema anterior
Seção intitulada “Continua funcionando, do sistema anterior”Mantidos para quem já integrava, sem mudança do seu lado. Para integração nova, use os endpoints da coluna da direita.
| Do sistema anterior | Use em integração nova |
|---|---|
POST /chargeback-alert/update/status | PATCH /api/v1/chargeback-alert/alerts/:id/status |
POST /chargeback-alert/get | GET /api/v1/chargeback-alert/alerts |
Webhook no formato legacy, com clientid/clientkey | Webhook no formato v2, com assinatura |
Esses endpoints antigos serão removidos quando não houver mais chamadas a eles.
Sem equivalente
Seção intitulada “Sem equivalente”A API de Transações do sistema anterior (/transactions/create, /transactions/update e /transactions/delete, sem /api/v1) não existe na nova API. Mudaram o caminho e os campos: a integração precisa passar para a API de Transações nova.