Browse documentation

Products and rules

Configure product rules and Stripe payment mode, understand the visible states and keep existing referrals on their original terms.

Updated August 3, 2026

Open Products and select a product to edit its public settings, affiliate rules and payment path. AffiHQ keeps each product’s attribution, currency and financial history separate, even when products use the same Stripe account.

Product settings

A product has its own public name, domain and historical destination URL. Set its payout currency, attribution window, commission reward, commission duration, customer discount and validation delay before inviting affiliates.

The default attribution window is 90 days. A reference must still be valid when the prospect is created. After the prospect is attributed, later clicks and codes cannot replace the original affiliate. Attribution is unique for a product and merchant customer pair, so the same person can be referred to another product without changing the first product’s history.

Commission and validation rules

Choose either:

  • a percentage of the amount actually collected, excluding tax and discounts;
  • a fixed amount in the payment currency for each eligible payment.

For subscriptions, choose whether the reward applies to the first payment only, a fixed period or every eligible payment while the customer remains eligible. Customer discounts are configured separately.

A new commission waits for the product’s validation delay—30 days by default—before it becomes payable. It becomes payable automatically when the delay ends; no manual approval is required. The delay gives refunds and disputes time to arrive.

When an attribution is created, AffiHQ keeps the rules that applied to it. A later product change affects new attributions, not customers referred under the previous terms.

Choose the payment mode

Each product uses one of these modes:

ModeUse it forCredentials and payment handling
Stripe automaticA Stripe-hosted Payment Link is the complete Checkout pathConnect a Stripe Standard account and select one supported Payment Link. Product API/SDK credentials are not required; AffiHQ handles Stripe delivery automatically.
API/SDK advancedCustom Checkout, non-Stripe billing, custom attribution timing, discounts/trials/onboarding or non-financial eventsKeep the product API and fingerprint credentials on your server. Your server creates attribution and sends verified billing facts.

Configure Stripe automatic in the product editor

  1. Open Products and edit the product.
  2. In Stripe payments, select Stripe automatic.
  3. Select Connect Stripe and authorize the Standard account that owns the link.
  4. Confirm whether the connected account is in Test mode or Live mode.
  5. Choose one active, compatible Payment Link. If the list has more results, select Load more; then select Use this Payment Link.
  6. Save the product and confirm that it shows the account and Ready.

The chooser may show links that are Inactive or Not supported, but they remain unavailable. A compatible link must be an active https://buy.stripe.com/... URL with exactly one fixed-price line, quantity 1, a positive amount, one currency and either one-time or subscription billing. Subscription links must be monthly or annual. The product’s currency must match the selected link.

One product has one selected Payment Link. AffiHQ keeps its amount, currency and cadence as the product’s validation snapshot; incoming native Checkout and invoice data must match it.

Visible product states include:

  • Loading while Stripe state is being read;
  • No account connected, before a Stripe account is authorized;
  • Connected when the account is available;
  • Ready when the product has a usable selected Payment Link;
  • No supported links when the connected account has no selectable Payment Link;
  • Revoked or Error when access or automatic processing needs attention.

Switch a product to API/SDK advanced

When you choose API/SDK advanced, AffiHQ asks you to confirm the switch. After confirmation, the selected native Payment Link stops driving that product’s /r/ redirects and automatic payment flow. The connected Stripe account remains connected; this change is product-specific and is not an account-wide disconnect.

The product’s historical destination and affihq_ref resume. Your server must then capture the reference, create the attribution and report verified payment, refund and dispute facts through the advanced integration. If you later return to Stripe automatic, reconnect or confirm the account and select a compatible Payment Link again.

To revoke AffiHQ’s access to Stripe, remove the connected application from Stripe. Automatic processing stops until the product is reconfigured. See Workspace permissions for who can change these settings.