# 支付接口(必接)

# 1、调用前提

调用支付前必须同时满足:

  1. 已收到 INIT 成功事件。
  2. 已收到 LOGIN 成功事件。
  3. 当前没有正在等待 DH 订单或 Steam 授权的支付流程。

# 2、调用支付

int result = DHSteamSDK_Pay(sdk, R"({
  "accountId": "1696674719",
  "accountName": "131****0130",
  "areaId": "100",
  "roleId": "0",
  "itemId": "com.dh.test",
  "itemName": "60钻石",
  "itemNum": "1",
  "currency": "CNY",
  "itemPrice": "99",
  "memo": "This is gold",
  "remark": "This is remark"
})");
返回值 说明
0 支付流程已接受,或命中 SDK 的重复调用节流。
1 尚未初始化、尚未登录、已有支付进行中、JSON 无效或缺少支付参数。

# 3、支付参数

参数 类型 必传字段 说明
accountId string 是 账号 ID,填写登录成功返回的 accountId。实际下单账号仍取当前登录状态。
accountName string 是 账号名称,填写登录成功返回的 accountName。
areaId string 是 大区 ID;测试环境传 100,正式环境有大区时传角色大区 ID,无大区时传 1。
roleId string 是 角色 ID,无角色时传 0。
itemId string 是 商品唯一标识。
itemName string 是 商品名称。
itemNum string 是 商品数量,一般传 1。
currency string 是 国内传 CNY,海外传 USD。
itemPrice string 是 商品单价,必须以分为单位;CNY 为人民币分,USD 为美分,99 表示 99 分/美分。
memo string 否 透传参数,支付完成后由服务端回调原样返回。
remark string 否 备用透传参数。

支付参数 JSON 的字段值使用字符串。

# 4、支付流程

DHSteamSDK_Pay
        ↓
DH 服务端下单
        ↓
Steam 授权
        ↓
收到 PAY 事件
        ↓
服务端通知和发货

DH 服务端返回订单号只表示 DH 下单成功,不代表 Steam 授权成功。SDK 不通过 PAY 成功事件表示游戏到账,游戏必须以服务端通知、订单校验和发货结果为准。

# 5、监听支付结果

void OnDHSteamEvent(const DHSteamSDKEvent *event, void *) {
    if (event->type != DHSTEAMSDK_EVENT_PAY) {
        return;
    }

    if (event->result == 0) {
        // Steam 授权成功,订单已进入待通知队列
    } else {
        // 支付失败或取消,处理 event->data
    }
}
type code result data
3 2 0 {},表示 Steam 授权成功并进入待通知队列。
3 2 1 错误或取消 JSON;取消时 isCancel 为 true。
Last Updated: 2026/11/11 15:12:56