Complete these shared integration tasks once, then link to them from payment, SDK, billing, and platform workflows. Keeping each rule in one canonical guide prevents credentials, signatures, and error handling from drifting across pages.
Authentication
Authenticate XPay API requests explains the required headers and how the merchant backend generates x-signature from the exact serialized payload.
Webhooks
Integrate XPay webhooks explains endpoint configuration, x-signature verification, payment-token delivery through token.id, and safe event processing.
Responses and errors
API responses and errors separates HTTP failures, XPay response envelopes, payment outcomes, and ambiguous network results.
Environment selection
Guide examples use {{base_url}}. Use the existing XPay Go-Live Guide for the environment URL and production-readiness steps. That guide remains outside the current local rewrite.
Network access
Network requirements lists the XPay server addresses merchants may need to allow through restricted network controls.
API reference
Use the XPay API reference for complete endpoint paths, fields, enums, and response schemas.
API responses and errorsAuthenticate XPay API requestsIntegrate XPay webhooksNetwork requirements