Saltar al contenido principal
WEBHOOK
Yuno envía las notificaciones de transferencias entrantes a tu endpoint en {merchant_base_URL}/v1/banking/transfers. Tu endpoint debe devolver una respuesta 200 OK con {"received": true}. Yuno configura la URL base del comercio para los webhooks de banca a solicitud, así que pide a tu contacto de Yuno que la registre o la cambie. Las notificaciones incluyen los detalles del remitente, el monto de la transferencia, el rail de pago y el estado. Yuno reintenta ante respuestas 5xx y tiempos de espera agotados con retroceso exponencial. Consulta Eventos de webhook para ver la lista completa de tipos de eventos de webhook de Banking Connectivity.

Autorizaciones

public-api-key
string
header
requerido

Public API key from Dashboard > Settings > API Keys

private-secret-key
string
header
requerido

Private secret key (server-side only)

Cuerpo

application/json
id
string

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

Ejemplo:

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

destination_account_id
string

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

Ejemplo:

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

account_id
string

The merchant's Yuno account identifier.

Ejemplo:

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

provider
object

Provider-side identifiers.

status
enum<string>

The transfer status.

Opciones disponibles:
PENDING,
COMPLETED
Ejemplo:

"COMPLETED"

transfer_type
enum<string>

The transfer type. Incoming transfer webhooks always have INCOMING.

Opciones disponibles:
INCOMING
Ejemplo:

"INCOMING"

sender
object

Information about the external sender.

amount
object

The transfer amount.

payment_rail
enum<string>

The payment rail used for the transfer.

Opciones disponibles:
ACH_STANDARD,
ACH_SAME_DAY,
WIRE,
RTP,
FPS,
CHAPS,
BACS,
NPP,
PAYTO,
BPAY
Ejemplo:

"ACH_STANDARD"

description
string

The transfer description.

Ejemplo:

"Payment for services"

created_at
string

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

Ejemplo:

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

updated_at
string

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

Ejemplo:

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

Respuesta

200 - application/json