Skip to main content
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"
}

{
  "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"
}

{
  "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"
}