Servicios de integración API Rextie (OpenFinance USD/PEN)

Lista de entregables

• Especificación de la API en formato OpenAPI 3.1 (Swagger)
• Reporte de protocolo que cubre el handshake de autenticación, vida útil del token, firma de solicitudes y flujo de desafío 2FA
• Código fuente ejecutable (Python y Node.js) para login, consulta de tipo, creación de operación y exportación de estados
• Colección Postman con perfiles de sandbox y producción
• Pruebas automatizadas, trazas de replay y un dashboard BI de muestra alimentado por el endpoint de operaciones
• Dossier de cumplimiento que cubre la Ley de Protección de Datos Personales del Perú (29733), las expectativas de la SBS y el mapeo de controles ISO 27001

Módulos de funcionalidades en un vistazo

• Espejado de Login y KYC — Validación de DNI/RUC, sesión tipo OAuth, refresh y revocación; usado para respaldar dashboards de call-center y tesorería.
• Creación de operación — Bloqueo de cotización, monto, banco origen, banco destino, carga de voucher; usado para enrutamiento STP de órdenes desde un ERP.
• Estados y exportación — Historial paginado con filtro por estado; usado para conciliación mensual, auditoría y reportes tributarios.
• Inteligencia de tipo de cambio — Mid de compra/venta, spread vs. interbancario, series históricas; usado para construir dashboards de pricing y cobertura.
• APIs PYME y corporativas — Roles multi-usuario, umbrales de aprobación y cotizaciones respaldadas por CitiFX Pulse para corporativos.
• Notificaciones y widgets — Paridad de feeds para reloj y widget, eventos push al fondear y liquidar.

1. Conciliación de tesorería para PYME

Un importador con sede en Lima liquida facturas de proveedores semanalmente. Su ERP dispara una operación Rextie a través de nuestra API, bloquea la cotización, transfiere PEN desde el BCP y recibe USD en Interbank. El endpoint de operaciones retroalimenta al ERP cada noche para que contabilidad pueda enlazar el ID de la operación con la factura del proveedor. Esto se mapea al patrón OpenFinance de "iniciación de pago + historial de transacciones".

2. Dashboard de tipo de cambio en tiempo real

Un holding peruano de e-commerce agrega el bid/ask publicado por Rextie junto con los tipos de referencia del BCRP y las cotizaciones spot de BCP/BBVA para impulsar un dashboard de cobertura. El feed de tipos se consulta por polling o suscripción, se normaliza en un único esquema de series temporales y se expone como una API interna. Es un ángulo OpenData clásico: el dato es público pero se consume a escala.

3. Pipeline de cumplimiento y auditoría

Un auditor externo necesita cada cambio USD/PEN de un cliente regulado de los últimos 24 meses, incluyendo banco contraparte, tipo aplicado y voucher. Nuestra exportación de operaciones devuelve JSON paginado más PDFs firmados, con registros de consentimiento que satisfacen las nuevas obligaciones del Decreto Supremo N.° 016-2024-JUS sobre brechas de datos y DPO.

4. Portal corporativo multi-usuario

Un equipo de tesorería corporativa cuenta con tres aprobadores y un iniciador. Nuestra integración espeja el flujo empresarial de roles de Rextie: un analista crea la operación, un CFO aprueba por encima del umbral y se honra el pricing respaldado por CitiFX Pulse. Todos los pasos emiten webhooks para que el portal interno de la empresa pueda mostrar el estado sin polling.

5. Pagos y desembolsos a freelancers

Una plataforma que paga a freelancers peruanos en USD usa Rextie como rampa de salida: las facturas se agrupan en lote, se cambian a PEN a una cotización bloqueada y se desembolsan al banco de cada freelancer. Nuestra integración cubre la creación del lote, los webhooks de liquidación y los recibos por destinatario para que la plataforma pueda registrar cada pago en su libro mayor.

1. Autorización y sesión

POST /api/v1/rextie/auth/login
Content-Type: application/json

{
  "document_type": "DNI",
  "document_number": "********",
  "password": "********",
  "device_fingerprint": "ua:android-13;app:6.x"
}

200 OK
{
  "access_token": "eyJhbGciOi...",
  "refresh_token": "rfk_...",
  "expires_in": 3600,
  "user": { "id": "usr_8821", "type": "business", "ruc": "20*********" }
}

