支付下单

接口地址:https://abroad-sin-unionpay.shengqugames-corp.com/api/orderV2

请求方式:POST

请求数据类型:application/x-www-form-urlencoded;charset=UTF-8

响应数据类型:*/*

接口描述:

支付下单

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
uniqueId	请求号	query	true	string
orderUser	订单用户	query	true	string
inputOrderUser	输入订单用户	query	true	string
payUser	支付用户	query	true	string
inputPayUser	输入支付用户	query	true	string
appId	游戏id	query	true	integer(int32)
appName	游戏名称	query	true	string
orderSubject	订单标题	query	true	string
country	国家代码 国家参数说明	query	true	string
orderCurrency	订单币种	query	true	string
orderValue	订单金额	query	true	number(float)
clientIp	客户端ip	query	true	string
deployPlatform	发布平台代码 平台参数说明	query	true	integer(int32)
signature	HSP签名	query	true	string
merchant_name	HPS商户号	query	true	string
signature_method	HPS签名方式，固定MD5	query	true	string
timestamp	HPS时间	query	true	string
languageCategory	语言种类 语种参数说明	query	true	string
orderExtend	订单扩展信息	query	false	string
clientDeviceId	客户端标识	query	false	string
notifyUrl	通知地址	query	false	string
returnUrl	支付成功返回的url	query	false	string

响应状态:

状态码	说明	schema
200	OK	ServiceResponseOrderResultVo

响应参数:

参数名称	参数说明	类型	schema
resultCode	响应代码	string(string)	string(string)
resultMsg	响应信息	string(string)	string(string)
data	响应数据(object)	OrderResultVo	OrderResultVo
uniqueId	请求ID	string(string)
orderId	订单号	string(string)
cashUrl	跳转收银台的地址	string(string)

响应示例:

{
	"resultCode": "success",
	"resultMsg": "成功",
	"data": {
		"uniqueId": "MP010178040012230721152508000001",
		"orderId": "AUP079100000809T1689924308000001",
		"cashUrl": "https://abroad-sin-wpay.shengqugames-corp.com/cashier?orderId=AUP079100000809T1689924308000001&lang=en&country=Indonesia"
	}
}

订单查询

接口地址:https://abroad-sin-unionpay.shengqugames-corp.com/api/queryOrderV2

请求方式:POST

请求数据类型:application/x-www-form-urlencoded;charset=UTF-8

响应数据类型:*/*

接口描述:

订单查询

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
orderId	订单号号	query	true	string
signature	HSP签名	query	true	string
merchant_name	HPS商户号	query	true	string
signature_method	HPS签名方式，固定MD5	query	true	string
timestamp	HPS时间	query	true	string

响应状态:

状态码	说明	schema
200	OK	ServiceResponsePayOrder

响应参数:

参数名称	参数说明	类型	schema
resultCode	响应代码	string(string)	string(string)
resultMsg	响应信息	string(string)	string(string)
data	响应数据(object)	PayOrder	PayOrder
traceId	系统跟踪号	string(string)
uniqueId	请求号	string(string)
orderId	订单号	string(string)
orderUser	订单用户, 商品平台下的用户, 如: 盛大数字账号等	string(string)
inputOrderUser	输入订单用户, 订单用户的显示账号信息	string(string)
payUser	支付用户, 需要登录完成支付的用户	string(string)
inputPayUser	输入支付用户, 需要登录完成支付的用户的的显示账号信息	string(string)
merchantId	商户ID	string(string)
appId	游戏id	string(string)
appName	游戏名称	string(string)
orderSubject	订单标题	string(string)
orderExtend	订单扩展信息	string(string)
orderCurrency	订单币种	string(string)
orderValue	订单金额	number(number)
payValue	实付金额	number(number)
discount	折扣百分比	number(number)
payChannelCode	支付渠道代码	string(string)
payTypeCode	支付类型代码	string(string)
payTypeName	支付方式名称	string(string)
payResult	支付结果: 0=未支付 1=已支付	integer(int32)
payCurrency	支付币种	string(string)
payPrice	支付金额	number(number)
channelOrderId	渠道订单号	string(string)
confirmExtend	确认扩展信息	string(string)
payContent	支付信息(返回给前端的信息)	string(string)
payTime	支付时间	string(string)
mock	1=沙盒 0=正式	integer(int32)
country	国家代码	string(string)
clientIp	客户端ip	string(string)
deviceId	设备ID	string(string)

