E-Commerce

Refersion
API integration

Ship E-Commerce features without building the integration. Full Refersion API access via Proxy and 40+ MCP-ready tools for AI agents — extend models and mappings to fit your product.

Talk to us

Use Cases

Why integrate with Refersion

Common scenarios for SaaS companies building Refersion integrations for their customers.

Turn influencer CRMs into full affiliate lifecycle tools

Influencer and creator management platforms can promote signed creators into commissioned affiliates without leaving the CRM, provisioning coupon codes, tracking links, and pulling weekly performance directly into creator profiles.

Credit subscription renewals and off-platform orders

Billing and checkout SaaS can push recurring charges, upsells, or offline orders into Refersion as manual conversions so affiliates get properly credited beyond the initial storefront checkout.

Unify affiliate performance into e-commerce analytics dashboards

Analytics platforms can ingest clicks, conversions, and affiliate activity to calculate true CAC, pending commission liability, and channel ROI alongside paid media and organic data.

Automate affiliate recruitment and lifecycle emails

Outreach and email marketing tools can pull Refersion's AI-recommended prospects and personalized pitches into cold sequences, and trigger onboarding flows via webhooks when new affiliates register.

Automate commission payouts and status reconciliation

Fintech and payout platforms can poll approved conversions, process payments externally, and bulk-update Refersion conversion statuses to keep both systems in sync without manual work.

What You Can Build

Ship these features with Truto + Refersion

Concrete product features your team can ship faster by leveraging Truto’s Refersion integration instead of building from scratch.

One-click affiliate provisioning

Create a Refersion affiliate, assign them to an offer, generate a personalized coupon or SKU promotion method, and return their tracking link — all from your app's UI.

Manual conversion crediting for external orders

Push renewals, offline sales, or reconciled orders into Refersion using credit-by-order-ID or manual credit endpoints so affiliates are compensated for revenue generated outside the storefront.

Real-time affiliate and conversion event listeners

Register Refersion webhook endpoints programmatically on behalf of your users to trigger workflows the moment a new conversion, affiliate signup, or status change occurs.

Native affiliate performance widgets

Display rolling 10-week activity, click counts, and conversion totals per affiliate inside your product using the activity and count endpoints.

Bulk conversion status management

Let ops teams move batches of conversions from PENDING to APPROVED, PAID, or DENIED after external payout or fraud checks using the bulk update endpoint.

AI prospect discovery pipeline

Surface Refersion's AI-recommended affiliate prospects and their generated pitch messages inside your outreach tool to jumpstart recruitment campaigns.

SuperAI

Refersion AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

list_all_refersion_affiliates

List Refersion affiliates with profile information, offer details, and performance metrics. Supports filtering by status, search term, offer IDs, and performance thresholds. Returns: id, code, isTestAccount, ableToEdit, plus, uniqueMerchantId, parentAffiliateId, status, locked, firstName, lastName, company, email, paypalEmail, phone, offer, address, url, createdAt, updatedAt, timezone, source,…

update_a_refersion_affiliate_by_id

Update a Refersion affiliate's details including status, lock state, offer assignment, custom fields, URL configuration, and profile information. Supports partial updates — only provided fields are updated. The locked field cannot be combined with status in the same request, and is only accepted when the affiliate's current status is APPROVED. Required: id. Returns an empty 204 response on…

delete_a_refersion_affiliate_by_id

Soft-delete a Refersion affiliate by setting its status to DELETED. The affiliate must not have any pending or unpaid conversions. Already-deleted or hidden affiliates are treated as not found. Required: id. Returns an empty 204 response on success.

refersion_affiliates_get_activity

Get weekly conversion, payment, and click activity for a specific Refersion affiliate. Returns a merged timeline ordered by date descending, capped at 10 entries. Each source is independently bounded to the rolling last 10 weeks and capped at 5 entries. The response is polymorphic on type: conversion entries include conversionCount, total, and currency; payment entries include…

refersion_affiliates_get_count

Get Refersion affiliate counts grouped by status (pending, approved, denied). The deniedCount includes BANNED affiliates. Supports the same filter parameters as the list affiliates endpoint; performance-specific filters narrow only the approvedCount. When called without filters, results are cached for 1 minute. Returns: pendingCount, approvedCount, deniedCount.

refersion_affiliates_get_amazon_products

List Amazon-marketplace-enabled products for a verified affiliate in Refersion. Each product includes the combined product/variant name, image URL, and Amazon product URL. Returns: id, fullName, imageUrl, productUrl, pendingCount, approvedCount, deniedCount. Required: affiliate_id.

refersion_affiliates_get_custom_fields

List all custom registration fields configured by the merchant for a given affiliate in Refersion, along with the affiliate's corresponding values. Returns: id, type, pendingCount, approvedCount, deniedCount. Required: affiliate_id.

refersion_affiliates_delete_custom_field

Clear an affiliate's value for a specific custom registration field in Refersion. The custom field definition itself is not modified; this operation is idempotent. Returns an empty 204 response on success. Required: affiliate_id, custom_field_id.

refersion_affiliates_get_link

