支付回调

项目获得支付能力,必须按以下规则设计接口,并提供给开放平台进行配置。否则,将会影响支付。

1、支付流程图

2、充值回调接口(必接)

接口描述:用于向游戏添加游戏币。(如果有充值失败的情况,有同一个订单号来进行补单请求)

接口提供方:由项目(游戏)开发人员提供,必须含正式和测试的两个接口地址。

输入参数:Json

序号

变量名

类型

长度

说明

1

orderid

String

20

订单号id(唯一),SDK服务端生成的订单号

2

accountid

String

20

电魂账号数字id,对应客户端接入支付的[uid]参数

3

areaid

String

4

大区id,对应客户端接入支付的[aredId]参数

具体请参考下面 【5、说明】

4

paytime

String

14

充值时间YYYMMDDHHmmss(位数固定,24小时制)

5

money

Int

4

对应客户端接入支付的[price]参数,

国内单位为元,海外金额单位为分

6

source

Int

4

充值来源

7

productid

String

30

商品id,对应客户端接入支付的[proId]参数

8

productname

String

30

商品名,对应客户端接入支付的[proName]参数

9

param

String

200

透传参数,对应客户端接入支付的[memo]参数,

根据下单的值原样返回,

请勿使用JSON字符串或者JSON对象转换成的字符串

10

remark

String

200

透传参数,对应客户端接入支付的[remark]参数,

游戏自定,param 不足时使用,

请勿使用JSON字符串或者JSON对象转换成的字符串

11

region

String

4

地区。1:中国大陆;0:港澳台及海外

12

currency

String

3

货币单位,国际货币标准单位,比如:CNY

13

sign

String

20

加密参数,加密规则:加密字符串MD5 accountid+areaid+money+orderid+paytime+productid+source+appkey

appkey的值跟登陆的appkey是同一个。

例如:

accountid:1350000001 areaid:1

money:6

ordered:14284108827665633280

paytime:20190101010300

productid:com.dianhun.test.a001

source:1010

appkey:12345678

加密前的值:1350000001161428410882766563328020190101010300com.dianhun.test.a001101012345678 加密后: f16bb5008c0da22aff0bb7aee75bf900

输出参数:Json

序号

变量名

类型

长度

说明

1

status

String

ok查询成功

fail查询失败,

paramerror参数错误,

repeat 订单号重复 (如游戏返回重复,我们认为成功,其他的错误继续提交) othererror 其他错误

3、角色信息查询接口(海外发行游戏网页充值需提供此接口)

接口描述:用来充值时判断此大区有无相关角色信息

接口提供方:由项目(游戏)开发人员提供,必须含正式和测试的两个接口地址。

一个账号同一大区有多角色的情况下,角色ID可以通过透传来处理

输入参数:Json

序号

变量名

类型

长度

说明

1

accountid

String

20

电魂账号数字id

2

areaid

String

4

大区ID,对应客户端接入支付的[aredId]参数,

多大区的情况,具体请参考下面 【6、说明】

3

param

String

200

透传参数,对应客户端接入支付的[memo]参数,游戏自定;

根据下单的值原样返回;

请勿使用JSON字符串或者JSON对象转换成的字符串

4

region

String

4

地区。1:中国大陆;0:港澳台及海外

输出参数:Json

序号

name

DataType

Len

Description

1

status

String

必须输出。ok:成功;fail:角色不存在

2

account

String

电魂账号id

3

areaid

String

大区id

4

name

String

角色名字

4、账号信息查询接口(海外发行游戏网页充值需提供此接口)

接口描述:用来海外网页充值时查询相关的账号ID和大区ID信息

接口提供方:由项目(游戏)开发人员提供,必须含正式和测试的两个接口地址。

输入参数:Json

序号

变量名

类型

长度

说明

1

playerid

String

20

游戏角色ID

2

areaid

String

4

大区ID,如果角色ID能够确定账号ID,

则这个参数传 0 。

对应客户端接入支付的[aredId]参数,

多大区的情况,具体请参考下面 【6、说明】

输出参数:Json

序号

name

DataType

Len

Description

1

status

String

必须输出。ok:成功;fail:角色不存在

2

account

String

电魂账号id

3

areaid

String

大区id

4

name

String

角色名字

5、说明

大区id:areaid 1-99:正式大区;如无多大区,请固定使用“1”。 100:测试大区 9999:ios提审服

PS:明确不开线下充值的游戏,整个流程的大区ID可以固定成一个(比如固定大区ID为:1),具体查询角色,充值如果要区分大区ID来匹配处理,可以使用透传参数的方式来处理。

一个账号同一大区有多角色的情况下,角色ID可以通过透传来处理

接收回调参数Demo

Last updated

Was this helpful?