Seller Guide
What a seller agent is, how to create one, and how to manage it once you're accepting KYAPay tokens.
Selling on Skyfire means letting buyer agents transact with a resource you run, using KYAPay tokens. This page covers the steps you take on Skyfire, and the enforcement you build on your own side.
What is a seller?
A seller agent is an agent account that publishes seller services and accepts KYAPay tokens from buyer agents. Buyer agents are created automatically at signup. A seller agent is not, so you create one explicitly.
A seller agent:
- Belongs to exactly one user, and always has the Seller role
- Creates a seller service, the resource it publishes
- Receives every token a buyer agent creates for that seller service
- Charges payment tokens
- Has its own wallet, where charged funds settle
- Can be managed in the Skyfire Dashboard, or accessed programmatically through its own API keys
An agent's role is fixed at creation. A seller agent cannot create tokens, and a buyer agent cannot charge them. For how sellers fit into the wider platform, see Platform Structure.
Your email identifies you on Skyfire. The same account can hold both a buyer agent and a seller agent, each with its own API key, and each key authorizes a different set of calls: a buyer agent's key creates tokens, and a seller agent's key verifies and charges them. Adding a seller agent to your account, through either path below, does not replace or affect any buyer agent you already have.
Seller agents publish seller services for buyer agents to find and transact with. See How Seller Services Work for what it configures, how to create one, and how to require and validate its tokens on your own backend.
Setting up on Skyfire
Create your seller agent
From the Skyfire Dashboard, start a seller account in either of two ways:
- Click the Create Seller Account checklist prompt, or
- Toggle your account type to Seller, using the switch in the upper-left corner.
Enter a Display Name, which is the name buyer agents see in the directory. Skyfire then creates the seller agent, creates its wallet, and opens the seller
Your seller agent also has a unique ID, which you use during verification. Every token created for your seller service carries it as the aud claim.
Once your seller agent exists, create a seller service, configure it, and submit it for approval. See How Seller Services Work for details.
Managing your seller agent
Your dashboard organizes seller activity into two tabs.
API keys
Generate API keys to authenticate your seller service, and view, rotate, or deactivate them as needed. These keys authorize charges on pay and kya-pay tokens, among other seller capabilities. These seller agent API keys are separate from any buyer agent API keys on the same account. See API Authentication.
Deposits
The Deposits tab shows every successful payment to your seller service: the token used, the buyer agent ID, the amount charged, and the timestamp and status.
Next steps
- For creating and configuring a seller service, see How Seller Services Work.
- For how money moves after a charge, see Payments & Settlement.
Updated 4 days ago