跳转到主要内容
本指南将带你在沙盒环境中,通过 Direct API 集成方式受理一笔卡支付。
前置条件
  • 已启用 Global Acquiring 的 UQPAY 沙盒账户
  • 通过 Access Token 接口获取的 API Token
1

使用卡支付方式创建 Payment Intent

向 Create Payment Intent 接口发送请求,并传入一张测试卡号。这样可以在一次调用中完成 payment intent 的创建和支付处理。
2

检查响应

支付成功时会立即返回 intent_status: "SUCCEEDED"
需要关注的关键字段:
  • intent_status —— 本次支付的总体结果。完整状态参考见核心概念
  • payment_intent_id —— 本次支付的唯一标识,以 PI 开头
  • latest_payment_attempt.attempt_id —— 具体的支付尝试,以 PA 开头
3

通过 Retrieve 接口验证(可选)

你可以随时查询支付状态:

下一步

核心概念

了解 Payment Intent 和 Payment Attempt 的生命周期与状态流转。

Direct API 集成

搭建包含支付方式处理和 3DS 身份验证的完整收银台流程。

沙盒测试

完整的测试卡清单、电子钱包沙盒配置,以及上线前自查清单。

Webhooks

配置 webhook 通知,实时接收支付状态更新。