Ir al contenido

↑↓ navegar ↵ abrir Ctrl↵ nueva pestaña esc cerrar

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.

  1. Tu aplicación envía las transacciones de venta por HTTPS a la API de Rapid
  2. Rapid almacena los datos de la transacción (ítems, cliente, direcciones, pagos, reembolsos)
  3. Las soluciones activas usan estos datos automáticamente cuando hace falta

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 /transactions y POST /transactions/batch sin Prevención ni Disputa activa responden 403 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.

MétodoEndpointDescripción
POST/api/v1/transactionsCrear una transacción
POST/api/v1/transactions/batchCrear varias transacciones (hasta 1000)
GET/api/v1/transactions/:idConsultar una transacción
GET/api/v1/transactions?external_id=Encontrar una transacción por el ID de tu sistema
PATCH/api/v1/transactions/:idActualizar una transacción
DELETE/api/v1/transactions/:idNo disponible: responde 405 (detalles)
https://api.rapidchargeback.com/api/v1

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ímiteValor
Solicitudes por minuto100 por IP
Transacciones por solicitud (batch)1000

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.