2. Estados / historial de operaciones

GET /api/v1/rextie/operations?from=2026-04-01&to=2026-04-30&page=1
Authorization: Bearer <ACCESS_TOKEN>

200 OK
{
  "page": 1, "page_size": 50, "total": 137,
  "items": [
    {
      "operation_id": "OP-7F92A1",
      "created_at": "2026-04-12T14:08:55-05:00",
      "side": "USD_TO_PEN",
      "amount_usd": 12500.00,
      "rate": 3.7184,
      "amount_pen": 46480.00,
      "fee_pen": 0.00,
      "from_bank": "BCP", "to_bank": "INTERBANK",
      "status": "SETTLED",
      "voucher_url": "https://.../OP-7F92A1.pdf"
    }
  ]
}

3. Webhook: evento de liquidación

POST https://your-app.example/webhooks/rextie
X-Rextie-Signature: t=1746230400,v1=8a4e...
Content-Type: application/json

{
  "event": "operation.settled",
  "operation_id": "OP-7F92A1",
  "status": "SETTLED",
  "settled_at": "2026-04-12T14:32:11-05:00",
  "rate": 3.7184,
  "destination_bank": "INTERBANK"
}

# verify HMAC-SHA256 of the raw body using the shared secret
# reject if older than 5 minutes or signature mismatches

Marco regulatorio

Rextie está registrada ante la Superintendencia de Banca, Seguros y AFP (SBS) como operador de cambio de moneda y es la única fintech peruana del segmento con certificación ISO 27001. Las integraciones deben respetar la Ley de Protección de Datos Personales del Perú N.° 29733 y la nueva regulación bajo el Decreto Supremo N.° 016-2024-JUS, vigente desde el 30 de marzo de 2025, que obliga a designar un Oficial de Datos Personales y a notificar brechas a la APDP. Referencia: Superintendencia de Banca, Seguros y AFP (Wikipedia).

Principios operativos

• Acceso solo con autorización del cliente — sin evadir 2FA o vinculación de dispositivo.
• Minimización de datos: las integraciones solicitan los campos mínimos necesarios para el caso de uso.
• Registros de consentimiento y logs de acceso conservados para auditabilidad.
• Mapeo de controles estilo ISO 27001 sobre el adaptador, espejado desde la propia postura de Rextie.
• Tokens almacenados cifrados en reposo; ganchos de revocación atados al offboarding del cliente.

Acerca de OpenFinance Lab

Somos un estudio independiente enfocado en la integración de APIs fintech y OpenData. Nuestro equipo incluye ingenieros provenientes de bancos, pasarelas de pago, investigación de protocolos y plataformas cloud. Conocemos las expectativas de la SBS, el BCRP y la APDP así como las reglas de privacidad multi-región, y entregamos APIs financieras de extremo a extremo bajo restricciones de seguridad y cumplimiento.

• Pagos, banca digital, FX y compensación transfronteriza
• Gateways de API empresariales y revisiones de seguridad
• SDKs personalizados en Python / Node.js / Go y arneses de prueba
• Pipeline completo: análisis de protocolo → build → validación → cumplimiento
• Entrega de código fuente desde USD 300 — fuente de API ejecutable más documentación, pago tras la entrega y conformidad
• Facturación API por llamada — accede a nuestros endpoints alojados y paga solo por llamada, sin costo inicial

Contacto

Envíanos tu app objetivo, los datos que quieres consumir y tu cronograma. Respondemos en un día hábil.

Página de contacto

Flujo de trabajo del engagement

1. Confirmación de alcance: qué superficies de Rextie (login, operaciones, tipos, webhooks) realmente necesitas.
2. Análisis de protocolo y diseño de la API (2–5 días hábiles).
3. Build y validación interna contra una cuenta sandbox (3–8 días hábiles).
4. Documentación, especificación OpenAPI y colección Postman (1–2 días hábiles).
5. Entrega y una ronda de soporte post-entrega; la primera entrega típica es de 5–15 días hábiles.

Preguntas frecuentes

¿Rextie publica una API pública para desarrolladores?

¿Qué datos de Rextie pueden integrarse en mi stack?

¿Cuánto tarda una integración con Rextie?

¿Cómo mantienen la integración en cumplimiento en Perú?