Troubleshooting

Refusal codes and common operator problems.

Code or symptomMeaning and fix
Storefront shows "Betting closed"Tenant not ready. Add an active licence, an active payment connection, and an active jurisdiction policy
OPERATOR_NOT_LICENSEDNo ACTIVE, unexpired OperatorLicence with regions
PAYMENTS_NOT_CONFIGUREDNo active payment ProviderConnection
RESPONSIBLE_GAMING_NOT_CONFIGUREDNo active JurisdictionPolicyVersion
GEO_BLOCKEDRequest region not in permittedRegions; check the geo header
ORIGIN_DENIEDRequest origin differs from SANDBOX_PUBLIC_ORIGIN
DUAL_CONTROL_REQUIREDA different operator with canApproveSensitiveActions must approve
Operator can sign in but cannot actEnrol and verify two-factor at /dashboard/platform/security
KYC_REQUIRED, GEO_REQUIRED, STALE_PRICE, LIMIT_EXCEEDEDAcceptance gates; see Wagers
SELECTION_RESULT_REQUIREDUse gradeMarketSelection, not gradeMarket
INSUFFICIENT_FUNDS, WITHDRAWAL_REVIEW_REQUIREDBalance too low, or an active withdraw restriction
BANK_REFERENCE_REQUIREDEnter the bank reference to mark a withdrawal paid
PAYMENT_STILL_UNKNOWNProvider has not resolved the payment; retry reconciliation later
Settlements never startRun npm run worker and check /api/ready
Anchoring skippedSet AUDIT_ANCHOR_DIR and AUDIT_ANCHOR_SECRET
Approval request expiredRequests last 24 hours; request again