Visão geral

A API de Transações permite que você envie, consulte, atualize e remova transações de venda da sua empresa na plataforma Rapid. Essas transações são utilizadas pelas soluções contratadas para proteger seu negócio contra disputas e chargebacks.

Como funciona

1. Sua aplicação envia as transações de venda via HTTPS para a API da Rapid
2. A Rapid armazena os dados da transação (itens, cliente, endereços, pagamentos, reembolsos)
3. As soluções ativas utilizam esses dados automaticamente quando necessário

Endpoints disponíveis

Método	Endpoint	Descrição
POST	/api/v1/transactions	Criar uma transação
POST	/api/v1/transactions/batch	Criar múltiplas transações (até 1000)
GET	/api/v1/transactions/:id	Consultar uma transação
GET	/api/v1/transactions?external_id=	Achar uma transação pelo ID do seu sistema
PATCH	/api/v1/transactions/:id	Atualizar uma transação
DELETE	/api/v1/transactions/:id	Deletar uma transação

Base URL

https://api.rapidchargeback.com/api/v1

Autenticação

Todas as requisições exigem autenticação via Basic Auth:

Authorization: Basic base64(client_id:client_secret)

Credencial	Descrição
client_id	ID da sua empresa (fornecido pela Rapid)
client_secret	Chave secreta da sua empresa (fornecida pela Rapid)

Exemplo de header:

Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=

Limites

Limite	Valor
Requisições por minuto	100 por IP
Transações por requisição (batch)	1000

Proteção de imutabilidade

Transações que já foram utilizadas por alguma solução (ex: consultadas pela Prevenção) não podem ser alteradas ou deletadas. Nesse caso, a API retorna 409 Conflict.

Transações que ainda não foram utilizadas podem ser livremente atualizadas ou deletadas.