多多进宝：多多礼金创建接口（包含自动领券设置）

摘要

券批次领取开始/结束时间(acquire_start_time,acquire_end_time)：必填，券批次领取时间范围，礼金创建后，消费者可以在该时间范围内领取礼金券，礼金券有效期类型(validity_time_type)： 必填，有效期类型：1-领取后几天内有效(用户在领取礼金券起，往后几天内有效)；2-固定时间内有效(礼金券在指定时间范围内有效)。

本接口用于渠道或者工具商创建礼金。

1、API名称：

多多客接口：pdd.ddk.cashgift.create

工具商接口：pdd.ddk.oauth.cashgift.create

2、API开放平台地址：

https://open.pinduoduo.com/application/document/api?id=pdd.ddk.cashgift.create

https://open.pinduoduo.com/application/document/api?id=pdd.ddk.oauth.cashgift.create

3、请求入参：

礼金名称(name)：选填，作为内部标示，不向用户展示

礼金券数量(quantity)：必填

礼金券面额(coupon_amount)：必填  (礼金券数量*礼金券面额=礼金总金额)

商品推广短连接(source_url)：必填，商品短链接

券批次领取开始/结束时间(acquire_start_time,acquire_end_time)：必填，券批次领取时间范围，礼金创建后，消费者可以在该时间范围内领取礼金券

礼金券有效期类型(validity_time_type)： 必填，有效期类型：1-领取后几天内有效(用户在领取礼金券起，往后几天内有效)；2-固定时间内有效(礼金券在指定时间范围内有效)。

活动持续时间(duration)：validity_time_type为 1 时必填。

券批次使用开始/结束时间(validity_start_time,validity_end_time)：validity_time_type为 2 时必填

单用户可领券数量上限(user_limit)：非必填，针对同一个礼金券，每个用户可领取数量上限，默认为1。

活动单链接可推广礼金数(link_acquire_limit): 非必填，一个活动链接可被领取礼金券数量上限，默认无限制。

领券是否过风控(fetch_risk_check): 非必填，默认开启风控，可以过滤黑用户。

是否自动领券(auto_take): 非必填，默认false不自动领券，设置自动领取，用户点击链接可以实现自动领券。

4、请求返回：

礼金ID（cash_gift_id）：礼金ID是标识礼金活动的唯一字段，请保存用于相关查询。