跳转到主要内容
UQPAY 沙盒环境让你能在不产生真实交易的前提下测试集成。以下所有测试凭据仅在沙盒环境中可用。

测试卡号

使用下列测试卡调用 Create Payment Intent API。card_name 可填任意值(例如 “John Doe”)。
network 字段使用小写:mastercardvisaunionpay。卡号中不要带空格。若收到 product_not_found 错误,请联系 UQPAY 技术支持。

卡支付请求示例

电子钱包沙盒测试

AlipayCN 与 AlipayHK

准备工作

  1. 此处安装 Alipay 测试钱包 App AWallet
  2. 此处注册一个 Alipay 沙盒账户。

二维码流程

发送带 flow: "qrcode"is_present: false 的支付请求:
响应会返回 intent_status: "REQUIRES_CUSTOMER_ACTION",并在 next_action.display_qr_code 中包含二维码 URL。在浏览器中打开 qr_code_url,用 AWallet App 扫码完成支付。

付款码流程(线下)

线下付款码场景将 is_present 设为 true,并带上客户的 payment_code
  1. 打开 AWallet App,点击 “Payment Code”
  2. 点击条形码查看付款码数字。
  3. 在 API 请求中使用该付款码:
付款码交易会立即完成 —— 响应会返回 intent_status: "SUCCEEDED"

Webhook 测试

测试 webhook 送达的步骤:
  1. 在 UQPAY 控制台配置你的 webhook URL。
  2. 发起一笔沙盒交易(卡支付或电子钱包)。
  3. 确认你的服务器收到了 webhook 通知。
  4. 返回 HTTP 200 以确认接收。
Webhook payload schema 参见 Webhooks 标签页。
开发阶段可使用 webhook.site 等工具查看 webhook payload。

生产上线检查清单

切换到生产环境前:
  • 账户已审批:在 app.uqpay.com 注册并完成 KYC/KYB 验证
  • 生产 API 密钥:在控制台创建生产环境的 apiKeyclientId
  • 生产基础 URL:将所有 API 调用切换到 https://api.uqpay.com
  • Webhook IP 白名单:将 UQPAY 的 webhook 源 IP(18.143.59.6454.179.248.20513.250.234.8818.136.58.21356.10.39.6)加入白名单 —— 详情参见 Webhooks Overview
  • Webhook 订阅:订阅集成所需的 webhook 事件