> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Notificaciones de webhook

> Recibe notificaciones de transferencias entrantes con detalles del remitente, el monto, el rail y el estado

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](https://docs.y.uno/es/reference/banking-connectivity.md#webhook-events) para ver la lista completa de tipos de eventos de webhook de Banking Connectivity.


## OpenAPI

````yaml openapi/es/banking-connectivity/webhooks/webhook-notifications-banking.json webhook webhook-notifications-banking
openapi: 3.1.0
info:
  title: Yuno Payments API
  version: 1.0.0
  description: >
    Yuno is a payment orchestration platform that connects merchants to multiple

    payment providers through a single API. Process payments, manage customers,

    handle subscriptions, and disburse payouts across Latin America, Asia, and
    beyond.
  contact:
    name: Yuno Support
    url: https://docs.y.uno
    email: support@y.uno
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - PublicApiKey: []
    PrivateSecretKey: []
tags:
  - name: AI Caller
  - name: Accounts (Banking Connectivity)
  - name: Checkout Builder
  - name: Checkout Sessions
  - name: Communications Campaigns
  - name: Conversion Rate
  - name: Customer Sessions Enrollment
  - name: Customers
  - name: Dry Run
  - name: Entities (Banking Connectivity)
  - name: Entity Onboarding (Banking Connectivity)
  - name: Entity Transfers (Banking Connectivity)
  - name: Fx Rates
  - name: Installments
  - name: Network Tokens
  - name: Organizations
  - name: Payment Links
  - name: Payment Methods Checkout
  - name: Payment Methods Direct Workflow
  - name: Payments
  - name: Payouts
  - name: Pci Proxy
  - name: Plans
  - name: Pre Debit Notifications
  - name: Recipients For Marketplace
  - name: Reporting
  - name: Reports
  - name: Sellers
  - name: Subscriptions
  - name: Three D Secure Setups
  - name: Transfers
  - name: Webhooks
paths: {}
components:
  securitySchemes:
    PublicApiKey:
      type: apiKey
      in: header
      name: public-api-key
      description: Public API key from Dashboard > Settings > API Keys
    PrivateSecretKey:
      type: apiKey
      in: header
      name: private-secret-key
      description: Private secret key (server-side only)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.