快速开始
接入 Onerway Payments 时，先激活沙盒账户、获取 API 凭证并配置沙盒 IP 白名单。在沙盒环境完成集成开发与测试后，再配置生产环境并上线。
接入步骤
激活沙盒账户
向 Onerway 技术支持提供注册邮箱和测试域名，收到邮件邀请后点击链接，商户账户即在沙盒中激活。
通过 Web SDK 或 API 直连在自有页面展示 Apple Pay 按钮的商户，需为对应的测试与生产域名完成 Apple 域名验证（收银台为 Onerway 托管页面，无需此步骤），见 Apple Pay 接入准备。
通过 API 直连接入 Google Pay 时，需完成上线前网站报备；收银台和 Web SDK 无需报备。
获取凭证
登录商户后台，获取以下 API 凭证，供服务端调用 API 时使用。
请将
secret 保存在服务端，切勿暴露在客户端代码、移动端安装包或版本控制系统中。配置 IP 白名单
首次从服务端调用沙盒 API 前，必须将服务端使用的所有公网出口 IP 地址加入沙盒 IP 白名单。登录沙盒商户后台，在 开发者 → IP 白名单中添加这些地址。此处填写服务端的出口 IP，不要填写客户设备或浏览器访问网站时使用的 IP。
沙盒和生产环境的 IP 白名单需要分别配置。上线前，必须在生产商户后台添加生产服务端使用的所有公网出口 IP 地址。即使两个环境的出口 IP 相同，也需分别添加。
启用 IP 白名单后，请求来源 IP 不在对应环境的白名单中时，请求可能被拒绝。
构建与测试
配置沙盒 IP 白名单后，使用沙盒凭证开发集成，验证所有支付流程、异常处理和 Webhook 回调。切换至生产环境 API 地址和凭证前，必须将生产服务端的公网出口 IP 加入生产 IP 白名单。同时完成所用支付方式的接入要求，例如 Apple Pay 域名验证或 Google Pay 网站报备。