兑奖

事件类别:marketing_exchange

  • marketing[* Object Marketing]:营销活动信息
    • marketing_id[* String]:活动 ID
    • open_id[String]:三方身份 ID
    • open_id_type[String]:三方身份类型,例如 wechat
    • begin_time[Long]:开始时间,时间戳(毫秒),UTC, Jan 1, 1970
    • expire_time[Long]:结束时间,时间戳(毫秒),UTC, Jan 1, 1970
  • marketing_code[Object MarketingCode]:营销活动码信息
    • code_id[* String]:活动码 ID
    • code_image[String]:活动码图片内容,图片 URL
    • is_valid[Boolean]:是否有效,枚举值
      • true:是
      • false:否
    • is_used[Boolean]:是否被使用,枚举值
      • true:是
      • false:否
  • order[Object Order]:订单信息
    • order_id[* String]:订单号
    • order_create_time[* String]:下单时间,符合 ISO 8601 标准,格式 YYYY-MM-DDTHH:mm:ss.sssZ ,例如 2021-10-12T14:25:50.521+07:00
    • merchandise_list[Array Merchandise]:商品列表
      • merchandise_id[* String]:商品 ID
      • category_1[* String]:商品一级类目
      • category_2[String]:商品二级类目
      • category_3[String]:商品三级类目
      • name[String]:商品名称
      • count[Integer]:商品数量
      • unit_price[Object Amount]:商品单价
        • currency[* String]:原始金额货币类型,3 字母编码,符合 ISO 4217 标准
        • amount_local[* Double]:原始金额
        • amount_usd[Double]:金额(美金),将原始金额经过汇率换算后的美金金额,(条件必须:如果接入的是非 CN 站点则必须)
        • amount_cny[Double]:金额(人民币),将原始金额经过汇率换算后的人民币金额,(条件必须:如果接入的是 CN 站点则必须)
    • amount[* Object Amount]:订单总金额
      • currency[* String]:原始金额货币类型,3 字母编码,符合 ISO 4217 标准
      • amount_local[* Double]:原始金额
      • amount_usd[Double]:金额(美金),将原始金额经过汇率换算后的美金金额,(条件必须:如果接入的是非 CN 站点则必须)
      • amount_cny[Double]:金额(人民币),将原始金额经过汇率换算后的人民币金额,(条件必须:如果接入的是 CN 站点则必须)
    • shipping[Object Shipping]:收货信息
      • address[* Object Address]:收货地址
        • country[* String]:国家,两位国家码,符合 ISO 3166 标准
        • region[* String]:省 / 州 / 地区
        • city[* String]:城市
        • district[String]:区县
        • detail[String]:详细地址
        • zip_code[String]:邮政编码
      • phone[Object Phone]:收货手机号
        • country_code[* Integer]:国家区号,符合国际电信联盟 E.164 标准,不含 + 号和前缀 0,如 86
        • phone_number[* String]:手机号 / 电话号码,不含 + 号和前缀
      • email[String]:收货邮箱
      • consignee[* Object Name]:收货人
        • first_name[String]:名
        • middle_name[String]:中间名
        • last_name[String]:姓
        • nickname[String]:昵称
      • method[String]:收货方式,枚举值
        • logistics:快递
        • store_pickup:自提
{
    "marketing": {
        "marketing_id": "X08938",
        "open_id": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
        "open_id_type": "wechat",
        "begin_time": 1596358039000,
        "expire_time": 1616358039000
    },
    "marketing_code": {
        "code_id": "XC08938",
        "code_image": "https://tdcode.com/a.jpg",
        "is_valid": true,
        "is_used": false
    },
    "order": {
        "order_id": "NX348566DIHD",
        "order_create_time": "2021-10-12T14:25:50.521+07:00",
        "merchandise_list": [
            {
                "merchandise_id": "NFH837824432",
                "category_1": "3c",
                "category_2": "phone",
                "category_3": "android",
                "name": "huawei phone",
                "count": 1,
                "unit_price": {
                    "currency": "CNY",
                    "amount_local": 6800,
                    "amount_usd": 1000,
                    "amount_cny": 6800
                }
            }
        ],
        "amount": {
            "currency": "CNY",
            "amount_local": 6800,
            "amount_usd": 1000,
            "amount_cny": 6800
        },
        "shipping": {
            "address": {
                "country": "CN",
                "region": "浙江省",
                "city": "杭州市",
                "district": "余杭区",
                "detail": "文一西路海创园 18 幢",
                "zip_code": "310000"
            },
            "phone": {
                "country_code": 86,
                "phone_number": "18700001112"
            },
            "email": "[email protected]",
            "consignee": {
                "first_name": "三",
                "middle_name": "",
                "last_name": "张",
                "nickname": "HZhang"
            },
            "method": "logistics"
        }
    }
}