GHOME SDK 文档 - 支付中心

# 支付下单

接口地址: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"
	}
}
1
2
3
4
5
6
7
8
9

# 订单查询

接口地址: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"
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

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

接口地址:接入方提供

请求方式: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"
}
1
2
3
4
5

# HPS签名方式

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

# 调试工具

绑定host:

10.246.183.10	dochub.sdo.com
1

然后访问(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
Last Updated: 2023/12/27 03:07:28

← for 手游国外支付订单查询功能 →