MerchantStandard AffiliateVIP PartnerTroubleshooting
Payout and contract issues
Solve the most common payout request, payout method, payout status, contract status, and signing problems for merchants and partners.
Last reviewed: Apr 13, 2026UI path: Documentation → Troubleshooting → Payout and contract issues
Before you start
- Confirm whether the issue is on the merchant side or the partner side.
Where to find it
Documentation → Troubleshooting → Payout and contract issues
Steps
- Confirm whether the issue is about account linking, active method selection, request eligibility, merchant review status, or contract signing.
- Check the current status badge before trying to fix the problem.
- Review the connected settings page or contract detail before taking a new action.
- Confirm whether the problem belongs to the partner side or merchant side.
Common causes
- Missing payout request action usually means the active method is not automated, the linked account is not verified, the threshold is not met, or another payout request is already pending.
- Stripe says Connect Stripe first means the Stripe account-linking step is not finished yet. Setting the method active does not create the Stripe connection.
- Method shows unavailable usually means the merchant has not enabled or connected that payout method for the current store yet.
- Merchant cannot approve a request usually means the request method is not currently runnable for the shop because gateway readiness changed.
- Pending payout means the merchant still needs to review the request.
- Declined or failed payout means the request was not completed and needs follow-up.
- Voided or expired contract means that version cannot be signed anymore.
- Viewed but unsigned contract means the partner opened the agreement but has not finished signing yet.
Example
A partner cannot request payout, checks the page again, and finds that Stripe still says Connect Stripe first. The next step is to finish the Stripe linking flow for the current store instead of retrying Set as active.
Tips and limits
- Check the status before retrying a payout or signing action.
- Merchants should review payout readiness before troubleshooting partner-side request errors.
- Partners should confirm the active store before assuming a payout or contract record is missing.
- In test mode, Stripe and PayPal screens may use mock adapters. Do not expect live gateway behavior there.
Common fixes
| Problem | First check | Next check |
|---|---|---|
| Request payout button is missing | Check the active method and whether it is automated | Check account verification, threshold, and pending-request state |
| Stripe cannot be selected yet | Finish Connect with Stripe or Connect test Stripe first | Check whether Stripe is enabled for the current store |
| Method shows unavailable | Check the active store | Ask the merchant to enable and connect that method for the store |
| Merchant cannot approve a request | Check Payout Settings for gateway readiness | Check whether the request method is still enabled for the shop |
| Payout request is still pending | Confirm the merchant has reviewed the queue | Check for related fraud review or readiness issues |
| Contract cannot be signed | Check whether the contract is still active | Review whether it is voided or expired |
| No contract appears | Confirm the current store context | Ask the merchant whether the agreement was sent |