Refersion
Connect Refersion to review affiliates and their sales, approve commissions, credit orders, and manage offers and coupon codes.
Nothing has to be typed into PopMCP. You click Authorize with Refersion, sign in to Refersion and approve PopMCP. There is no developer app or callback URL to set up. Under More options you can add the Public Key and Secret Key (to create affiliates and report orders) and a GraphQL token (to read past payments), or use a Client ID and Client Secret instead of signing in. All of them come from Settings, Integrations, Refersion API Keys.
Paid plan required before this connector works
No one reviews you, but Refersion sells API access by plan. Its pricing page lists API access on Growth and describes Scale as including everything; the Launch plan does not list it.
- Typical wait
- None. The connection works as soon as the plan includes API access.
- Cost
- From Refersion's pricing page: Growth is $199/month, or $159/month billed yearly, plus 2% of affiliate-driven sales. Scale is priced by Refersion's sales team.
- Blocked until approved
- All tools. Webhook tools and product-level commissions can also depend on the plan, and answer 402 when it does not include them.
- Works meanwhile
- Nothing without API access. Check your plan under billing in Refersion before connecting.
Where to apply: No application. Upgrade the plan in Refersion, then connect.
- If a plan is downgraded to one without webhooks, Refersion disables endpoints rather than deleting them, and they return when the plan includes webhooks again.
- Setup time
- 1 min
- Auth
- OAuth authorization
- API base URL
- https://api.refersion.com/v2026-08
Before you begin
- A Refersion merchant account on a plan that includes API access. Refersion's pricing page lists it on Growth and describes Scale as including everything
- A login that manages the Refersion account you want to connect
- Pop-up blockers must allow the Refersion sign-in window to open
- Only if the AI should change anything: an owner or admin in PopMCP to allow write actions
Get your credentials
Start the connection from PopMCP
Open the Refersion connector in PopMCP and click Authorize with Refersion. There are no fields to fill in: no API key, no developer app and nothing to register.
Sign in to Refersion and approve
The sign-in window opens on auth.refersion.com. Sign in with the login that manages the account the AI should work with, then approve PopMCP. If your login reaches more than one store, pick the account there.
Sign in to Refersion
PopMCP is asking to use your Refersion account.
PopMCP never sees your Refersion password. Refersion hands back a token once you approve.
Add the optional keys
Optional. To let the AI create affiliates, add per-SKU commission, cancel an order's commission, total conversions, fetch report links or report orders, open Settings, Integrations, Refersion API Keys in Refersion and copy the Public Key and Secret Key. To let it read past payments and marketing assets, generate a Refersion GraphQL Token on the same page. Paste them in PopMCP under More options before you click Authorize.
Refersion API Keys
Keys for this Refersion account.
Or use a Client ID and Secret instead
Prefer not to sign in? On the same page, in the OAuth section, choose Generate OAuth Client and copy the Client ID and Client Secret. The secret is shown only once. In PopMCP open More options, paste both and connect. Keep this client just for PopMCP: asking Refersion for a new token cancels the last one of its kind, so another integration sharing the client would stop working.
OAuth
Each client belongs to this account.
The Client Secret is shown once, when the client is created.
Check it is connected
The Refersion card in PopMCP reads Connected, with the account name and a note on which optional keys are on. Every Refersion endpoint is a tool. New connections start read-only, so changes wait until an owner or admin allows write actions in PopMCP.
Refersion
- Status
- Connected
- Account
- Acme Store
- Access
- Read only
Connect in PopMCP
Open your workspace, choose Refersion in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| How you connectpreset | Click Authorize, sign in to Refersion and approve. There is nothing to copy or paste. Your Refersion plan needs to include API access. |
| Public Key (to create affiliates and report orders)text | Optional. Copy it from Settings, Integrations, Refersion API Keys in Refersion. With the Secret Key it lets your AI create affiliates, add product commissions, cancel order commissions and report orders. |
| Secret Keysecret | Optional. Goes with the Public Key above.Encrypted with AES-256-GCM on save and never shown again. |
| GraphQL token (to read payments)secret | Optional. Generate it under Refersion GraphQL Token on the same page. It lets your AI read past payments to affiliates and marketing assets.Encrypted with AES-256-GCM on save and never shown again. |
| Client ID (instead of signing in)text | Only if you prefer not to sign in: choose Generate OAuth Client on the same page and paste both values. Keep this client just for PopMCP, because a new token cancels the last one. |
| Client Secretsecret | Shown once by Refersion when the client is made.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against Refersion immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Permissions PopMCP requests
These are the scopes sent to Refersion at authorization time.
| Scope | Why PopMCP asks for it |
|---|---|
| offline_access | Lets PopMCP renew the access token, so the connection keeps working without another sign-in. |
| account:read | Names the Refersion account the connection acts on. |
| affiliates:read | Required by the tools this connector exposes. |
| affiliates:write | Required by the tools this connector exposes. |
| clicks:read | Read click records. |
| conversions:read | Required by the tools this connector exposes. |
| conversions:write | Required by the tools this connector exposes. |
| exclusions:read | Required by the tools this connector exposes. |
| exclusions:write | Required by the tools this connector exposes. |
| offers:read | Required by the tools this connector exposes. |
| offers:write | Required by the tools this connector exposes. |
| orders:read | Look up an order before crediting it. |
| payments:read | Required by the tools this connector exposes. |
| payments:write | Required by the tools this connector exposes. |
| promotion_methods:read | Required by the tools this connector exposes. |
| promotion_methods:write | Required by the tools this connector exposes. |
| prospects:read | Required by the tools this connector exposes. |
| prospects:write | Required by the tools this connector exposes. |
| reports:read | Part of what Refersion's sign-in offers, for reports. |
| webhook_endpoints:read | Required by the tools this connector exposes. |
| webhook_endpoints:write | Required by the tools this connector exposes. |
Verify it worked
The Refersion card in PopMCP shows Connected with the account name. Asking the AI for the connection profile (refersion_connection_profile) shows which optional keys are on, and asking how the program is doing (refersion_program_summary) returns affiliate and conversion counts rather than an authorization error.
Troubleshooting
The sign-in window never opens
Why: A pop-up blocker is stopping the Refersion sign-in window.
Fix: Allow pop-ups for PopMCP in your browser and click Authorize with Refersion again.
"Your Refersion plan does not include API access"
Why: API access is listed from the Growth plan up.
Fix: Upgrade in Refersion, then connect again.
"Refersion did not accept that Client ID and Client Secret"
Why: A value was copied in part, or the client was revoked. The secret cannot be shown again.
Fix: Generate a new OAuth client under Settings, Integrations, Refersion API Keys and paste the new pair.
"Refersion did not accept the Public Key and Secret Key"
Why: A key was copied in part or replaced.
Fix: Copy both again from Settings, Integrations, Refersion API Keys, or leave both empty.
"Your Refersion sign-in has ended"
Why: The sign-in expired or PopMCP's access was removed in Refersion.
Fix: Reconnect Refersion in PopMCP: one click on Authorize with Refersion.
Creating an affiliate says the Public Key and Secret Key are missing
Why: Those calls use Refersion's older API, which a sign-in does not reach.
Fix: Reconnect Refersion and paste both keys under More options.
Webhook tools answer 402
Why: Your Refersion plan does not include webhooks.
Fix: Upgrade in Refersion. Endpoints you already made are kept and come back when the plan includes webhooks again.
Reference
Selling Partner
Connect Selling Partner to manage orders, listings, FBA inventory, pricing, fees, reports, feeds, and finances for your seller account.
BigCommerce
Connect BigCommerce to manage products, categories, orders, customers, carts, checkouts, and coupons for your store. MCP setup for Claude and ChatGPT.