發放遊戲幣(鑽石-元寶-金幣.等等)(必接)
作用
通過請求原廠的API接口,對玩家角色進行儲值,充值的操作。
該接口用於SDK儲值,第三方儲值,頁面儲值,補點儲值等所有儲值管道的儲值操作。
基本參數包括:訂單號(orderId),平臺ID(userId),儲值金額(amount臺幣),鑽石數量(gameCurrency),伺服器CODE(serverCode),當前時間戳(timestamp),MD5簽名(sign)。
功能變數名稱由原廠和我們產品協商而定。sign簽名裏面的KEY值(如:8~32位長度,大小寫字母或数字,不含特殊符号),可由PM提供。完成處理流程

請求URL(需要支持post和get方式,建議優先POST)[默认application/x-www-form-urlencoded] 域名路徑(需要廠商提供) 如:http://xxx.xxx.com/user/pay 測試伺服器鏈接 如:
java
http://xxx.xxx.com/user/pay?orderId=1616548&userId=3258506&gameCurrency=100&serverCode=ld4&timeStamp=1378456412008&roleId=12045897&sign=1faec808b862af2d5a726f993477529b&proItemId=I50&amount=50請求參數
| 参数说明 | ||
|---|---|---|
| orderId | 訂單編號 唯一性,訂單號重覆訪問只發貨一次 ; 當網絡異常或是接口原因,沒有響應返回時,會有重覆提交訪問情況,請貴方保證一個訂單號,只能發幣一次 | 必填 |
| userId | 用戶ID | 必填 |
| proItemId | 按規則約定的平臺品項ID | 必填 |
| gameCurrency | 遊戲幣(如:鑽石數量) | 必填 |
| serverCode | 儲值伺服器CODE | 必填 |
| timestamp | 時間戳 【精确到秒】 | 必填 |
| roleId | 角色ID | 必填 |
| channel | 兌換的渠道:目前只有4種(ios,android,huawei,third) | 必填 |
| comefrom | 兌換的來源:如(ios,android,huawei,web,osa)等; (注意:不需要區分的話,默認不傳) | 選填 |
| sign | 簽名 ,加密規則MD5(orderId+userId+proItemId+gameCurrency+serverCode+儲值KEY+timestamp) ; 儲值KEY:雙方事先約定的保密的值,规则:(如:8~32位長度,大小寫字母或数字,不含特殊符号) | 必填 |
| expandParam | 拓展參數【透傳參數】,不參與簽名加密, 遊戲有需要才傳。 ; 注意:不支持特殊符号【json格式符号】,不支持json【会有冲突】, [可在源头Base64URL解决] | 選填 |
返回結果
| 返回結果(標準JSON格式) | ||
|---|---|---|
| 成功 | {"ret":0, "msg": "ok"} | ret:0 接收成功 |
| 失敗 | {"ret":1001, "msg": "參數錯誤"} | ret非0為錯誤,注:如有定義錯誤編碼說明,煩告知 |
返回結果 JSON 字段說明
| 參數說明 | ||
|---|---|---|
| ret | 返回狀態 | 必需返回 |
| msg | 返回資訊說明 | 必需返回 ; (注意:返回msg建議真實準確說明錯誤原因,不建議如roleid錯誤也用system busy原因) |
錯誤編碼說明
1001 參數錯誤 1002 不存在的用戶 1003 sign錯誤 1004 重覆的訂單號( 注意:假如已經確認是發遊戲幣成功的訂單號,建議直接返回成功狀態則可) 1008 帳號已禁用 65535 服務器錯誤