Account management

Your VINR account has a hierarchy of entities, users, and access controls. This page covers how accounts are structured, how to add and manage team members, how to enable SSO and MFA, and how to read the balances panel.

Account structureAskCopy

A VINR account is built around a root organization that can contain one or more merchant accounts. Each merchant account has its own API credentials, payout schedule, and balance — useful if you operate multiple brands, geographies, or legal entities under one contract.

Organization
├── Merchant account A  (e.g. "VINR EU")
│   ├── API credentials
│   ├── Balance
│   └── Payout account
└── Merchant account B  (e.g. "VINR US")
    ├── API credentials
    ├── Balance
    └── Payout account

Contact support@vinr.com to request additional merchant accounts. Each account goes through a brief KYC review before going live.

User rolesAskCopy

VINR uses role-based access control. Assign the minimum role needed — the API never depends on a user's dashboard role.

Invite a team member

Go to Dashboard → Settings → Team and click Invite. Enter the email and role. The invitation link expires in 72 hours.

// Invite via API (Admin or Owner credentials required)
await vinr.team.invitations.create({
  email: 'maria@example.com',
  role: 'finance',
  merchantAccountId: 'ma_...',   // omit to grant org-level access
});

Remove a user

Revoking access is immediate — the user's session tokens are invalidated and existing API keys they created are not affected (keys are scoped to the merchant account, not the user).

await vinr.team.members.remove('mbr_...');

Single sign-on (SSO)AskCopy

VINR supports SAML 2.0 SSO via your identity provider (Okta, Azure AD, Google Workspace, and others). Once enabled, team members must sign in through your IdP — email/password login is disabled for SSO-managed users.

Multi-factor authenticationAskCopy

MFA is enforced by default for Owner and Admin accounts. Supported methods:

• TOTP — any authenticator app (Google Authenticator, Authy, 1Password)
• WebAuthn / passkey — hardware security keys (YubiKey) or platform passkeys

BalancesAskCopy

The Balances panel (Dashboard → Finance → Balances) shows three figures per currency:

const balance = await vinr.balance.retrieve();
// {
//   available: [{ amount: 184250, currency: 'EUR' }],
//   pending:   [{ amount:  39000, currency: 'EUR' }],
//   reserved:  [{ amount:   5000, currency: 'EUR' }]
// }

The pending balance becomes available as each payment's funding delay clears (typically 2–7 days depending on payment method and plan). Reserve amounts are released automatically as your rolling window advances — see your contract for the reserve percentage and release schedule.

Notification centerAskCopy

Configure which events trigger email or webhook notifications per user or per role under Dashboard → Settings → Notifications:

• Balance below threshold
• Payout created / paid / failed
• Dispute opened / escalated
• Settlement delay
• API error rate spike
• Team member added / removed

Webhook notifications go to your configured webhook endpoints and are distinct from payment event webhooks — they do not carry pay_ or po_ data, only operational alerts.

Next stepsAskCopy