Transferencias entre cuentas
Transferencia de dinero de una cuenta a otra con comisión: alta, edición y baja. Sus partes son movimientos de dinero con transfer_id.
Transferencias entre cuentas
Objetos
MoneyTransfer
idintegerobligatorioID de la transferencia: el transfer_id de sus partes en el libro de movimientos de dinero (/v1/money-transactions).
versionintegerobligatorioVersión del registro: crece con cada cambio. Para cambiar el registro, envíela como ETag en If-Match.
from_account_idintegerobligatorioID de la cuenta de dinero de la que salió el dinero.
to_account_idintegerobligatorioID de la cuenta de dinero a la que entró el dinero.
from_amountstringobligatorioImporte que salió de from_account_id en su moneda, como cadena decimal.
from_currencystringobligatorioMoneda de la cuenta de origen: código ISO 4217 o código de la criptomoneda.
to_amountstringobligatorioImporte que entró en to_account_id en su moneda, como cadena decimal. En la misma moneda es igual a from_amount: la diferencia es la comisión fee.
to_currencystringobligatorioMoneda de la cuenta de destino.
feestring o nullobligatorioComisión de la transferencia en la moneda de la cuenta de origen, como cadena decimal: un egreso en la categoría de sistema bank_fees; null si no hay comisión.
amountintegerobligatorioValor de la transferencia en unidades mínimas de la moneda de la tienda: lo llevan las dos partes. La diferencia de cambio de un canje de monedas el libro la asienta como movimiento aparte.
currencystringobligatorioMoneda de los importes, código ISO 4217: la moneda de la tienda.
occurred_atstring (date-time)obligatorioMomento de la transferencia.
occurred_onstring (date)obligatorioFecha contable de la transferencia, YYYY-MM-DD en la zona horaria de la tienda.
descriptionstring o nullobligatorioDescripción de la transferencia; null si no se cargó.
from_transaction_idintegerobligatorioID del movimiento de egreso en la cuenta de origen.
to_transaction_idintegerobligatorioID del movimiento de ingreso en la cuenta de destino.
fee_transaction_idinteger o nullobligatorioID del movimiento de la comisión; null si no hay comisión.
created_atstring (date-time)obligatorioCuándo se creó el registro.
Endpoints
Obtener una transferencia entre cuentas de dinero
get/money-transfers/{money_transfer}
Scope: finance:read
Parámetros
Ruta
money_transferintegerobligatorioID de la transferencia: el transfer_id de sus partes en el libro de movimientos de dinero.
Respuestas
200Éxito
Encabezados
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
application/json
Devuelve MoneyTransfer
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl "https://api.saleya.app/v1/money-transfers/{money_transfer}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"id": 0,
"version": 0,
"from_account_id": 0,
"to_account_id": 0,
"from_amount": "string",
"from_currency": "string",
"to_amount": "string",
"to_currency": "string",
"fee": "string",
"amount": 0,
"currency": "string",
"occurred_at": "2026-01-15T12:00:00Z",
"occurred_on": "2026-01-15",
"description": "string",
"from_transaction_id": 0,
"to_transaction_id": 0,
"fee_transaction_id": 0,
"created_at": "2026-01-15T12:00:00Z"
}Editar la transferencia entera en su lugar: cuentas, importes, comisión, fecha y descripción
patch/money-transfers/{money_transfer}
Scope: finance:write
Parámetros
Ruta
money_transferintegerobligatorioID de la transferencia: el transfer_id de sus partes en el libro de movimientos de dinero.
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringobligatorioETag del registro de la última lectura, por ejemplo "7". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.
- Ejemplo:
"7"
Cuerpo de la solicitud application/json
from_account_idintegerID de la cuenta de dinero de la que salió el dinero.
- Mínimo:
- 1
to_account_idintegerID de la cuenta de dinero a la que entró el dinero.
- Mínimo:
- 1
from_amountstringImporte que salió de from_account_id en su moneda, como cadena decimal.
- Largo máximo:
- 37
to_amountstring o nullImporte que entró en to_account_id en su moneda, como cadena decimal. En la misma moneda es igual a from_amount: la diferencia es la comisión fee.
- Largo máximo:
- 37
feestring o nullComisión de la transferencia en la moneda de la cuenta de origen, como cadena decimal: un egreso en la categoría de sistema bank_fees; null si no hay comisión.
- Largo máximo:
- 37
occurred_onstring (date)Fecha contable de la transferencia, YYYY-MM-DD en la zona horaria de la tienda.
occurred_atstring (date-time)Momento de la transferencia.
descriptionstring o nullDescripción de la transferencia; null si no se cargó.
- Largo máximo:
- 1000
Respuestas
200Éxito
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
application/json
Devuelve MoneyTransfer
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
412El registro cambió después de leerlo: la versión de If-Match no es la actual
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
428La solicitud necesita If-Match con el ETag del registro
application/problem+json
Devuelve Problem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 412
precondition_failedEl registro cambió - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida - 428
precondition_requiredFalta If-Match
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X PATCH "https://api.saleya.app/v1/money-transfers/{money_transfer}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"' \
-H "Content-Type: application/json" \
-d @body.json{
"from_account_id": 1,
"to_account_id": 1,
"from_amount": "string",
"to_amount": "string",
"fee": "string",
"occurred_on": "2026-01-15",
"occurred_at": "2026-01-15T12:00:00Z",
"description": "string"
}{
"id": 0,
"version": 0,
"from_account_id": 0,
"to_account_id": 0,
"from_amount": "string",
"from_currency": "string",
"to_amount": "string",
"to_currency": "string",
"fee": "string",
"amount": 0,
"currency": "string",
"occurred_at": "2026-01-15T12:00:00Z",
"occurred_on": "2026-01-15",
"description": "string",
"from_transaction_id": 0,
"to_transaction_id": 0,
"fee_transaction_id": 0,
"created_at": "2026-01-15T12:00:00Z"
}Borrar una transferencia con todas sus partes
delete/money-transfers/{money_transfer}
Scope: finance:write
Parámetros
Ruta
money_transferintegerobligatorioID de la transferencia: el transfer_id de sus partes en el libro de movimientos de dinero.
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
If-MatchstringobligatorioETag del registro de la última lectura, por ejemplo "7". El cambio se aplica solo si nadie cambió el registro desde entonces; si no, 412. Sin él, 428.
- Ejemplo:
"7"
Respuestas
204Éxito
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
Sin cuerpo
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
404El objeto no existe o no está disponible para la aplicación
application/problem+json
Devuelve Problem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
412El registro cambió después de leerlo: la versión de If-Match no es la actual
application/problem+json
Devuelve Problem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
428La solicitud necesita If-Match con el ETag del registro
application/problem+json
Devuelve Problem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 409
in_use_conflictRegistro en uso - 412
precondition_failedEl registro cambió - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida - 428
precondition_requiredFalta If-Match
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X DELETE "https://api.saleya.app/v1/money-transfers/{money_transfer}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H 'If-Match: "7"'Transferir dinero entre cuentas, con comisión o sin ella
post/money-transfers
Scope: finance:write
Parámetros
Encabezado
Idempotency-KeystringClave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.
- Largo mínimo:
- 1
- Largo máximo:
- 255
- Ejemplo:
8e03978e-40d5-43e8-bc93-6894a57f9324
Cuerpo de la solicitud application/json
from_account_idintegerobligatorioID de la cuenta de dinero de la que salió el dinero.
- Mínimo:
- 1
to_account_idintegerobligatorioID de la cuenta de dinero a la que entró el dinero.
- Mínimo:
- 1
from_amountstringobligatorioImporte que salió de from_account_id en su moneda, como cadena decimal.
- Largo máximo:
- 37
to_amountstring o nullImporte que entró en to_account_id en su moneda, como cadena decimal. En la misma moneda es igual a from_amount: la diferencia es la comisión fee.
- Largo máximo:
- 37
feestring o nullComisión de la transferencia en la moneda de la cuenta de origen, como cadena decimal: un egreso en la categoría de sistema bank_fees; null si no hay comisión.
- Largo máximo:
- 37
occurred_onstring (date)Fecha contable de la transferencia, YYYY-MM-DD en la zona horaria de la tienda.
occurred_atstring (date-time)Momento de la transferencia.
descriptionstring o nullDescripción de la transferencia; null si no se cargó.
- Largo máximo:
- 1000
Respuestas
201Creado
Encabezados
Idempotent-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
ETagstringobligatorioVersión del registro. Mandala en If-Match para cambiar el registro.
- Ejemplo:
"7"
Locationstring (uri)obligatorioDirección del registro creado; en una solicitud aceptada (202), la dirección donde seguir su resultado.
application/json
Devuelve MoneyTransfer
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer
application/problem+json
Devuelve Problem
403El plan, la dirección IP o los scopes del token no permiten la solicitud
Encabezados
WWW-AuthenticatestringEsquema de autenticación (RFC 6750).
- Ejemplo:
Bearer error="insufficient_scope", scope="locations:read"
application/problem+json
Devuelve ForbiddenProblem
409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
422Un parámetro es inválido o desconocido
application/problem+json
Devuelve ValidationProblem
429Se agotó el límite de solicitudes
Encabezados
Retry-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida
Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores
curl -X POST "https://api.saleya.app/v1/money-transfers" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H "Content-Type: application/json" \
-d @body.json{
"from_account_id": 1,
"to_account_id": 1,
"from_amount": "string",
"to_amount": "string",
"fee": "string",
"occurred_on": "2026-01-15",
"occurred_at": "2026-01-15T12:00:00Z",
"description": "string"
}{
"id": 0,
"version": 0,
"from_account_id": 0,
"to_account_id": 0,
"from_amount": "string",
"from_currency": "string",
"to_amount": "string",
"to_currency": "string",
"fee": "string",
"amount": 0,
"currency": "string",
"occurred_at": "2026-01-15T12:00:00Z",
"occurred_on": "2026-01-15",
"description": "string",
"from_transaction_id": 0,
"to_transaction_id": 0,
"fee_transaction_id": 0,
"created_at": "2026-01-15T12:00:00Z"
}