支付引擎
支付引擎接入准备
在开始调用支付引擎 API 前，需要在 Cregis App 完成账号注册、创建支付引擎项目、配置支付币种与结算地址，并获取 API Key。
在开始调用支付引擎 API 前，请按以下步骤在 Cregis App 桌面端完成项目创建、支付币种配置与 API Key 获取。
准备步骤
步骤一：下载并安装 Cregis App
- 访问 https://www.cregis.com/download 下载对应操作系统的安装包（Mac 约 148M，Windows 约 105M）
- 安装并启动 Cregis App
步骤二：注册账号并完成安全设置
- 注册 Cregis 账户（详见 账号注册及登录指引）
- 绑定 Google 身份验证器
- 登录账户
步骤三：创建支付引擎项目
- 在 App 中点击「支付引擎」模块，首次使用时点击创建
- 填写项目名称、行业，以及商户名称和品牌信息（用于收银台展示）
- 选择支付币种及对应结算地址（如暂无可跳过，后续在设置中补全）
- 输入交易密码与 Google 2FA 验证码完成创建
- 详细步骤请参考 创建支付引擎操作手册
如需 API 出款或提币，请同时准备 WaaS API 项目
支付引擎项目主要用于收款、订单和支付回调。如果您的接入场景还包括 API 出款、提币、地址或钱包相关操作，请同时创建 WaaS API 项目，并获取对应的 API Key 和项目参数。具体准备流程请参考 WaaS项目接入准备。
步骤四：配置 IP 白名单
- 进入支付引擎项目设置 > IP 白名单
- 点击「建立群组」，输入您服务端的公网 IP，保存并完成身份验证
- 未配置 IP 白名单时 API 将返回错误
步骤五：获取 API Key 与项目编号
- 进入支付引擎项目设置，复制
API Key、Base URL和项目编号（Project ID） - 这三个参数是所有支付引擎 API 调用的必要凭证，请妥善保管，切勿泄露
收银台与二维码安全建议
创建订单后，支付引擎返回的 checkout_url 是引导用户付款的入口。商户应防止收银台链接或二维码在内部流程、前端页面或运营操作中被替换。
- 由商户服务端调用 /api/v2/checkout 创建订单；前端只接收服务端返回的 checkout_url，不要在前端拼接收银台链接或二维码内容。
- 生成或展示支付二维码时，二维码内容应直接来自本次订单的 checkout_url，不要允许人工手动替换二维码图片或收款地址。
- 在收银台跳转前或订单确认页展示 order_id、order_amount、order_currency、商户名称等关键信息，方便用户核对。
- 后台如允许运营查看或重发收银台链接，应限制权限、记录操作日志，并避免展示 API Key。
- 以支付引擎回调验签结果和 /api/v2/order/info 查询结果作为订单状态更新依据，不要仅凭前端跳转、截图或人工反馈确认付款。
- 如果发现 checkout_url、二维码、金额、币种、商户名称或订单号异常，请暂停该订单并联系 [email protected]。