> ## 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.

# Transacciones de fondeo de cuenta (AFT)

> Carga fondos en billeteras o transfiere entre cuentas usando transacciones de fondeo de cuenta mediante la API de Payments

## Introducción

Las **transacciones de fondeo de cuenta (AFT)** son transacciones financieras que facilitan la transferencia de fondos entre cuentas de pago. Se usan ampliamente para cargar o recargar cuentas de usuario y billeteras digitales, y para realizar transferencias internas de fondos dentro de una plataforma de pago.

Las AFT permiten mover dinero entre cuentas de forma eficiente y segura.

## ¿Qué es una AFT?

Una **AFT (transacción de fondeo de cuenta)** es un tipo de transacción diseñada para:

* **Cargar fondos** en cuentas de usuario o billeteras digitales.
* **Transferir fondos** entre cuentas dentro de la misma plataforma.
* **Depositar dinero** en cuentas comerciales o personales. Incluye remesas.

Las AFT aprovechan las redes de pago tradicionales (por ejemplo, Visa, Mastercard, ACH) para procesar transacciones de forma rápida y segura, optimizando los costos.

### Tipos de transacciones AFT

1. **Transacciones de fondeo**:
   * Transfieren fondos a una cuenta desde una tarjeta de débito/crédito o una cuenta bancaria.
   * Ejemplo: un usuario carga su billetera digital con su tarjeta de débito.

2. **Transacciones de retiro**:
   * Mueven fondos de una cuenta de usuario de vuelta a su cuenta bancaria o tarjeta.
   * Ejemplo: un usuario transfiere dinero de su billetera digital a su cuenta bancaria.

## Integración

Para realizar una AFT, deberás enviar una solicitud a nuestra [API de Payments](https://docs.y.uno/es/reference/payments/create-payment.md) con el objeto `additional_data.order.account_funding` que especifica los datos del `sender` y del `beneficiary`.

Cada esquema de tarjeta de crédito puede requerir información distinta sobre el destinatario y el remitente, según la región de operación y la categoría de la transacción.

```Text Example theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
[...]
 "additional_data": {
   "order": {
    "account_funding": {
      "sender": {
        "first_name": "John",
        "last_name": "Doe",
        "email": "john.doe@mail.com"
      },
      "beneficiary": {
        "first_name": "Chris",
        "last_name": "Martin",
        "document": {
          "document_number": "38192019",
          "document_type": "CC"
        }
      }
     }
    }
  }
[...]
```

Para más detalles, consulta la sección de la [API de pagos](https://docs.y.uno/es/reference/payments/create-payment.md).

> [!NOTE]
>
> **Datos adicionales**
>
> Si necesitas definir información adicional sobre el vendedor, como `merchant_category_code`, por ejemplo, puedes encontrar campos extra en `seller_details`, dentro de la [estructura `additional_data`](https://docs.y.uno/reference/payments/the-payment-object) del pago.

> [!NOTE]
>
> **Billeteras digitales escalonadas**
>
> Si operas una billetera digital escalonada, en la que el cliente primero carga un saldo y luego lo gasta en una transacción aparte, consulta [Staged Digital Wallet Operators (SDWO)](https://docs.y.uno/es/docs/payment-features/staged-digital-wallet-operators-sdwo.md) para ver los requisitos específicos de las redes de tarjetas que aplican a ese flujo.


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