> ## Documentation Index
> Fetch the complete documentation index at: https://yn-c9bb3266.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment methods

> How Yuno models payment methods, what fields each one needs in a payment request, and where to find the list available to your account.

## Overview

Yuno supports 1000+ payment methods across 194 countries through 300+ providers. Coverage, processors, and availability move frequently, so we don't publish a static catalog here. The set of methods available on a given transaction is driven by the country, currency, and your provider configuration in the Dashboard.

<Note>
  For the list of methods available on your account, current country and currency coverage, and the integration guide for each one, contact your Yuno technical account manager.
</Note>

## Method specific requirements

Different methods require different fields in the payment request.

### Cards

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "payment_method": {
    "type": "CARD",
    "token": "tok_from-the-sdk"
  }
}
```

<Warning>
  Sending raw card data directly to the API requires PCI DSS compliance. Use the [Yuno SDK](/guides/sdk/overview) to tokenize on the client and stay out of PCI scope.
</Warning>

### Pix (Brazil)

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "payment_method": { "type": "PIX" },
  "country": "BR",
  "amount": { "currency": "BRL", "value": 100.00 },
  "customer": {
    "document": {
      "document_type": "CPF",
      "document_number": "12345678901"
    }
  }
}
```

<Note>
  Pix requires `customer.document` with a valid CPF (individuals) or CNPJ (businesses). The response includes a QR code and a copy and paste code for the customer.
</Note>

### Boleto (Brazil)

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "payment_method": { "type": "BOLETO" },
  "country": "BR",
  "amount": { "currency": "BRL", "value": 200.00 },
  "customer": {
    "document": {
      "document_type": "CPF",
      "document_number": "12345678901"
    },
    "email": "customer@example.com"
  }
}
```

Boleto is asynchronous. The customer receives a bank slip and pays at a bank or through online banking. Use [webhooks](/core-concepts/webhooks) for the final confirmation.

### SEPA Direct Debit (Europe)

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "payment_method": { "type": "SEPA_DIRECT_DEBIT" },
  "country": "DE",
  "amount": { "currency": "EUR", "value": 49.99 },
  "customer": {
    "email": "kunde@example.com",
    "iban": "DE89370400440532013000"
  }
}
```

<Note>
  SEPA Direct Debit covers 36 European countries in EUR. The customer's IBAN is required. Mandates and settlement follow the SEPA Core scheme. Settlement timing depends on the processor. Confirm with your acquirer.
</Note>

### iDEAL (Netherlands)

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "payment_method": { "type": "IDEAL" },
  "country": "NL",
  "amount": { "currency": "EUR", "value": 75.00 },
  "customer": {
    "email": "klant@example.com"
  }
}
```

iDEAL redirects the customer to their Dutch bank to authorize the transfer. The response includes a `redirect_url`. Use [webhooks](/core-concepts/webhooks) for definitive confirmation.

### UPI (India)

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "payment_method": { "type": "UPI" },
  "country": "IN",
  "amount": { "currency": "INR", "value": 999.00 },
  "customer": {
    "email": "customer@example.com",
    "vpa": "customer@upi"
  }
}
```

<Note>
  UPI requires a Virtual Payment Address (VPA), for example `customer@upi` or `customer@paytm`. The customer receives a payment request in their UPI app and authorizes with their PIN.
</Note>

### Digital wallets (global)

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "payment_method": {
    "type": "WALLET",
    "wallet_type": "APPLE_PAY",
    "token": "wallet-token-from-sdk"
  },
  "country": "US",
  "amount": { "currency": "USD", "value": 29.99 },
  "customer": {
    "email": "customer@example.com"
  }
}
```

Digital wallets (Apple Pay, Google Pay, GrabPay) require SDK tokenization. The wallet token is produced on the client and passed to the API. See [digital wallets](/features/digital-wallets/overview).

## Discover available methods

The checkout session response includes `available_payment_methods` for the given country, currency, and configured providers.

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
curl --request GET \
  --url https://api-sandbox.y.uno/v1/checkout/sessions/{checkout_session_id}/payment-methods \
  --header 'public-api-key: your-public-api-key' \
  --header 'private-secret-key: your-private-secret-key' \
```

See [Get payment methods](/api-reference/checkout-sessions/get-payment-methods).

<Note>
  If a method you expect is missing from the list, verify it is enabled in **Dashboard > Settings > Payment Methods** for the target country.
</Note>

## Enroll (vault) a method

Save a method for future use by passing `"vaulted_token": true` in the payment request along with a `customer_id`. See [tokens](/core-concepts/tokens) for lifecycle details and [Enroll payment method](/api-reference/payment-methods/enroll) for the dedicated endpoint.

## List saved methods

Every vaulted method attached to a customer lives at `GET /v1/customers/{customer_id}/payment-methods`. See [tokens](/core-concepts/tokens#list-vaulted-methods) for the example and [List payment methods](/api-reference/payment-methods/list) for the full schema. Responses include masked details (last 4 for cards, masked keys for Pix) and the vaulted token ID for one-click payments.

## What next

<div className="mdx-card-tiles">
  <CardGroup cols={2}>
    <Card title="Payment methods by region" icon="globe" href="/guides/payment-methods/by-region">
      Full per country list with required customer fields.
    </Card>

    <Card title="Tokens" icon="key" href="/core-concepts/tokens">
      How one time and vaulted tokens work with methods.
    </Card>

    <Card title="Payment method object" icon="book" href="/api-reference/payment-methods/object">
      The full Payment method schema in the API reference.
    </Card>

    <Card title="Payments" icon="credit-card" href="/core-concepts/payments">
      Use a method to actually create a charge.
    </Card>
  </CardGroup>
</div>