Visión general
La API de Transacciones te permite enviar, consultar y actualizar las transacciones de venta de tu empresa en la plataforma Rapid. Las transacciones no se pueden eliminar: toda transacción que envías queda registrada, porque es la base de las soluciones y del historial. Las soluciones contratadas usan estas transacciones para proteger tu negocio contra disputas y contracargos.
Cómo funciona
Sección titulada «Cómo funciona»- Tu aplicación envía las transacciones de venta por HTTPS a la API de Rapid
- Rapid almacena los datos de la transacción (ítems, cliente, direcciones, pagos, reembolsos)
- Las soluciones activas usan estos datos automáticamente cuando hace falta
Quién envía transacciones
Sección titulada «Quién envía transacciones»La transacción es el insumo de Prevención, que responde al banco emisor con los datos del pedido, y de Disputa, que arma la defensa con ellos. Por eso, crear transacciones exige que uno de esos dos productos esté activo en tu empresa:
POST /transactionsyPOST /transactions/batchsin Prevención ni Disputa activa responden403 PRODUCT_NOT_ACTIVE- Si tu empresa usa solo Alerta, no necesitas enviar transacciones
- Consultar y actualizar siguen disponibles para las transacciones que ya enviaste
Para activar Prevención o Disputa, contrátalas en el panel o habla con soporte.
Endpoints disponibles
Sección titulada «Endpoints disponibles»| Método | Endpoint | Descripción |
|---|---|---|
| POST | /api/v1/transactions | Crear una transacción |
| POST | /api/v1/transactions/batch | Crear varias transacciones (hasta 1000) |
| GET | /api/v1/transactions/:id | Consultar una transacción |
| GET | /api/v1/transactions?external_id= | Encontrar una transacción por el ID de tu sistema |
| PATCH | /api/v1/transactions/:id | Actualizar una transacción |
| DELETE | /api/v1/transactions/:id | No disponible: responde 405 (detalles) |
Base URL
Sección titulada «Base URL»https://api.rapidchargeback.com/api/v1Autenticación
Sección titulada «Autenticación»Todas las solicitudes usan Basic Auth con el client_id y el client_secret generados en el panel. Cómo generarlos y enviarlos está en Autenticación.
Authorization: Basic base64(client_id:client_secret)Límites
Sección titulada «Límites»| Límite | Valor |
|---|---|
| Solicitudes por minuto | 100 por IP |
| Transacciones por solicitud (batch) | 1000 |
Protección de inmutabilidad
Sección titulada «Protección de inmutabilidad»Las transacciones que ya fueron usadas por alguna solución (ej.: consultadas por la Prevención) no se pueden modificar. En ese caso, el PATCH devuelve 409 Conflict (TRANSACTION_IMMUTABLE).
Las transacciones que todavía no fueron usadas se pueden actualizar libremente.
Ninguna transacción se puede eliminar, usada o no: el DELETE responde 405 TRANSACTION_DELETE_NOT_ALLOWED. Ver Eliminar transacción.