Skip to navigation

Authentication

Connecting an assistant uses the same secure sign-in you already know from Yoco. You never share a password or a key with your assistant. You sign in with Yoco directly and approve the access you’re comfortable with.

How sign-in works

1

Connect

You add the connection URL to your assistant. See Connect your client.

2

Sign in

Your assistant opens a Yoco sign-in page. You sign in directly with Yoco.

3

Approve access

Yoco shows you exactly what the assistant is requesting access to. You approve to continue.

4

Use it

Your assistant can use the approved tools on your behalf.

What you’re granting access to

The access you approve maps to clear permissions over your Yoco business. Each tool requires one or more permissions, such as reading your payments and orders, reading your payouts, or creating and removing payment links. The Tool reference lists the permission each tool needs.

Your assistant can only use the tools covered by the permissions you approve.

Tools you haven’t granted access to are not shown to your assistant. They don’t appear in its tool list rather than failing when called. If your assistant lists fewer Yoco tools than you expect, it usually means a permission wasn’t granted. Reconnect and approve the access you need.

Technical details

For those configuring a client or integrating programmatically:

  • Authorization uses OAuth 2.1 via the existing Yoco OAuth flow, scoped to a single merchant.
  • PKCE with the S256 method is required.
  • Access is merchant-scoped: an assistant acts on behalf of the merchant who signed in.
  • There is no Personal API key support; OAuth sign-in is the only way to connect.