支付服务

更新时间:
复制 MD 格式

在完成 服务端接入准备 后,平台方可参考本文档指引进行小游戏支付功能的接入。

接入须知

订单状态通知为平台服务端主动回调机制。平台方需完成以下步骤:

  1. 商家申请阿里云账号;

  2. 申请并开通 mPaaS 相关权限;

  3. 在服务端集成对应的 mPaaS SDK;

  4. 当平台方完成订单创建及用户支付成功后,需主动调用 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

业务订单状态:

  • 1 - 订单已创建

  • 2 - 支付成功

  • 3 - 支付失败

clientType

String

N

客户端类型

  • iOS

  • Android

cpExtra

String

N

小游戏客户端透传参数,需将客户端透传的 extraInfo 参数回传。

出参

参数

类型

描述

MpaasSaveOrderRelationResponse.success

boolean

是否成功

出参示例

{
   "MpaasSaveOrderRelationResponse": {
      "Success": true
   },
   "RequestId": "ac1f0086177512141324259631877",
   "ResultCode": "200",
   "ResultMsg": "SUCCESS",
   "Success": true
}