Overview
The Settings section in the Yuno Dashboard lets you manage API credentials, invite team members, configure notifications, and control account-level preferences.
API Keys
Navigate to Developers to view and manage your credentials.
| Key | Purpose | Visibility |
|---|
public-api-key | Client-side SDK initialization | Safe to expose in frontend |
private-secret-key | Server-side API authentication | Never expose publicly |
account_id | Merchant account identifier | Sent inside request bodies (such as POST /v1/checkout/sessions and POST /v1/payments). Not an HTTP header. |
Your private-secret-key grants full API access to your account. Never include it in client-side code, version control, or logs. Use environment variables for secure storage.
Rotating Keys
Generate new keys
Click Rotate Keys in the API Keys section. New keys are generated immediately.
Update your integration
Replace old credentials in your server configuration with the new keys.
Verify functionality
Test a sandbox transaction to confirm the new keys work correctly.
Old keys expire
Previous keys remain active for 24 hours after rotation to allow for zero-downtime migration.
Team Management
Invite team members under Settings > Team.
Roles
| Role | Permissions |
|---|
| Admin | Full access: settings, API keys, team management, all features |
| Developer | View transactions, connections, routing; no settings access |
| Viewer | Read-only access to payments and analytics |
| Finance | Access to reconciliations, settlements, and financial reports |
Inviting Members
- Go to Settings > Team > Invite Member
- Enter the email address
- Select a role
- Click Send Invitation
The invitee receives an email with a link to join your Yuno account.
Team members have access to the selected environment only (sandbox or production). Invite members to both environments if needed.
Notifications
Configure alerts under Settings > Notifications.
| Notification Type | Channel | Trigger |
|---|
| Payment failures | Email, Slack | Transaction declined or errored |
| Webhook failures | Email | Webhook delivery failed after retries |
| Risk alerts | Email, Slack | Transaction flagged by risk conditions |
| Settlement | Email | New settlement report available |
| API key rotation | Email | API keys rotated |
Slack Integration
Connect Slack under Settings > Integrations > Slack to receive notifications in a channel:
- Click Connect Slack
- Authorize the Yuno app in your Slack workspace
- Select the target channel
- Choose which notification types to send
Account Preferences
| Setting | Options | Description |
|---|
| Default Currency | ISO 4217 code | Pre-fill currency in Dashboard forms |
| Timezone | IANA timezone | Timestamps in Dashboard and reports |
| Language | EN, ES, PT | Dashboard UI language |
| Two-Factor Auth | Enable/Disable | Require 2FA for all team members |
Enabling two-factor authentication is strongly recommended for production accounts. Once enabled, all team members must configure 2FA on their next login.
Environments
Each environment (sandbox and production) maintains independent settings for:
- API keys
- Provider connections
- Routing rules
- Webhook endpoints
- Risk conditions
Switch environments using the toggle in the top navigation bar.
