Transferencias

Mueve dinero entre dos de tus cuentas en una sola operación, aunque estén en monedas distintas.

Cómo funciona

Una transferencia crea dos movimientos unidos por el mismo transferId: un CUT en la cuenta de origen y un ADD en la de destino. Se crean juntos o no se crea ninguno, y no cuentan como gasto ni ingreso en tus reportes.

Si las monedas difieren, indicas la tasa: destino = origen × rate. Por ejemplo, de VES a USD con una tasa de 36,50 bolívares por dólar, rate es 1 / 36.5, unos 0.0274.

Crear una transferencia

POSThttps://api.tuplatica.app/api/platica/transfers

Plan: ProPermiso de la key: Lectura y escritura

Cuerpo

fromAccountIduuidobligatorio: Cuenta de la que sale el dinero.
toAccountIduuidobligatorio: Cuenta a la que entra.
amountMinorintegerobligatorio: Monto en céntimos de la moneda de origen.
ratenumber: Obligatoria si las monedas difieren; se ignora si son iguales.
descriptionstring: Texto libre.
occurredAtdatetime: Cuándo ocurrió. Por defecto, ahora.

curl -X POST "https://api.tuplatica.app/api/platica/transfers" \
  -H "Authorization: Bearer $PLATICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromAccountId": "6f1c2a9e-8b4d-4c1e-9a7f-2d5e8b3c1a40",
    "toAccountId": "0d9a4b7e-3c21-4e6f-8a5b-1f2e3d4c5b6a",
    "amountMinor": 3650000,
    "rate": 0.0274,
    "description": "Ahorro quincenal"
  }'

Respuesta 201

{
  "rate": 0.0274,
  "from": {
    "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
    "accountId": "6f1c2a9e-8b4d-4c1e-9a7f-2d5e8b3c1a40",
    "type": "CUT",
    "amountMinor": 3650000,
    "description": "Ahorro quincenal",
    "categoryId": null,
    "categorySource": "automatic",
    "occurredAt": "2026-10-15T16:00:00.000Z",
    "isInitial": false,
    "transferId": "e7c3a1d9-2b4f-4a6e-8d0c-5f7b9e1a3c2d",
    "sourceType": null,
    "sourceId": null,
    "sourceParentId": null,
    "financialNature": "OPERATING",
    "createdAt": "2026-10-15T16:00:01.000Z",
    "updatedAt": "2026-10-15T16:00:01.000Z"
  },
  "to": {
    "id": "f5e4d3c2-b1a0-4f9e-8d7c-6b5a4f3e2d1c",
    "accountId": "0d9a4b7e-3c21-4e6f-8a5b-1f2e3d4c5b6a",
    "type": "ADD",
    "amountMinor": 100010,
    "description": "Ahorro quincenal",
    "categoryId": null,
    "categorySource": "automatic",
    "occurredAt": "2026-10-15T16:00:00.000Z",
    "isInitial": false,
    "transferId": "e7c3a1d9-2b4f-4a6e-8d0c-5f7b9e1a3c2d",
    "sourceType": null,
    "sourceId": null,
    "sourceParentId": null,
    "financialNature": "OPERATING",
    "createdAt": "2026-10-15T16:00:01.000Z",
    "updatedAt": "2026-10-15T16:00:01.000Z"
  }
}

Redondeo

El monto de destino se redondea al céntimo. Si necesitas un valor exacto en destino, calcula la tasa a partir de los dos montos.

Consultar una transferencia

GEThttps://api.tuplatica.app/api/platica/transfers/:transferId

Plan: ProPermiso de la key: Solo lectura o superior

Devuelve las dos partes, la tasa y los nombres de ambas cuentas (fromAccountName, toAccountName).

curl "https://api.tuplatica.app/api/platica/transfers/e7c3a1d9-2b4f-4a6e-8d0c-5f7b9e1a3c2d" \
  -H "Authorization: Bearer $PLATICA_API_KEY"

Eliminar una transferencia

DELETEhttps://api.tuplatica.app/api/platica/transfers/:transferId

Plan: ProPermiso de la key: Lectura y escritura

Elimina las dos partes a la vez. Responde 204 sin cuerpo.

curl -X DELETE "https://api.tuplatica.app/api/platica/transfers/e7c3a1d9-2b4f-4a6e-8d0c-5f7b9e1a3c2d" \
  -H "Authorization: Bearer $PLATICA_API_KEY"