蓝鼎数字权益平台接口
    蓝鼎数字权益平台接口
    • 接口说明
    • 回调说明
    • 卡密解密
    • 错误码说明
    • 银行立减券
      • 发送立减券
        POST
      • 查询卡券码是否已兑换
        POST
    • 权益
      • 提交订单
        POST
      • 订单查询
        POST
      • 手机充值
        POST
      • 余额查询
        POST
      • 提交订单(卡密兑换)
        POST
      • 账单明细查询接口
        POST
    • 获取小程序URL LINK
      POST

    回调说明

    回调#
    回调的形式是HTTP POST请求,请求体中BODY为JSON格式字符串加密后的字符串,加密方式为AES-256-ECB,详见下文【解密】
    响应#
    响应状态码为200且 内容为 success 表示响应成功, 其它为失败
    重试#
    若未收到成功响应则触发重试机制。
    一般情况下,15 小时以内完成 8 次通知(通知时间为:0m、4m、10m、30m、1h、2h、6h、15h)
    解密后JSON格式数据结构#
    1.
    权益订单成功回调
    参数名必选类型说明
    event_type是string回调类型,值为 orderFinished
    order_id是string[18,18]平台订单号
    biz_order_id是string客户订单号
    sku_id是intSKU ID
    status是int订单状态,2充值成功 3充值失败
    count是int商品数量
    amount是int订单支付总额
    last_time是datetime到账时间/确定失败时间
    created_at是datetime下单时间
    cards否array卡密数据 详细内容后请参考“卡密解密”,仅卡密订单存在此字段
    2.
    银行立减券用户领券成功回调
    参数名必选类型说明
    event_type是string回调类型,值为 voucherReceived
    order_id否string[18,18]平台订单号
    biz_order_id否string客户订单号
    code否string[8,8]卡密
    act_id否string[9,32]加密活动ID
    finished_time是YYYY-MM-DD HH:ii:ss领取时间
    coupon_id是string[1,20]券ID 参考发放代金券批次API
    注:(order_id, biz_order_id)、(act_id, code)这两组参数,有一组必填
    3.
    银行立减券核销回调(通过接口【发送立减券】下单的回调)
    参数名必选类型说明
    event_type是string回调类型,值为 voucherChecked
    order_id否string[18,18]平台订单号
    biz_order_id否string客户订单号
    checked_time是rfc3339核销时间,如:2023-12-27T07:46:19.000000Z
    coupon_id是string[1,64]发放给用户的优惠券ID
    4.
    银行立减券核销回调(微信/支付宝官方回调)
    数据格式参考:
    微信官方核销事件回调通知API(仅核销券通知参数部分)
    支付宝红包核销通知API(仅biz_content消息属性部分)
    解密#
    AES-256-ECB,密钥为 appsecret(向平台索取)
    上一页
    接口说明
    下一页
    卡密解密
    Built with