Saltar al contenido principal
POST
/
v1
/
transfers
/
process
Procesar una Transferencia
curl --request POST \
  --url https://plugin-br-bank-transfer.sandbox.lerian.net/v1/transfers/process \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --header 'X-Tenant-Id: <x-tenant-id>' \
  --data '
{
  "initiationId": "019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b"
}
'
{
  "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d",
  "confirmationNumber": "20260201001",
  "status": "PROCESSING",
  "feeAmount": 1.5,
  "totalAmount": 1002
}

Autorizaciones

​
Authorization
string
header
requerido

Autenticación mediante token JWT Bearer. El token debe incluir un claim tenantId que coincida con el encabezado X-Tenant-Id.

Encabezados

​
X-Tenant-Id
string<uuid>
requerido

ID de organización utilizado como identificador de inquilino. Todos los datos están limitados a esta organización. Debe coincidir con el claim tenantId del JWT cuando la autenticación está habilitada.

​
X-Idempotency
string
requerido

Clave de idempotencia requerida para reintentos seguros. Utilice un UUID v4 o un identificador de negocio único. Si se envía la misma clave nuevamente y la solicitud original ya fue procesada, se devuelve la respuesta almacenada en caché.

Consulte Reintentos e idempotencia para más detalles.

Maximum string length: 255

Cuerpo

application/json
​
initiationId
string<uuid>
requerido

El ID de iniciación devuelto por el endpoint Iniciar Transferencia. Expira después de 24 horas.

Ejemplo:

"019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b"

Respuesta

Indica que la transferencia fue confirmada y el procesamiento ha comenzado.

La respuesta incluye el encabezado X-Idempotency-Replayed.

Si el valor es false, la transacción acaba de ser procesada. Si el valor es true, la respuesta es una repetición de una solicitud previamente procesada.

Consulte Reintentos e idempotencia para más detalles.

​
transferId
string<uuid>
requerido

El ID único de la transferencia. Utilice este valor para rastrear el estado de la transferencia.

Ejemplo:

"019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d"

​
confirmationNumber
string
requerido

Un número de confirmación legible en formato AAAAMMDD+secuencia.

Maximum string length: 20
Ejemplo:

"20260201001"

​
status
enum<string>
requerido

El estado actual de la transferencia. Para transferencias TED_OUT, el estado inmediatamente después del procesamiento es siempre PROCESSING.

Opciones disponibles:
CREATED,
PENDING,
PROCESSING,
COMPLETED,
REJECTED,
FAILED,
CANCELLED,
RECEIVED
Ejemplo:

"COMPLETED"

​
feeAmount
number<decimal>
requerido

El monto de la tarifa calculada durante la iniciación.

Ejemplo:

1.5

​
totalAmount
number<decimal>
requerido

El monto total retenido o transferido, incluyendo la tarifa.

Ejemplo:

1002

​
packageAppliedId
string<uuid> | null

ID del paquete de comisiones aplicado a esta transferencia, si corresponde.

Ejemplo:

"019c96a0-ad10-7fab-c1d2-3b4c5d6e7f8a"