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

# Ejemplos de pago

> Explica los escenarios de métodos de pago que requieren información adicional del cliente dentro del flujo de checkout con el SDK.

Cuando usas el [SDK de Yuno](https://docs.y.uno/es/docs/sdks/full-checkout/web-payments), nos encargamos de cada escenario particular que pueda tener cualquier método de pago. Una vez que el cliente selecciona el método de pago y elige pagar, si se necesita información adicional para procesar el pago (además de la que nos compartiste en la integración), mostraremos un formulario que le pide al cliente esa información. Algunos ejemplos de estos escenarios son:

* **Documento/teléfono**: Algunos métodos de pago alternativos requieren el documento o el número de teléfono del cliente, por lo que, si no tienes esa información en tu integración, la pediremos en el formulario mencionado para que no tengas que hacerlo tú.
* **PSE**: Este método de pago requiere que el cliente seleccione el banco que usará para realizar el pago, por eso le ofrecemos una lista de bancos para elegir.

> [!NOTE]
>
> **Flujo `SDK_CHECKOUT`**
>
> El flujo `SDK_CHECKOUT` te permite gestionar toda la experiencia de pago integrándote directamente con nuestras API. Según tus necesidades, puedes elegir entre los siguientes flujos:
>
> * **Flujo DIRECT**: Adecuado para tarjetas (disponible solo para comercios que cumplen con PCI).
> * **Flujo REDIRECT**: Ideal para métodos de pago alternativos.
>
> Para ver ejemplos de pago detallados, consulta las secciones de cada categoría de método de pago.

Para el flujo `SDK_CHECKOUT`, toda la información se almacena en el [`One-time token`](https://docs.y.uno/es/docs/security-and-compliance/network-tokens#one-time-use-token-vs-vaulted-token-vs-network-token) devuelto por el SDK de Yuno, por lo que no tienes que cambiar tu integración según el método de pago. La estructura básica del pago es la misma para todos los métodos de pago, como en el ejemplo a continuación.

```sh Request (cURL) theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
curl --location 'https://api-sandbox.y.uno/v1/payments' \
--header 'X-Idempotency-Key: <your-X-idempotency-key>' \
--header 'public-api-key: <your-public-api-key>' \
--header 'private-secret-key: <your-private-secret-key>' \
--header 'Content-Type: application/json' \
--data '{
    "description": "SDK Checkout",
    "account_id": "<account_id>",
    "merchant_order_id": "123456",
    "merchant_reference": "reference_001",
    "country": "US",
    "amount": {
        "currency": "USD",
        "value": 100
    },
    "checkout": {
        "session": "<checkout_session>"
    },
    "customer_payer": {
        "id": "<customer_id>"
    },
    "payment_method": {
        "token": "<one_time_token>"
    }
}'
```

```json Response(JSON) theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
    "id": "182ffc6e-9b3b-4e66-855b-94d2cfe07354",
    "account_id": "493e9374-510a-4201-9e09-de669d75f256",
    "description": "Test Card",
    "country": "US",
    "status": "SUCCEEDED",
    "sub_status": "APPROVED",
    "merchant_order_id": "0000022",
    "created_at": "2023-07-20T20:42:24.144148Z",
    "updated_at": "2023-07-20T20:42:28.479089Z",
    "amount": {
        "captured": 0.00,
        "currency": "USD",
        "refunded": 0.00,
        "value": 100.00
    },
    "checkout": {
        "session": "c1ded0b9-97ab-46f4-8cdb-ee3ce693f7f6",
        "sdk_action_required": false
    },
    "payment_method": {
        "vaulted_token": "f4ef4bd4-984e-43ca-b070-e00a9c66be6b",
        "type": "CARD",
        "vault_on_success": true,
        "token": "f03b1dc7-a26b-48ca-93e3-3383fa3c17e8",
        "payment_method_detail": {
            "card": {
                "verify": null,
                "capture": true,
                "installments": 1,
                "installments_plan_id": null,
                "installments_total_amount": null,
                "first_installment_deferral": 0,
                "installments_type": "MERCHANT",
                "installment_amount": null,
                "soft_descriptor": "",
                "authorization_code": "385876",
                "retrieval_reference_number": "",
                "acquirer_reference_number": "",
                "voucher": null,
                "card_data": {
                    "holder_name": "Fannie Weissnat",
                    "iin": "41961111",
                    "lfd": "0010",
                    "number_length": 16,
                    "security_code_length": 3,
                    "brand": "VISA",
                    "issuer_name": "METABANK",
                    "issuer_code": "US_METABANK",
                    "category": "PREPAID",
                    "type": "PREPAID",
                    "three_d_secure": {
                        "setup_id": null,
                        "token": null,
                        "collect_url": null,
                        "setup_reference_id": null,
                        "developer_id": null,
                        "solution_id": null,
                        "code": null,
                        "version": null,
                        "electronic_commerce_indicator": null,
                        "cryptogram": null,
                        "transaction_id": null,
                        "acs_id": null,
                        "ds_id": null,
                        "pares_status": null
                    }
                }
            }
        }
    },
    "customer_payer": {
        "id": "d7cd334c-da1e-444a-8502-2f747fe67c52",
        "merchant_customer_id": "1689885733",
        "first_name": "John",
        "last_name": "Smith",
        "gender": "M",
        "date_of_birth": null,
        "email": "john.smith@example.com",
        "nationality": null,
        "ip_address": null,
        "device_fingerprint": null,
        "browser_info": {
            "user_agent": "",
            "accept_header": "",
            "accept_content": null,
            "accept_browser": null,
            "color_depth": "",
            "screen_height": "",
            "screen_width": "",
            "javascript_enabled": null,
            "java_enabled": null,
            "browser_time_difference": null,
            "language": ""
        },
        "document": {
            "document_type": "PASSPORT",
            "document_number": "38799992"
        },
        "phone": null,
        "billing_address": null,
        "shipping_address": null
    },
    "additional_data": null,
    "taxes": null,
    "transactions": {
        "id": "10d8b481-f6d9-4fe3-98b5-a890d8a12ca9",
        "type": "PURCHASE",
        "status": "SUCCEEDED",
        "category": "CARD",
        "amount": 100.00,
        "provider_id": "DLOCAL",
        "payment_method": {
            "vaulted_token": "f4ef4bd4-984e-43ca-b070-e00a9c66be6b",
            "type": "CARD",
            "vault_on_success": true,
            "token": "f03b1dc7-a26b-48ca-93e3-3383fa3c17e8",
            "detail": {
                "card": {
                    "verify": null,
                    "capture": true,
                    "installments": 1,
                    "installments_plan_id": null,
                    "installments_total_amount": null,
                    "first_installment_deferral": 0,
                    "installments_type": "MERCHANT",
                    "installment_amount": null,
                    "soft_descriptor": "",
                    "authorization_code": "385876",
                    "retrieval_reference_number": "",
                    "acquirer_reference_number": "",
                    "voucher": null,
                    "card_data": {
                        "holder_name": "Fannie Weissnat",
                        "iin": "41961111",
                        "lfd": "0010",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISA",
                        "issuer_name": "METABANK",
                        "issuer_code": "US_METABANK",
                        "category": "PREPAID",
                        "type": "PREPAID",
                        "three_d_secure": {
                            "setup_id": null,
                            "token": null,
                            "collect_url": null,
                            "setup_reference_id": null,
                            "developer_id": null,
                            "solution_id": null,
                            "code": null,
                            "version": null,
                            "electronic_commerce_indicator": null,
                            "cryptogram": null,
                            "transaction_id": null,
                            "acs_id": null,
                            "ds_id": null,
                            "pares_status": null
                        }
                    }
                }
            }
        },
        "response_code": "SUCCEEDED",
        "response_message": "Transaction successful",
        "reason": null,
        "description": "Test Card",
        "merchant_reference": "referece_0001",
        "provider_data": {
            "id": "DLOCAL",
            "transaction_id": "T-385928-006c26bc-db49-467c-ba60-6c4485cc6120",
            "account_id": "",
            "status": "PAID",
            "sub_status": "",
            "status_detail": "200",
            "response_message": "The payment was paid.",
            "raw_response": {
                "value": "{\"id\":\"T-385928-006c26bc-db49-467c-ba60-6c4485cc6120\",\"amount\":100.00,\"currency\":\"ARS\",\"payment_method_id\":\"CARD\",\"payment_method_type\":\"CARD\",\"payment_method_flow\":\"DIRECT\",\"country\":\"AR\",\"card\":{\"holder_name\":\"Fannie Weissnat\",\"expiration_month\":3,\"expiration_year\":2024,\"brand\":\"VI\",\"last4\":\"0010\",\"installments\":1,\"installments_responsible\":\"customer\"},\"three_dsecure\":{},\"created_date\":\"2023-07-20T20:42:25.000+0000\",\"approved_date\":\"2023-07-20T20:42:28.000+0000\",\"status\":\"PAID\",\"status_detail\":\"The payment was paid.\",\"status_code\":\"200\",\"order_id\":\"10d8b481-f6d9-4fe3-98b5-a890d8a12ca9\",\"description\":\"Test Cards\",\"notification_url\":\"https://sandbox.y.uno/dlocal-webhook/v1/confirmations\",\"acquirer\":{\"authorization_code\":\"385876\"}}"
            },
            "third_party_transaction_id": ""
        },
        "three_d_secure_action_required": null,
        "created_at": "2023-07-20T20:42:24.279905Z",
        "updated_at": "2023-07-20T20:42:28.346109Z"
    },
    "split": [],
    "callback_url": "https://google.com/?checkoutSession=c1ded0b9-97ab-46f4-8cdb-ee3ce693f7f6",
    "workflow": "SDK_CHECKOUT",
    "metadata": []
}
```


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