Skip to main content

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

​
Method specific requirements

Different methods require different fields in the payment request.

​
Cards

{
  "payment_method": {
    "type": "CARD",
    "token": "tok_from-the-sdk"
  }
}
Sending raw card data directly to the API requires PCI DSS compliance. Use the Yuno SDK to tokenize on the client and stay out of PCI scope.

​
Pix (Brazil)

{
  "payment_method": { "type": "PIX" },
  "country": "BR",
  "amount": { "currency": "BRL", "value": 100.00 },
  "customer": {
    "document": {
      "document_type": "CPF",
      "document_number": "12345678901"
    }
  }
}
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.

​
Boleto (Brazil)

{
  "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 for the final confirmation.

​
SEPA Direct Debit (Europe)

{
  "payment_method": { "type": "SEPA_DIRECT_DEBIT" },
  "country": "DE",
  "amount": { "currency": "EUR", "value": 49.99 },
  "customer": {
    "email": "kunde@example.com",
    "iban": "DE89370400440532013000"
  }
}
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.

​
iDEAL (Netherlands)

{
  "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 for definitive confirmation.

​
UPI (India)

{
  "payment_method": { "type": "UPI" },
  "country": "IN",
  "amount": { "currency": "INR", "value": 999.00 },
  "customer": {
    "email": "customer@example.com",
    "vpa": "customer@upi"
  }
}
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.

​
Digital wallets (global)

{
  "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.

​
Discover available methods

The checkout session response includes available_payment_methods for the given country, currency, and configured providers. 
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.
If a method you expect is missing from the list, verify it is enabled in Dashboard > Settings > Payment Methods for the target country.

​
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 for lifecycle details and Enroll payment method 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 for the example and List payment methods 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

Payment methods by region

Full per country list with required customer fields.

Tokens

How one time and vaulted tokens work with methods.

Payment method object

The full Payment method schema in the API reference.

Payments

Use a method to actually create a charge.