Skip to main content
WEBHOOK
Yuno sends incoming transfer notifications to your endpoint at {merchant_base_URL}/v1/banking/transfers. Your endpoint must return a 200 OK response with {"received": true}. Yuno sets the merchant base URL for banking webhooks on request, so ask your Yuno contact to register or change it. Notifications include sender details, transfer amount, payment rail, and status. Yuno retries on 5xx responses and timeouts with exponential backoff. See Webhook events for the complete list of Banking Connectivity webhook event types.

Authorizations

public-api-key
string
header
required

Public API key from Dashboard > Settings > API Keys

private-secret-key
string
header
required

Private secret key (server-side only)

Body

application/json
id
string

The unique identifier of the transfer (UUID, 36 characters).

Example:

"cc0e8400-e29b-41d4-a716-446655440000"

destination_account_id
string

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

Example:

"aa0e8400-e29b-41d4-a716-446655440000"

account_id
string

The merchant's Yuno account identifier.

Example:

"550e8400-e29b-41d4-a716-446655440000"

provider
object

Provider-side identifiers.

status
enum<string>

The transfer status.

Available options:
PENDING,
COMPLETED
Example:

"COMPLETED"

transfer_type
enum<string>

The transfer type. Incoming transfer webhooks always have INCOMING.

Available options:
INCOMING
Example:

"INCOMING"

sender
object

Information about the external sender.

amount
object

The transfer amount.

payment_rail
enum<string>

The payment rail used for the transfer.

Available options:
ACH_STANDARD,
ACH_SAME_DAY,
WIRE,
RTP,
FPS,
CHAPS,
BACS,
NPP,
PAYTO,
BPAY
Example:

"ACH_STANDARD"

description
string

The transfer description.

Example:

"Payment for services"

created_at
string

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

Example:

"2026-02-01T14:30:00Z"

updated_at
string

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

Example:

"2026-02-01T14:30:00Z"

Response

200 - application/json