In-app Purchase Delivery Notify Interface Description
Description：
- After The User completes The Recharge, The ULU Platform Server Will Post Data To Game Develop Server.Game Develop Server Should Verify The Data,Then Distribute Relevant Game Props To User.
- After Receiving And Processing Successfully, The Game Develop Server Should Response SUCCESS Msg And ULU Platform Server Will Not Notify Again. Otherwise, The ULU Platform Server Will Notify Three Times In A Row Within A Period Of Time.
- If The Game Develop Server Response Something Other Than SUCCESS Msg Or The Request Times Out, The ULU Platform Server Will Retry The Request After A While.
- Signature Type:MD5 Signature With LowerCase.
Request URL：
Request Method：
Content-Type：
Request Body：
| Parameter Name |
Required |
Type |
Describe |
| orderId |
true |
String(50) |
Order Number, Unique. |
| gameId |
true |
Int(10) |
GameId. |
| extraData |
true |
String(500) |
The extraData Passed By Game Develop When Apply The Order,Will Be Returned As Is. |
| uluServerEnv |
true |
Int(1) |
Whether The ULU Platform Server Environment Code.1：Test，0：Product. |
| roleId |
true |
String(500) |
User RoleId. |
| roleName |
true |
String(500) |
User RoleName. |
| serverId |
true |
String(500) |
User ServerId. |
| serverName |
true |
String(500) |
User ServerName. |
| userId |
true |
String(50) |
User Uid. |
| payDateMs |
true |
Int(20) |
Pay Timestamp,Exp:1725271615000. |
| goodsAmount |
true |
String(20) |
Goods Fixed Price. |
| quantity |
true |
Int(5) |
Pay Quantity. |
| payAmount |
true |
String(20) |
The Actual Amount Paid By The User. |
| goodsCurrency |
true |
String(3) |
Goods Fixed Currency. |
| goodsId |
true |
String(100) |
Game Develop Provide ProductId. |
| goodsName |
true |
String(255) |
Game Develop Provide ProductName. |
| goodsNum |
true |
Int(11) |
Product Include Basic Quantity. |
| goodsExtraNum |
true |
Int(11) |
Product Include Additional Gift Quantity. |
| signature |
true |
String(32) |
Signature Information, Sorted By Parameter Name a-z (Signature Is Not Encrypted), Concatenated Parameter Values + Secret (key) To Get FinalString, Then Encrypted With md5(), For Example: md5 (amount+channelReceipt+currency+...+uid+secret) |
Request Body Demo：
{
"orderId":"1544990963624099842",
"gameId":"100000",
"extraData":"",
"uluServerEnv":1,
"roleId":"10011111",
"roleName":"안녕",
"serverId":"10011",
"serverName ":"S.10011",
"userId":"1199976566352814082",
"payDateMs":"1677148735817",
"goodsAmount":1500,
"quantity":10,
"payAmount":14900,
"goodsCurrency":"KRW",
"goodsId":"8999",
"goodsName":"Diamond",
"goodsNum":100,
"goodsExtraNum":0,
"signature":"db125296fead97fba019c54bcc26fbf0"
}
Response Parameter:
| Parameter Name |
Type |
Describe |
| code |
Int(5) |
Status Code:0 Is SUCCESS. |
| msg |
String(500) |
Msg. |
Successful Response Demo:
{
"code": 0，
"msg":"SUCCESS"
}
ERROR Response Demo:
{
"code": 500，
"msg":"roleId does not exist"
}