Documentación para integrar la plataforma y construir tu adaptación local.
La documentación de Integra está organizada para dos trabajos distintos: integrar los sistemas del PSP y de sus clientes con las APIs, y construir los adaptadores que conectan la plataforma a los rieles del mercado. El acceso se habilita para equipos en evaluación o en integración.
Documentation
Punto de entrada: conceptos, modelo de datos, estados y glosario. Cómo se relacionan clientes, cuentas, operaciones y transacciones.
- Modelo de datos y estados
- Identificadores y referencias
- Errores y códigos
API Reference
Referencia por módulo: rutas, campos, filtros, paginación y ejemplos de solicitud y respuesta.
- Clientes y usuarios
- Cuentas y movimientos
- Operaciones y transacciones
- Archivos, conciliación y reportes
Authentication
Claves por ambiente con alcances, rotación, cabeceras requeridas e idempotencia.
- Alcances y permisos
- Idempotency-Key
- Rotación de claves
Webhooks
Catálogo de eventos, formato, firma y verificación, reintentos, reenvío y buenas prácticas de consumo.
- Catálogo de eventos
- Verificación de firma con ejemplos
- Reintentos y reenvío
Integration Guides
Guías por flujo (dispersión, cobro, transferencia, archivo, conciliación) y la guía de adaptación local: cómo implementar un adaptador de riel sobre los contratos del framework.
- Flujos de negocio de punta a punta
- Guía de adaptación local
- Contratos de adaptador
Environments
Ambiente de pruebas y producción: rutas, credenciales, datos de ejemplo y diferencias de comportamiento.
- Credenciales por ambiente
- Datos de ejemplo
- Promoción a producción
Testing
Cómo probar integraciones y adaptadores: escenarios, simulación de resultados de riel, verificación de eventos y certificación.
- Escenarios de prueba
- Simulación de resultados
- Certificación de adaptadores
Solicitar acceso
Déjanos los datos de tu empresa y del contacto técnico. Habilitamos el acceso a la documentación y al ambiente de pruebas para equipos en evaluación o en integración.
Solicitar accesoPOST /v1/operations
Authorization: Bearer sk_test_••••••••
Idempotency-Key: cust-7781-payroll-2026-09
{
"customer_id": "cus_01J9K2",
"type": "payout",
"currency": "COP",
"items": [
{ "beneficiary": { "id_type": "CC", "id": "1020304050" },
"destination": { "rail": "psp-local:bank-transfer", "account": "4581••••••" },
"amount": 1850000, "reference": "Servicios septiembre" }
],
"workflow": "two-step-approval"
}POST https://psp.example/webhooks/integra
X-Integra-Signature: t=1758037331,v1=6d1f…
{
"id": "evt_01J9K5",
"type": "transaction.confirmed",
"data": {
"transaction_id": "txn_01J9K4",
"operation_id": "op_01J9K3Q8X2",
"rail": "psp-local:bank-transfer",
"rail_reference": "…",
"amount": 1850000, "currency": "COP"
}
}// Lo que el PSP implementa para conectar un riel de su mercado.
// Conceptual: nombres y firmas se entregan en la documentación.
interface RailAdapter {
readonly id: "psp-local:bank-transfer";
submit(tx: TransactionInstruction): Promise<Acknowledgement>;
status(ref: RailReference): Promise<RailState>;
importStatement(file: Statement): Promise<StatementLines>;
}
// Integra llama a submit() cuando la operación queda aprobada
// y actualiza la transacción con lo que el adaptador reporta.Los fragmentos de esta página son ilustrativos. La referencia técnica vinculante es la documentación que se entrega con el acceso.
Solicitar acceso
Déjanos los datos de tu empresa y del contacto técnico. Habilitamos el acceso a la documentación y al ambiente de pruebas para equipos en evaluación o en integración.
Construye y opera tu PSP sobre Integra.
Cuéntanos qué operas hoy y qué rieles necesitas conectar. Te mostramos la plataforma sobre tu caso.