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

# Filtros de tarjetas y datos útiles

> Filtra las tarjetas elegibles en la hoja de Apple Pay, lee el BIN del DPAN desde el token de un solo uso y gestiona un flujo de Apple Pay cancelado.

## Filtrar tarjetas elegibles

Envía `wallet_card_acceptance` al crear la sesión de checkout para limitar qué tarjetas puede seleccionar el cliente en la hoja de pago de Apple Pay. Las tarjetas que no coinciden se muestran atenuadas.

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "country": "BR",
  "customer_id": "070a34cb-4649-4a4e-b231-065a53060379",
  "merchant_order_id": "order-123",
  "payment_description": "Apple Pay one-time payment",
  "amount": {
    "currency": "BRL",
    "value": 100
  },
  "wallet_card_acceptance": {
    "supported_countries": ["BR"],
    "supported_networks": ["VISA", "MASTERCARD", "ELO"],
    "supported_funding_types": ["CREDIT"]
  }
}
```

| Campo | Valores | Qué hace |
| - | - | - |
| `supported_countries` | Códigos ISO 3166-1 alpha-2 | Solo se pueden seleccionar las tarjetas emitidas en estos países. Filtra por el país que emitió la tarjeta, no por la ubicación del cliente: `["BR"]` atenúa una tarjeta emitida en EE. UU. |
| `supported_networks` | Redes de tarjetas, por ejemplo `VISA`, `MASTERCARD`, `AMEX`, `ELO` | Solo se pueden seleccionar las tarjetas de estas redes. Reemplaza la lista por defecto (`AMEX`, `DISCOVER`, `ELECTRON`, `ELO`, `MASTERCARD`, `VISA`, `MAESTRO`): `["VISA"]` permite solo Visa. |
| `supported_funding_types` | `CREDIT`, `DEBIT` | Solo se pueden seleccionar las tarjetas de estos tipos de fondeo: `["CREDIT"]` permite solo tarjetas de crédito, `["DEBIT"]` solo tarjetas de débito y `["CREDIT", "DEBIT"]` ambas. |

* Todos los campos son opcionales. Un campo que no envíes mantiene el comportamiento por defecto.
* Los valores deben estar en mayúsculas. Una lista vacía se rechaza con `400 INVALID_PARAMETERS`.
* El objeto solo se puede definir al crear la sesión. Actualizar la sesión no lo modifica.
* Los filtros se aplican solo a la hoja de pago de Apple Pay. Las tarjetas ingresadas en el formulario de tarjeta no se ven afectadas.

> [!NOTE]
>
> El botón de Apple Pay se sigue mostrando cuando ninguna de las tarjetas del cliente es elegible. El cliente ve todas las tarjetas atenuadas en la hoja de pago.

> [!NOTE]
>
> Si tu cuenta está configurada para procesar solo tarjetas de crédito, el `supported_funding_types` enviado en la sesión tiene prioridad para Apple Pay.

| Plataforma | Versión mínima |
| - | - |
| Web | 1.11.17 |
| iOS | 2.27.0 |

## Obtener el BIN del DPAN en la respuesta del OTT

Cuando un pago se completa con Apple Pay, el SDK de iOS devuelve la respuesta completa del servicio OTT (token de un solo uso). Dentro de esta respuesta, el objeto `card_data` contiene la información de la tarjeta asociada al pago con Apple Pay, incluido el BIN del DPAN (los primeros dígitos del Device Primary Account Number usado en la transacción).

Los comercios pueden usar este objeto para obtener datos de la tarjeta, como la marca, el tipo, el emisor y el campo `iin`, que representa el BIN del DPAN. Puedes usarlo para evaluar promociones y descuentos basados en BIN, y para reportes.

En iOS, implementa `yunoCreatePayment(with:information:)` en tu `YunoPaymentDelegate` en lugar de `yunoCreatePayment(with:)`. El diccionario `information` es esta respuesta.

> [!NOTE]
>
> **Limitación**: el `iin` refleja la tarjeta por defecto seleccionada en la hoja de pago cuando se crea el pago. Si el comprador cambia de tarjeta en la hoja de pago, es posible que el `iin` no coincida con la tarjeta usada en el pago final. Evita presentar las promociones basadas en BIN como garantizadas hasta que el pago esté confirmado.

### Ejemplo de respuesta del OTT (SDK de iOS)

El siguiente ejemplo muestra la respuesta del SDK que contiene el objeto `card_data` con el campo `iin`:

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "vault_on_success": false,
  "country": "US",
  "card_data": {
    "category": "CLASSIC",
    "lfd": "8880",
    "fingerprint": null,
    "issuer_name": "BANK",
    "security_code_length": 0,
    "brand": "VISA",
    "issuer_code": null,
    "type": "CREDIT",
    "holder_name": "",
    "country_code": "US",
    "iin": "49411598",
    "number_length": 0
  },
  "vaulted_token": null,
  "installment": null,
  "token": "0ac7f1c8-aba4-4600-b080-f88e9f328c1f",
  "type": "CARD"
}
```

## Flujo de cancelación de Apple Pay

Cuando un usuario cancela el flujo de Apple Pay, el Web SDK informa el estado `CANCELED_BY_USER` y el SDK de iOS informa `userCancelled` en `Yuno.Result`.

### Metadata y paymentCreated (Web SDK)

El método `oldClosePaymentFlow` (y los eventos de cancelación relacionados) ahora incluye un parámetro opcional `metadata` con el campo `paymentCreated`. Esto permite a los comercios saber si ya se creó un pago en el backend antes de que el usuario cancelara el flujo.

* **`paymentCreated: true`**: se creó un pago (por ejemplo, durante la fase de creación del OTT). Los comercios deben revisar el estado del pago y, posiblemente, activar una llamada a `abandonPayment`.
* **`paymentCreated: false`**: no se creó ningún pago antes de la cancelación.

El SDK define automáticamente `paymentCreated = true` durante la fase `onvalidatemerchant` para asegurar el seguimiento correcto y el abandono de los pagos pendientes.

## Documentación relacionada

* [Configuración y pagos de un solo uso](https://docs.y.uno/es/docs/wallets/apple-pay/apple-pay-sdk-integration.md)
* [Pagos recurrentes](https://docs.y.uno/es/docs/wallets/apple-pay/sdk-integration/recurring-payments.md)
* [Express checkout](https://docs.y.uno/es/docs/wallets/apple-pay/sdk-integration/express-checkout.md)


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