v1

latestOpenAPI 3.0.02026-07-26167441.9 MB
Webhooks

Webhook Notifications

post/banking/transfers

Request body

idstring

The unique identifier of the transfer (prefixed xfer_).

destination_account_idstring

The id of the destination Banking Connectivity account that received the incoming transfer.

account_idstring

The merchant's Yuno account identifier.

status'PENDING' | 'COMPLETED'

The transfer status.

direction'INCOMING'

The transfer direction. Incoming transfer webhooks always have INCOMING.

payment_rail'ACH_STANDARD' | 'ACH_SAME_DAY' | 'WIRE' | 'RTP' | 'FPS' | 'CHAPS' | 'BACS' | 'NPP' | 'PAYTO' | 'BPAY'

The payment rail used for the transfer.

descriptionstring

The transfer description.

created_atstring

The timestamp when the transfer was created (ISO 8601).

updated_atstring

The timestamp when the transfer was last updated (ISO 8601).

Example request

{
  "id": "xfer_cc0e8400-e29b-41d4-a716-446655440000",
  "destination_account_id": "acct_aa0e8400-e29b-41d4-a716-446655440000",
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "provider": {
    "account_id": "col_bank_account_789",
    "transfer_id": "col_incoming_xyz456"
  },
  "status": "COMPLETED",
  "direction": "INCOMING",
  "sender": {
    "account_number_last_4": "5678",
    "routing_number": "987654321",
    "account_name": "External Company LLC",
    "bank_name": "Bank of America"
  },
  "amount": {
    "value": 2500,
    "currency": "USD"
  },
  "payment_rail": "ACH_STANDARD",
  "description": "Payment for services",
  "created_at": "2026-02-01T14:30:00Z",
  "updated_at": "2026-02-01T14:30:00Z"
}