Tipo de cambio (FX)

API para gestionar tasas de cambio para multi-moneda.

Endpoints

Listar tasas

GET /api/v1/fx/rates

Respuesta 200 OK:

{
  "data": [
    {
      "from": "PEN",
      "to": "USD",
      "rate": "0.27030000",
      "source": "manual",
      "fetched_at": "2026-07-22T12:00:00Z"
    },
    {
      "from": "USD",
      "to": "PEN",
      "rate": "3.70000000",
      "source": "openexchangerates",
      "fetched_at": "2026-07-22T06:00:00Z"
    }
  ]
}

Configurar tasa manual

POST /api/v1/fx/rates

{
  "from": "PEN",
  "to": "USD",
  "rate": "0.2703"
}

Campo	Tipo	Requerido	Descripción
from	string	Sí	Moneda origen (ISO 4217, 3 chars)
to	string	Sí	Moneda destino (ISO 4217, 3 chars)
rate	string	Sí	Tasa de cambio como string decimal

Refrescar tasas desde proveedor

Solicita una actualización de todas las tasas desde el proveedor configurado (Open Exchange Rates).

POST /api/v1/fx/rates/refresh

Respuesta 204 No Content en éxito, 502 Bad Gateway si el proveedor falla.

Fuentes de datos

Source	Descripción
manual	Tasa configurada manualmente por el merchant
openexchangerates	Open Exchange Rates API