Skip to main content
A customer is a Party who has authorized your Agents to act for them. The customer resource is that relationship seen from your side: who connected, which of your agents they authorized, and what each agent may do. This relationship is Natural Connect. Start one by inviting a customer. A customer’s id is their party ID (pty_*). There are two ways to connect a customer: invite a specific customer by email or phone, or create an invitation link that any customer can open. Both offer the same thing - a set of your agents, with the permissions and limits you set, for the customer to approve.

​
Invitations

Every customer relationship starts as an invitation. It names one or more agents, the permissions you’re asking for, and optionally a per-transaction limit; the customer sees exactly what you asked for, and nothing moves until they accept. Pending invitations can be revoked, and accepted ones appear in your customer list. An invitation link is an invitation with no recipient. It carries the same offer, one or more agents with the permissions and limits you set, and any customer who opens it sees exactly that offer; nothing moves until they accept. The link’s URL is returned once, when you create it. Revoking a link stops new connections and leaves existing ones untouched. Each connection records the link that created it, so one link per channel tells you where every customer came from.

​
Acting for a customer

Each agent-customer pair carries its own permissions and limits. Depending on the grant, an agent can send and request payments on the customer’s behalf.

​
Revoking the relationship

Revoking an agent and disconnecting are different operations. Revoking an agent — even the last one — removes that agent’s authority but leaves the connection itself active. Disconnecting ends the connection and revokes every remaining agent at once; either side can disconnect at any time, you through the API or dashboard and the customer from theirs. New activity stops immediately, and events already delivered to your endpoints remain readable afterward.