在完成 服务端接入准备 后,平台方可参考本文档指引进行小游戏支付功能的接入。
接入须知
订单状态通知为平台服务端主动回调机制。平台方需完成以下步骤:
商家申请阿里云账号;
申请并开通 mPaaS 相关权限;
在服务端集成对应的 mPaaS SDK;
当平台方完成订单创建及用户支付成功后,需主动调用 mPaaS 提供的接口,向游戏商推送该订单的支付状态及相关信息。
该机制确保游戏方可及时获取订单状态更新,便于进行商品发放、账务处理等后续操作。
服务端接入
公共部分
公共入参
参数 | 类型 | 是否必选 | 描述 |
appId | String | Y | 应用 ID |
workspaceId | String | Y | 工作空间 ID |
tenantId | String | Y | 租户 ID |
miniProgramId | String | Y | 小游戏 ID |
platformId | String | Y | 平台 ID(请联系内容魔方技术支持人员获取相关资源) |
公共出参
参数 | 类型 | 描述 |
requestId | String | 请求 ID |
success | boolean | 是否请求成功 |
resultCode | String | 结果码 |
resultMsg | String | 结果信息 |
结果码
结果码 | 结果信息 | 备注 |
200 | SUCCESS | 成功 |
1001 | ILLEGAL_ARGUMENTS | 参数错误 |
1002 | MINI_GAME_UNREGISTER | 小游戏未注册 |
1003 | ORDER_NOT_EXIST | 订单不存在 |
1004 | REGISTER_INFO_INCOMPLETE | 小游戏注册信息不完整 |
1005 | RPC_EXCEPTION | 调用第三方系统异常 |
1006 | RPC_RESULT_FAIL | 调用第三方服务结果失败 |
9999 | SYSTEM_EXCEPTION | 系统异常 |
支付订单状态通知
请先完成 SDK 接入,参考 服务端接入准备 进行对应技术语言的集成。
代码示例仅供参数格式参考,不建议直接用于业务逻辑中。
功能说明
流量平台方在完成订单创建并确认用户支付成功后,需主动调用本接口,向游戏 CP 通知订单状态。
入参
SaveOrderRelationInfoToMsenceRequest | |||
参数 | 类型 | 是否必选 | 描述 |
customId | String | Y | 客户订单号 |
bizOrderId | String | Y | 业务订单号 |
itemId | String | N | 订单商品 ID |
itemTitle | String | N | 订单商品名称 |
amount | Integer | Y | 订单金额 |
openUid | String | Y | 开放用户 ID |
bizOrderStatus | Integer | Y | 业务订单状态:
|
clientType | String | N | 客户端类型
|
cpExtra | String | N | 小游戏客户端透传参数,需将客户端透传的 |
出参
参数 | 类型 | 描述 |
MpaasSaveOrderRelationResponse.success | boolean | 是否成功 |
出参示例
{
"MpaasSaveOrderRelationResponse": {
"Success": true
},
"RequestId": "ac1f0086177512141324259631877",
"ResultCode": "200",
"ResultMsg": "SUCCESS",
"Success": true
}