Generate an affiliate tracking link in Refersion. Returns: link, pendingCount, approvedCount, deniedCount. When affiliate_id is 0, the endpoint uses the default test affiliate for the account; optional parameters support test link generation, custom URLs, and marketing asset association. Required: affiliate_id.

refersion_affiliates_resend_welcome_email

Resend the welcome email to a Refersion affiliate. The email type is determined by the affiliate's current status (ACTIVE, PENDING, or DENIED). Returns: message, pendingCount, approvedCount, deniedCount. Required: affiliate_id, affiliateId. A 15-minute throttle is enforced between resends.

refersion_affiliates_bulk_update

Update an affiliate's value for a specific custom registration field in Refersion. Returns: affiliateId, customFieldId, value. Required: affiliate_id, custom_field_id, value.

list_all_refersion_conversions

List Refersion conversions with filtering by status, order ID, affiliate, date range, offer, and platform. Returns: id, type, createdAt, pendingCount, approvedCount, paidCount, deniedCount, unqualifiedCount. Supports sorting by order ID, affiliate, type, revenue, commission, date, source, and status.

get_single_refersion_conversion_by_id

Get the full detail of a single Refersion conversion by id. Returns: id, type, createdAt, updatedAt, pendingCount, approvedCount, paidCount, deniedCount, unqualifiedCount. Required: id.

refersion_conversions_get_count

Get counts of Refersion conversions grouped by status (pending, approved, paid, denied, unqualified). Returns: pendingCount, approvedCount, paidCount, deniedCount, unqualifiedCount. Supports the same filters as the conversions list endpoint excluding status, page, limit, sortBy, and sortOrder. Unfiltered requests are cached for 1 minute per client; filtered requests bypass the cache.

refersion_conversions_credit_order_id

Credit an existing order from the Refersion conversion queue to a specified affiliate. The order is queued for processing and will be converted asynchronously. Returns: message. Required: conversionQueueId, affiliateId, approvalStatus.

refersion_conversions_create_manual_credit

Create a manual credit conversion for an affiliate in Refersion. Supports PENDING, APPROVED, and DENIED approval statuses; APPROVED and DENIED trigger a notification and create a conversion_info record. Returns: conversionId. Required: affiliateId, commissionTotal, currency, approvalStatus.

refersion_conversions_bulk_update

Update the status of a single Refersion conversion, supporting transitions between PENDING, APPROVED, DENIED, and UNQUALIFIED statuses based on a defined transition matrix. Creates an audit trail and dispatches webhook notifications for APPROVED and DENIED transitions. Returns an empty 204 response on success. Required: conversion_id, status.

list_all_refersion_offers

List Refersion offers with optional filtering by offer type (multi-value, OR semantics), name/ID search, and performance-range criteria across pending, 30-day, and total buckets. Returns: id, publicId, name, commission, returnCustomerCommission, returningCustomerFlatRateCurrency, flatRateCurrency, commissionTerms, isRequireNewCustomer, isSubscriptionsDenyRenewals, attributionWindow, isDefault,…

update_a_refersion_offer_by_id

Update an existing Refersion offer by id with partial field updates. Returns an empty 204 response on success. Required: id. Cannot set both isDefault and isPrivate to true; passing id 0 updates the client's default offer.

delete_a_refersion_offer_by_id

Delete a Refersion offer by id. Soft-deletes the offer; the default offer and offers with assigned affiliates cannot be deleted. Returns an empty 204 response on success. Required: id.

refersion_offers_duplicate

Duplicate a Refersion offer by offer_id, creating a copy owned by the authenticated client. Returns: id. Required: offer_id.

list_all_refersion_clicks

List click tracking data in Refersion filtered by a required creation date range and optionally by affiliate ID. Returns: id, affiliateId, offerId, creativeId, createdAt, subId, ipAddress, userAgent, referer, landedUrl, test. Required: createdAtMin, createdAtMax.

refersion_orders_search

Search Refersion orders by order ID and determine if an affiliate can be credited for the order. Returns: isOrderFound, availableOrders, otherAffiliatesWithConversions. Required: search, affiliateId.

list_all_refersion_promotion_methods

List promotion methods in Refersion with optional filtering by affiliate, type, status, and search term. Returns: id, type, value, status, affiliate, createdAt. By default returns ACTIVE, PENDING, and DISABLED records (excludes DELETED). Max 100 per page.

create_a_refersion_promotion_method

Create a new promotion method (coupon, email, or SKU) for an affiliate in Refersion. Returns: id, type, value, status, affiliate, createdAt. Required: type, value, affiliateId. Promotion method values are unique per client across all affiliates.

refersion_promotion_methods_activate

Activate a pending promotion method in Refersion by setting its status to active. Returns an empty 204 response on success. Required: promotion_method_id, status. Only promotion methods currently in PENDING status can be activated.

delete_a_refersion_promotion_method_by_id

Delete a promotion method (conversion trigger) in Refersion by id. Returns an empty 204 response on success. Required: id. The promotion method must belong to the authenticated client's account.

list_all_refersion_prospects

