Initiate Transfer

Send funds between BaaS entities

POST /v1/baas/transfers

{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "source_entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "destination_entity_id": "ent_770e8400-e29b-41d4-a716-446655440001",
  "amount": 250.00,
  "currency": "USD",
  "payment_rail": "ACH_SAME_DAY",
  "reference": "invoice_2026_001",
  "description": "Payment for services rendered"
}

201 Created

{
  "id": "xfer_880e8400-e29b-41d4-a716-446655440000",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "source_entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "destination_entity_id": "ent_770e8400-e29b-41d4-a716-446655440001",
  "amount": 250.00,
  "currency": "USD",
  "status": "PENDING",
  "payment_rail": "ACH_SAME_DAY",
  "reference": "invoice_2026_001",
  "description": "Payment for services rendered",
  "created_at": "2026-02-01T16:00:00Z",
  "updated_at": "2026-02-01T16:00:00Z"
}

Headers

x-idempotency-key · string · required

Unique UUID to ensure the request is processed only once.

Body

account_id · string · required

Merchant’s Yuno account identifier (UUID).

source_entity_id · string · required

Entity ID initiating the transfer.

destination_entity_id · string · required

Entity ID receiving the transfer.

amount · number · required

Transfer amount.

currency · string · required

ISO 4217 currency code.

payment_rail · string

Payment rail to use. Options depend on region. See Payment rails by region.

reference · string

Merchant reference for reconciliation.

description · string

Transfer description.

metadata · object

Additional custom data.

Response

id · string

Transfer identifier.

account_id · string

Associated Yuno account.

source_entity_id · string

Origin entity.

destination_entity_id · string

Recipient entity.

amount · number

Transferred amount.

currency · string

Currency code.

status · string

Current transfer status. See Transfer statuses.

payment_rail · string

Payment rail used.

reference · string

Merchant reference.

created_at · string

ISO 8601 timestamp.

updated_at · string

ISO 8601 timestamp.

{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "source_entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "destination_entity_id": "ent_770e8400-e29b-41d4-a716-446655440001",
  "amount": 250.00,
  "currency": "USD",
  "payment_rail": "ACH_SAME_DAY",
  "reference": "invoice_2026_001",
  "description": "Payment for services rendered"
}

201 Created

{
  "id": "xfer_880e8400-e29b-41d4-a716-446655440000",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "source_entity_id": "ent_660e8400-e29b-41d4-a716-446655440000",
  "destination_entity_id": "ent_770e8400-e29b-41d4-a716-446655440001",
  "amount": 250.00,
  "currency": "USD",
  "status": "PENDING",
  "payment_rail": "ACH_SAME_DAY",
  "reference": "invoice_2026_001",
  "description": "Payment for services rendered",
  "created_at": "2026-02-01T16:00:00Z",
  "updated_at": "2026-02-01T16:00:00Z"
}