production

Production / go-live

Move a working sandbox shop (Phases 0–6 in shop-setup) to real-money payments. Most steps are manual for the developer; the agent prepares config, checks for contract errors, and hands a test plan — it cannot complete live card or wallet payments.

Docs: Legal aspects (Licensing Agreement)

---

When to use

• Sandbox checkout + webhooks already work
• Developer wants live payments / leave sandbox
• Token or Pay Station returns Merchant contract not signed / 0002-0004 / support_code 00020004

---

Step 1 — Prove the contract gap (agent)

Mint a production payment token (omit sandbox / set sandbox: false — same Method 1/2/3 as shop-setup, but not sandbox mode). Then hit Pay Station utils with that token:

GET https://secure.xsolla.com/paystation2/api/utils?access_token={TOKEN}

If the licensing agreement is missing, expect an error like:

{
  "errors": [
    {
      "message": "We're experiencing a technical issue…",
      "support_code": "00020004"
    }
  ]
}

(Also reported as 0002-0004 / Merchant contract not signed.)

If utils succeeds without that error, the merchant can issue production tokens — continue to config flip + deploy.

---

Step 2 — Sign the licensing agreement (human)

Ask the developer to complete Agreements in Publisher Account:

https://publisher.xsolla.com/{XSOLLA_MERCHANT_ID}/agreement

(XSOLLA_MERCHANT_ID from .env — see merchant-setup.)

Follow the PA flow (Complete application form, company/individual details). Xsolla reviews (often a few business days). After approval, status becomes Signed. Then complete the Tax interview (W-8 / W-9) under Agreements & taxes — required for live payouts/reporting.

Re-run Step 1 (production token → utils). The contract error must be gone.

---

Step 3 — Flip the shop to production mode (agent + human)