List affiliate partner prospects in Refersion, or trigger a new discovery job by setting more=true. Returns each prospect's id, profileName, profileType, platform, url, status, createdAt, and updatedAt.

refersion_prospects_submit_feedback

Submit thumbs up/down feedback on an AI-recommended prospect in Refersion. Negative feedback requires a reason; feedback can be updated by resubmitting. Returns: prospectId, type, reason, createdAt, updatedAt. Required: prospect_id, type.

refersion_prospects_get_pitch

Get a prospect pitch in Refersion. Retrieves an existing pitch or generates a personalized AI pitch message for contacting a prospect. Returns: id, partnerId, pitchMessage, createdAt, updatedAt. Required: prospect_id.

list_all_refersion_exclusions

List Refersion exclusions filtered by type (ip, coupon, or sku) with optional search. Returns: id, ip, couponCode, couponDescription, sku, nameLabel, status, createdAt. Required: type.

create_a_refersion_exclusion

Create a new Refersion exclusion of the given type (ip, coupon, or sku). The body fields required depend on the type: ip when type=ip, couponCode when type=coupon, sku when type=sku. Returns: id, ip, couponCode, couponDescription, sku, nameLabel, status, createdAt. Required: type.

delete_a_refersion_exclusion_by_id

Soft-delete a Refersion exclusion by setting its status to DISABLED. Returns an empty 204 response on success. Required: id, type.

list_all_refersion_webhook_endpoints

List webhook endpoints for the authenticated Refersion user. Returns: id, url, topics, isSubscribedToAllTopics. Cursor-paginated; max 100 per page.

create_a_refersion_webhook_endpoint

update_a_refersion_webhook_endpoint_by_id

Update a Refersion webhook endpoint's delivery URL or subscribed event types. Returns: id, url. Required: id.

delete_a_refersion_webhook_endpoint_by_id

Delete a Refersion webhook endpoint by id. Returns an empty 204 response on success. Required: id.

list_all_refersion_business_categories

List all active business categories in Refersion used for classification purposes. Returns: id, sortOrder, name. Results are cached for improved performance.

list_all_refersion_countries

List all active countries supported by Refersion with their ISO 3166-1 alpha-2 codes and names. Returns: countryCode, countryName. Results are cacheable on the client side.

refersion_countries_get_states

Get a list of states, provinces, or subdivisions for a given country in Refersion. Returns: stateName, stateSubdivisionCode. Required: country_two_letter_code. The country code must be a valid ISO 3166-1 alpha-2 format (e.g., "US", "CA", "GB"). Results are sorted alphabetically by state name and cached for improved performance.

list_all_refersion_currencies

List supported currencies in Refersion with their codes, symbols, and formatting information. Returns: code, symbol, format. Results are cached for optimal performance.

list_all_refersion_product_categories

List Refersion product categories, a hierarchical map of Google product taxonomy categories for product categorization. Returns: an object whose keys are category identifiers and whose values are category data of unspecified type. Results are cached for optimal performance.

list_all_refersion_timezones

List all active timezones in Refersion with their display labels and IANA identifiers. Results are cached for improved performance. Returns: label, value.

Why Truto

Why use Truto’s MCP server for Refersion

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 750+ integrations.

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

How It Works

From zero to integrated

Go live with Refersion in under an hour. No boilerplate, no maintenance burden.

Link your customer’s Refersion account

Use Truto’s frontend SDK to connect your customer’s Refersion account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

Call our API, we call Refersion

Truto’s Proxy API is a 1-to-1 mapping of the Refersion API. You call us, we call Refersion, and pass the response back in the same cycle.

Unified response format

Every response follows a single format across all integrations. We translate Refersion’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Refersion on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

How does authentication with Refersion work through Truto?

Truto handles the Refersion API key exchange as part of the connected account flow. Your end users provide their Refersion credentials once through Truto's connect UI, and Truto manages token storage and request signing on every API call.

Can we receive real-time updates instead of polling Refersion?

Yes. You can programmatically create, update, and delete Refersion webhook endpoints per connected account, so events like new conversions or affiliate registrations are pushed to your listener rather than polled.

Which conversion lifecycle states are supported?

Refersion conversions move through PENDING, APPROVED, PAID, DENIED, and UNQUALIFIED. You can list, fetch by ID, create manual credits, credit by order ID, and bulk update conversions across these states.

Can we handle custom fields on affiliate registration?

Yes. You can retrieve an affiliate's custom fields and delete individual custom field values through the affiliate custom field endpoints, letting you sync bespoke registration data captured by the merchant.

How do we assign coupon codes or SKUs to an affiliate?

Use the promotion methods endpoints to create a coupon, email, or SKU-based promotion method for a given affiliate, activate it, or delete it. This is how attribution works when a tracking link isn't used at checkout.

Can we look up reference data like countries, currencies, and categories?

Yes. Truto exposes Refersion's reference endpoints for business categories, countries and their states, currencies, product categories, and timezones so you can validate inputs and populate dropdowns natively in your UI.

Refersion

Get Refersion integrated into your app

Our team understands what it takes to make a Refersion integration successful. A short, crisp 30 minute call with folks who understand the problem.