Skip to main content

Overview

Connections define which payment providers process your transactions. Each connection links a provider (e.g., Stripe, Adyen, Mercado Pago) to your Yuno account with the provider’s API credentials.

Adding a Connection

1

Navigate to Connections

Go to Dashboard > Connections and click Add Connection.
2

Select a provider

Browse the provider catalog or search by name. Providers are grouped by region and supported payment methods.
3

Enter provider credentials

Input the API keys or credentials required by the selected provider. Each provider has different credential requirements:
Provider TypeTypical Credentials
Card processorsAPI key, secret key, merchant ID
Local methodsAPI key, account ID
Bank transfersAPI key, branch code
Store provider credentials securely. Yuno encrypts credentials at rest, but ensure you are entering them in the correct environment (sandbox vs. production).
4

Configure payment methods

Select which payment methods this connection supports. Available methods depend on the provider and country.
5

Set country availability

Specify which countries this connection serves. A provider can be configured for one or multiple countries.
6

Activate the connection

Toggle the connection to Active. Transactions will begin routing to this provider based on your Routing Rules.

Managing Connections

Connection Status

StatusDescription
ActiveAccepting transactions
InactiveConfigured but not processing
ErrorCredential or configuration issue

Edit a Connection

Click on an existing connection to modify credentials, payment methods, or country availability. Changes take effect immediately.

Delete a Connection

Deleting a connection is permanent and cannot be undone. Ensure no active routing rules reference the connection before deletion. In-flight transactions will complete through the existing connection.

Multiple Connections

You can configure multiple connections for the same payment method and country. This enables:
  • Failover: Route to a backup provider if the primary is down
  • Cost optimization: Choose the lowest-cost provider per transaction
  • A/B testing: Compare provider performance
Use Routing Rules to control how traffic is distributed across multiple connections.

Provider Availability

Provider availability varies by country and payment method. Contact Yuno support if you need a provider that is not listed in the catalog.

Sandbox Connections

In sandbox, you can use the Yuno Testing Gateway as a simulated provider. This is pre-configured in new sandbox accounts and does not require external credentials.