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

# Provider Installments

> Let Yuno consult the payment provider for available installment plans when no merchant agreement exists

**Provider** installment is when the merchant does not have a commercial agreement for a defined set of installments, so they use the installments defined by the payment processor. Yuno consults the provider of your choosing in order to get the installments available to offer your customers for each transaction.

![](https://mintcdn.com/yuno-3979e326/OWCs_QBx1vffDsih/images/reference/provider-installments/provider.gif?s=a692de8cd86bd4b42ed70fcb292f4c58)

### How to use provider installments?

While configuring your provider [Connection](https://docs.y.uno/docs/using-yuno/dashboard-overview/connections.md) in Yuno Dashboard, you can enable the installments available for the provider so we can use them in the Credit card form of the SDK for the customer to select from. For this scenario, there is no need to create a plan, as Yuno will use the plan defined by your payment processor.

> [!WARNING]
>
> **Secure Fields SDK**
>
> When using Secure Fields SDK integration, you will need to [enable the installments option](https://docs.y.uno/docs/sdks/customization/secure-fields/payment-secure-fields) while starting the checkout process.

This option is not enabled for all providers, only the ones that have Installment services that Yuno can access to get the information from. If you consider that a provider should have this feature enabled, please reach out to your account manager.

![](https://mintcdn.com/yuno-3979e326/OWCs_QBx1vffDsih/images/reference/provider-installments/image1.png?fit=max\&auto=format\&n=OWCs_QBx1vffDsih\&q=85\&s=6ddb4d8ee4e541ed6f5858b1c446ed03)

> [!CAUTION]
>
> **Routing Configuration Warning**
>
> While setting your [route](https://docs.y.uno/docs/using-yuno/dashboard-overview/routing.md) for the Card payment method, remember that having a fallback for a provider that has "Provider installments" is not supported, as different providers handle different types of installment plans. It can cause a processing error in the fallback.


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