发送立减券 - 蓝鼎数字权益平台接口

user_id特别说明：支付宝获取用户uid可参考：https://opendocs.alipay.com/open/284/web?ref=api

请求参数中不提供user_id，则为链接发券模式

链接发券模式时，若需用户领券成功通知，将固定通知URL提供给平台，通知解密方式及数据结构参考：【回调说明】

请求参数

Body 参数application/json

appid

string

app id

必需

平台提供

version

string

接口版本号

必需

固定为1.0

reqTime

integer

时间戳

必需

单位：毫秒 13位整数

sign

string

签名值

必需

生成算法请见 “接口说明”

act_id

string

活动ID

必需

平台提供

user_id

string

发券用户标识

可选

此字段为空时返回领券链接，非空时直接发券；可填微信openid、支付宝uid(2088打头数字)、支付宝账号、手机号(美团、支付宝、京东场景、直充账号)

biz_order_id

string

API调用者订单号

必需

API调用者唯一订单号，最长32字符，接口基于appid+biz_order_id幂等

wechat_appid

string

微信appid

可选

微信发券时，若user_id（即openid）非空，则此字段必填，表示openid对应的微信APPID

biz_mobile

string

API调用者用户标识

可选

调用者用户标识，便于行方/API调用者客诉时定位用户

num

integer

数量

可选

当act_id对应为卡密时有效，默认为1

示例

{
    "appid": "string",
    "version": "string",
    "reqTime": 0,
    "sign": "string",
    "act_id": "string",
    "user_id": "string",
    "biz_order_id": "string",
    "wechat_appid": "string",
    "biz_mobile": "string",
    "num": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

响应码

必需

0为正常非0为异常，异常时参考错误码说明

msg

string

提示信息

必需

data

object

数据

必需

order_id

string

平台订单号

必需

字符长度18位

biz_order_id

string

商家订单号

必需

商家订单号

is_query

string

是否重复下单

必需

1是，0不是

link

string

领取链接

可选

链接发券时存在此字段。调用方需引导用户打开此链接领券

mini_path

string

跳小程序领取路径

可选

微信链接发券时存在此字段。如: /pages/index/index?url=https://www.ldvip.cn/

is_waiting

integer

是否未注册待发券

可选

发放美团券时存在此字段。1待发券 0发券成功

coupon_id

string

发券平台券ID

可选

直接发券时存在此字段

cards

string

卡密列表

可选

卡密加密数据，当act_id对应卡密时存在此字段。解密请参考"卡密解密"

示例

{
    "code": 0,
    "msg": "string",
    "data": {
        "order_id": "string",
        "biz_order_id": "string",
        "is_query": "string",
        "link": "string",
        "mini_path": "string",
        "is_waiting": 0,
        "coupon_id": "string",
        "cards": "string"
    }
}