# 出海道具直购开发者接入文档

海外的道具和国内类似，本文列出主要差异点。国内道具直购文档：

虚拟支付2.0道具直购 | 微信开放文档

# 接口

# 1. [前端] 支付接口：wx.requestPaymentGameItem

(1) 支付接口和国内的差异，名称修改，去掉了 Midas 字样，请求体暂无变化，价格和币种可能因发行地区差异而不固定，开发者主要关心 productId 和美元基准价格即可。
国内前端接口文档：wx.requestMidasPaymentGameItem

(2) 参数差异：

• offerId 字段无需开发者关注。可不填，如果填则要保证和签名里的内容保持一致。
• paySig 签名的 signData 前缀去掉了 Midas 字样：
  paySig = to_hex(hmac_sha256(appKey, '__requestPaymentGameItem__' + '&' + signData))

# 2. [服务端] 查询订单

pay_v2.queryOrder
（海外暂时不支持，近期会上线支持，请开发者先以道具发货协议通知为准）

# 消息订阅：道具发货协议

发货推送配置中配置推送 URL，目前暂时还没有 MP 页面可以主动填，请开发者提供给小游戏平台对接人员。内容同国内：

1. URL：开发者用来接收退款事件的接口 URL，必须以 https://开头，支持 443 端口。
   
2. TOKEN：用于支付签名处理。
   
3. 消息加密方式：选择是否加密。
   
4. EncodingAESKey：用于消息体加解密的密钥（选择加密模式时开发者需提供，明文可不提供）。
   
   相关协议内容见：道具发货消息协议 虚拟支付2.0道具直购
   

注意：订阅事件的结构中，金额会因为实际支付的币种不同而展示不同的数值。

# GoodsInfo

该结构中，会增加币种字段 CurrencyType，字符串类型，格式如 USD。

举例：

• 如果是美元 USD，实际支付 0.99 美元，则 OrigPrice 和 ActualPrice 展示 99（美分）
  
• 如果是韩币 KRW，实际支付 440 韩元，则 OrigPrice 和 ActualPrice 展示 44000（分）
  （注意：韩币没有分的概念，但是为了统一处理，都以分返回）
  

# 道具档位

目前暂时未支持 MP 页面配置道具信息。请开发者按照基准道具档位信息下单，以物品 ID 为准：
（物品 ID 暂不支持自定义）