Skip to main content
POST
/
v1
/
transfers
/
process
Process a Transfer
curl --request POST \
  --url https://plugin-br-bank-transfer-jd.sandbox.lerian.net/v1/transfers/process \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Organization-Id: <x-organization-id>' \
  --data '
{
  "initiationId": "019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b"
}
'
{
  "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d",
  "confirmationNumber": "20260201001",
  "status": "CREATED",
  "feeAmount": 1.5,
  "totalAmount": 1002
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token authentication. The token must include a tenantId claim that matches the X-Organization-Id header.

Headers

​
X-Organization-Id
string<uuid>
required

Organization ID used as the tenant identifier. All data is scoped to this organization. Must match the JWT tenantId claim when authentication is enabled.

Body

application/json
​
initiationId
string<uuid>
required

The initiation ID returned by the Initiate Transfer endpoint. Expires after 24 hours.

Example:

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

Response

Indicates that the transfer was confirmed and processing has started.

​
transferId
string<uuid>
required

The unique transfer ID. Use this value to track the transfer status.

Example:

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

​
confirmationNumber
string
required

A human-readable confirmation number in YYYYMMDD+sequence format.

Maximum string length: 20
Example:

"20260201001"

​
status
enum<string>
required

The current status of the transfer. For TED OUT and P2P transfers, the flow is CREATED, PENDING, PROCESSING, and then COMPLETED, REJECTED, or FAILED. Transfers can be CANCELLED while in CREATED or PENDING status. For TED IN transfers, the flow is RECEIVED and then COMPLETED or REJECTED.

Available options:
CREATED,
PENDING,
PROCESSING,
COMPLETED,
REJECTED,
FAILED,
CANCELLED,
RECEIVED
Example:

"COMPLETED"

​
feeAmount
number<decimal>
required

The fee amount as calculated during initiation.

Example:

1.5

​
totalAmount
number<decimal>
required

The total amount held or transferred, including the fee.

Example:

1002