响应示例:

{
	"resultCode": "success",
	"resultMsg": "成功",
	"data": {
		"traceId": "f6184141-045e-4e98-9b42-caa6c9fa063a",
		"uniqueId": "uniqueId123456789123456789",
		"orderId": "orderId123456789123456789",
		"orderUser": "1234",
		"inputOrderUser": "1234",
		"payUser": "1234",
		"inputPayUser": "1234",
		"merchantId": "MEIYU_791000008",
		"appId": "791000008",
		"appName": "测试游戏",
		"orderSubject": "订单标题",
		"orderExtend": "test",
		"orderCurrency": "KRW",
		"orderValue": "100",
		"payValue": "100",
		"discount": "100",
		"payChannelCode": "PAYERMAX_CARDPAY",
		"payTypeCode": "CARDPAY",
		"payTypeName": "CARDPAY",
		"payResult": "1",
		"payCurrency": "KRW",
		"payPrice": "100",
		"channelOrderId": "channelOrderId123456789123456789",
		"confirmExtend": "test",
		"payContent": "test",
		"payTime": "2023-07-21 14:50:29",
		"mock": "0",
		"country": "KR",
		"clientIp": "242.217.139.140",
		"deviceId": "test-test"
	}
}

发货通知接口（接入方实现）

接口地址:接入方提供

请求方式:POST

请求数据类型:application/x-www-form-urlencoded;charset=UTF-8

响应数据类型:*/*

接口描述:

发货通知接口

请求参数:

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
uniqueId	请求号	query	true	string
orderId	订单号	query	true	string
orderUser	订单用户	query	true	string
payUser	支付用户	query	true	string
appId	游戏id	query	true	string
currency	订单币种	query	true	string
orderValue	订单金额	query	true	number(float)
payValue	实付金额	query	true	number(float)
discount	折扣百分比	query	true	number(float)
payChannelCode	支付渠道代码	query	true	string
payTypeCode	支付类型代码	query	true	string
payResult	支付结果: 0=未支付 1=已支付	query	true	integer(int32)
payCurrency	支付币种	query	true	string
payPrice	支付金额	query	true	number(float)
channelOrderId	渠道订单号	query	true	string
payTime	支付时间	query	true	string
country	国家代码	query	true	string
mock	1=沙盒 0=正式	query	true	integer(int32)
clientIp	客户端ip	query	true	string
signatureMethod	签名方式	query	true	string
signature	签名	query	true	string
orderSubject	订单标题	query	false	string
orderExtend	订单扩展信息	query	false	string

响应状态:

状态码	说明	schema
200	OK	DeliverResponse

响应参数:

参数名称	参数说明	类型	schema
resultCode	响应代码	string(string)	string(string)
resultMsg	响应信息	string(string)	string(string)
deliverVoucher	发货凭证	string(string)	string(string)

响应示例:

{
	"resultCode": "success",
	"resultMsg": "成功",
	"deliverVoucher": "deliverOrderId123456789123456789"
}

HPS签名方式

按照当前请求参数名的字母序进行升序排列（排序时区分大小写，除 signature 外，其它参数都参与签名），将所有参数-值组合以 key=value 的形式拼成一个新字符串，不同参数值之间没有任何分隔符，最后加上对应的签名密钥 secretKey 进行签名运算。如进行签名运算的串为：key1=value1key2=value2secretKey

调试工具

绑定host:

10.246.183.10	dochub.sdo.com

然后访问(https://dochub.sdo.com/doc.html#/home)

语言国家传参约定

国家参数说明

传参时传简称，必须大小写一致

国家简称	简称说明
TH	泰国
PH	菲律宾
ID	印度尼西亚
SG	新加坡
MY	马来西亚

语种参数说明

传参时传简称，必须大小写一致

语种简称	简称说明
zh-CN	中文(简体)
zh-TW	中文(繁体)
en	英语
ja	日语
ko	韩语
pt	葡萄牙语
th	泰语
id	印尼语

平台传参约定

平台参数说明

传参时必须传约定的数字

语种简称	简称说明
1	pc web
2	h5
4	原生android
8	原生iOS
16	pc sdk
32	android sdk