卡券接口
卡券购买接口
开发者可通过该接口提交卡券的购买订单,响应参数data返回的goods_number、goods_password、goods_link为AES加密数据,解密请参考卡密解密规范。
系统级参数
API参数共由系统级参数和应用级参数两部分构成,系统级参数指所有由橙券提供的API所必须的参数,应用级参数是指对应API所需的参数。
参数名 |
类型 |
描述 |
timestamp |
long |
时间戳,以毫秒为单位。校验开发者与橙券的时间差,橙券允许开发者请求最大时间误差为3分钟 (3*60*1000) |
app_id |
string |
商户账号,由橙券提供,如:13105356515 |
sign |
string |
签名 跳转到签名规范 |
请求地址
https://api.chengquan.cn/coupon/order/pay
应用级参数
参数名 |
类型 |
是否必须 |
描述 |
user_order_no |
string(32) |
是 |
商户提交的订单号,最长32位(商户保证其唯一性) |
goods_no |
string |
是 |
产品编号(具体由橙券商务提供) |
count |
int |
是 |
购买数量(只能为正整数,最大等于50) |
mobile |
string |
否 |
接受卡密短信手机号 |
响应参数
data说明
参数名 |
类型 |
描述 |
order_no |
string |
橙券平台订单号 |
user_order_no |
string |
商户提交订单号 |
state |
string |
订单状态卡券产品订单状态码说明 |
price |
decimal |
单价(单位:元),保留小数点后四位 |
goods_no |
string |
产品编号 |
goods_name |
string |
产品名称 |
goods_type |
string |
产品类型(LINK 链接,PICTURE 图片,NUMBER_PASSWORD 卡号和密码,PASSWORD 密码) |
goods_number |
string |
卡号(产品类型为NUMBER_PASSWORD时有值),AES加密 |
goods_password |
string |
卡密(产品类型为NUMBER_PASSWORD或PASSWORD时有值),AES加密 |
goods_link |
string |
链接(产品类型为LINK或PICTURE时有值),AES加密 |
create_time |
long |
订单创建时间(时间戳,单位:毫秒) |
complete_time |
long |
订单完成时间(时间戳,单位:毫秒) |
effective_time |
long |
有效期(时间戳,单位:毫秒) |
成功返回值示例
{
"code": 7000,
"message": "请求通过",
"data": [
{
"user_order_no": "uxCXdkxDIR18kwmpBUZNQ6KC8Ywpi9",
"order_no": "SELL1564466171215298064",
"state": "SUCCESS",
"price": 1,
"goods_no": "20010001",
"goods_name": "一寸阳光5元官方优惠券",
"goods_type": "PICTURE",
"goods_link": "1dM/tmE36C00Hzbj1TF2fFuAARbWXmZkwx3/alvFBjnavgSFYxyn3FQta1A4OM8s8hNrLJiZdGUcDW+xiooSwGdo8R4A+AFpbOBSAgha+IBI4+NPlEH1bt8OzHgVwSqsaByawwXw5380UmdiHQAkt4/lrAeA4pqwZfSLtNcBFkrxpw5TxIEk3ImgovTorw59hcPtnM/PHiAotbGz5irwYnxQctQ5vC9PxgWtCOa1Omk=",
"complete_time": 1564466171215,
"create_time": 1564466171215,
"effective_time": 1564588800000
},
{
"user_order_no": "uxCXdkxDIR18kwmpBUZNQ6KC8Ywpi9",
"order_no": "SELL1564466173240837871",
"state": "SUCCESS",
"price": 1,
"goods_no": "20010001",
"goods_name": "一寸阳光5元官方优惠券",
"goods_type": "PICTURE",
"goods_link": "1dM/tmE36C00Hzbj1TF2fFuAARbWXmZkwx3/alvFBjnavgSFYxyn3FQta1A4OM8s8hNrLJiZdGUcDW+xiooSwEK+pb/ZkWgEEgyFraQjhnAeDYdi1d/VDH1s9Q2KG13n9v6gQh3BaSxAyz0O8r/PBjH0a4zkO+tY/ymOqoxFpt5smEjDjnasL/8+hYO+XJFTG0UXct63MpfgiM7GiNJUSYoTwVKAV8N+E//GmyFzqcE=",
"complete_time": 1564466173240,
"create_time": 1564466173240,
"effective_time": 1564588800000
}
]
}
- 回到顶部
- 155-8952-5929
- 在线咨询
- 微信二维码