回调通知服务说明

更新说明

20240820

前提条件

接入方需要准备以下信息:

需要填入您的回调地址.（提供回调地址，平台协助填入您的回调地址）

app_secret: 用于回调通知消息辅助验签，您可以在个人中心-api管理获取您的app_secret.

如果您的服务设置了白名单访问，您需要设置106.15.203.246（回调服务ip）到白名单。

通知机制

购买订单的回调通知场景，我们将会给您推送消息，消息体为 json 格式的数据，请求方式POST，您如果收到了消息并且正确处理了逻辑，那么请返回 success 字符串，若您没有返回，我们将认为您没有收到该通知。我们将持续推送频率间隔为 1分 2分钟 5分钟 10分钟 30分钟。超过5次失败后我们将不再进行推送

验签说明

推送的消息体中一定会存在 sign 字段，可以帮助您验签，来确保消息不是伪造的。验签规则说明：

在通知返回参数列表中排除掉sign字段，剩下的参数都需要参与签名，如果某一个字段的值为 null，那么就把这个值当成 null 字符串处理，也参与签名

将剩下参数进行 url_decode（中间使用&符号链接），然后进行字典排序（按照ascii码从小到大），组成字符串，得到待签名字符串

然后在待签名字符串最后加上(&sign={app_secret})，获取方式请参考前提条件章节

最后使用MD5摘要算法生成验签的字符串（32位大写）

得到最后的字符串之后去比对通知消息中的sign字段，如果一致表示验签成功

订单消息通知

返回结果示例

需要签名的字符串为：offerId=null&orderId=753955645187293184&outTradeNo=753955643962990592&status=11&statusName=failed&tradeOfferId=null&type=0&typeName=BUYER_ORDER_STATUS&sign={你自己的appSecret}

通知字段说明

orderId: 订单id，调用购买接口后会返回该订单id

sign字段：用来进行验签，为了安全起见，建议您进行验签

status：订单状态

1 等待发货, 现在状态1也会推送，意味着这笔订单购买成功了

3 等待收货，意味着可以通知你们平台的用户去接受报价了

10 成功

11 订单取消或订单失败

statusName：订单状态说明

1 waiting_delivery

3 waiting_receive

10 success

11 failed

tradeOfferId： steam平台的offerId, 只有状态为3才会返回，拼接到steam接受报价的地址 https://steamcommunity.com/tradeoffer/{trdadeOfferId}

offerId: c5game 平台的offerId，同样只有3的状态下可以返回。可以使用查询报价状态接口 /open/offer/v1/status 获取更多信息。例如报价中的双方steam账号，以及报价中的饰品信息等

outTradeNo: 商户订单号，使用v2版本的购买接口可以传入这个参数，回调通知的时候一并返回

type: 0 表示是购买订单类型的回调消息

typeName: BUYER_ORDER_STATUS 表示是该种类型的回调消息

更新说明#

20240820#

前提条件#

通知机制#

验签说明#

订单消息通知#

返回结果示例#

通知字段说明#