# pay_v2.present

本接口应在服务器端调用，详细说明参见服务端 API。

给用户赠送游戏币。本接口开通了虚拟支付的小游戏可用。通过该接口赠送游戏币给某个用户。

调用方式：

HTTPS 调用

# HTTPS 调用

POST https://api.weixin.qq.com/wxa/game/present?access_token=ACCESS_TOKEN&signature=SIGNATURE&sig_method=SIG_METHOD&pay_sig=PAY_SIGNATURE

# 请求参数 - Query

属性	类型	必填	说明
access_token	string	是	接口调用凭证
signature	string	是	用户登录态签名
sig_method	string	是	用户登录态签名的哈希方法，只支持 hmac_sha256，请传入"hmac_sha256"
pay_sig	string	是	支付请求签名（pay_sig）算法说明

# 请求参数 - Body

属性	类型	必填	说明
openid	string	是	用户唯一标识符
offer_id	string	是	支付应用 ID（OfferId）
ts	number	是	当前 UNIX 时间戳（请尽可能确保时间准确），单位：秒如：1668136271
zone_id	string	是	已发布的分区 ID（MP-分区配置-分区 ID）需要和 env 对应
env	number	是	环境配置 0：现网环境（也叫正式环境） 1：沙箱环境
user_ip	string	是	用户外网 ip
amount	number	是	赠送游戏币的个数，不能为 0（原 present_counts）
bill_no	string	是	赠送订单号，业务需要保证全局唯一，相同的订单号多次请求不会重复扣除；长度不超过 63，只能是数字、英文大小写字母及-的组合；不能以下划线（）开头（2.0 新增约束）

# 返回值

# Object

返回的 JSON 数据包

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
bill_no	string	赠送订单号
balance	number	赠送后的余额

errcode 的合法值

值	说明	最低版本
0	请求成功
-1	系统繁忙，此时请开发者稍候再试
90010	signature 签名错误
90011	pay_sig 签名错误
90012	订单已存在
90016	sessionkey fail，用户 sessionkey 过期，需要重走登录流程
90018	参数错误，具体参数见 errmsg 描述

# cURL 请求

curl -d '{
  "offer_id": "12345678",
  "openid": "oUrsfxxxxxxxxxx",
  "ts": 1668512716,
  "zone_id": "1",
  "env": 0,
  "bill_no": "test_present_1668512716",
  "amount": 1
}' \
  -H "Content-Type: application/json" \
  -X POST \
  'https://api.weixin.qq.com/wxa/game/present?access_token=62_so84Zyl5MuPCjXGiR3eb1ysa1lr6aRpcprEnNpZ9ds8676ivjqRn5Zroi2Rxxx9-Yvh2zIl9oEt1hIzK0x2OrMCT5zk8nB_TG98obD_ad3tFPftfFmB7xXtcZv4PVPcbFATZT&signature=75ded945d927a1d31d4de40a9ca91e7a59b6022e5db0eb91622a1d79ead888d2&pay_sig=cf5857f56dbcd4900875197712f83ae6d89c66c27347459dd446de35a9e4c955&sig_method=hmac_sha256'

# 成功返回

{
  "errcode": 0,
  "errmsg": "ok",
  "bill_no": "test_present_1668512716",
  "balance": 11
}

# 错误返回

{
  "errcode": 90018,
  "errmsg": "[openid] openid is invalid"
}