# 支付接口(必接)
# 1、调用前提
调用支付前必须同时满足:
- 已收到 INIT 成功事件。
- 已收到 LOGIN 成功事件。
- 当前没有正在等待 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。 |