接口地址:
生产环境:https://vsp.allinpay.com/apiweb/zhimacredit/miniorder
测试环境:https://syb-test.allinpay.com/apiweb/zhimacredit/miniorder
接口说明:
业务订单相关的总接口,不同接口以接口编号区分,各接口业务参数详见对应接口描述
错误码处理逻辑:
当retcode不等于SUCCESS,则会代表该请求失败或者异常,无需读取bizcode
当retcode=SUCCESS时,bizcode=10000,代表成功,当bizcode不等于10000则读取 bizsubcode进行判断
请求参数:
参数 | 参数名称 | 取值 | 可空 | 最大长度 | 备注 |
---|---|---|---|---|---|
orgid | 机构编号 | 平台分配的机构号 | 可 | 15 | 用于机构代商户发起交易。例如集团父商户号、代理商编号 |
cusid | 商户号 | 平台分配的商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
version | 版本号 | 接口版本号 | 可 | 2 | 默认填11 |
randomstr | 随机字符串 | 商户自行生成的随机字符串 | 否 | 32 | 用于签名 |
trancode | 接口编号 |
alipay.open.mini.order.create –创建订单 alipay.open.mini.order.query-订单查询 alipay.open.mini.order.close-关闭订单 alipay.open.mini.order.changed-业务状态变更通知 alipay.open.mini.order.installment.create-创建分期单 zhima.credit.payafteruse.creditagreement.query-用户授权协议查询 |
否 | 32 | |
serviceid | 服务id | 支付宝分配的服务id | 否 | 32 | |
bizdata | 业务参数 |
业务参数的json转base64字符串 具体参数详见各接口的参数描述 |
否 | ||
id | 本次通知流水 |
|
是 | 通知相关接口必填 | |
signtype | 签名方式 |
枚举值: RSA RSA2 SM2 |
否 | 8 | |
sign | 签名 | 详见安全规范 | 否 | -- |
响应参数:
字段ID | 字段名称 | 取值 | 可空 | 最大长度 | 备注 |
---|---|---|---|---|---|
retcode | 返回码 |
SUCCESS-请求成功 FAIL-请求失败 SYSTEMERR-系统处理异常,请发起查询 PARAMERR-参数错误 SIGNAUTHERR-签名失败 |
否 | 16 | 此字段是通信标识,非交易结果 |
retmsg | 返回码说明 | 可 | 100 | ||
以下信息只有当retcode为SUCCESS时有返回 | |||||
cusid | 商户号 | 平台分配的商户号 | 否 | 15 | |
appid | 应用ID | 平台分配的APPID | 否 | 8 | |
bizcode | 支付宝网关返回码 | 可 | 32 | 详见附录 | |
bizmsg | 支付宝网关返回错误信息 | 可 | 100 | 详见附录 | |
bizsubcode | 支付宝业务错误码 | 可 | 32 | 详见附录 | |
bizsubmsg | 支付宝业务错误原因 | 可 | 100 | 详见附录 | |
bizdata | 业务参数返回 |
业务参数的json字符串 具体参数详见各接口的参数描述 |
可 | ||
sign | 签名 | 否 | 32 | 详见安全规范 |
请求报文样例:
appid=00007751&bizdata=eyJwYXRoIjoicGFnZXMvcGF5UmVzdWx0L3BheVJlc3VsdCIsImNyZWRpdF9pbmZvIjp7Im91dF9hZ3JlZW1lbnRfbm8iOiJhZ3JlZTIwODgxMDIzMTgxMjU4ODMifSwib3V0X29yZGVyX2lkIjoib2lkMTcyMTE4MTQ1NjUxNiIsIm1lcmNoYW50X2Jpel90eXBlIjoiSU5ESVJFQ1RfQ0hBUkdFX1dJVEhIT0xEIiwic291cmNlX2lkIjoiTWpBNE9ERXdNak14T0RFeU5UZzRNM3d5TURJeE1EQXhNVEEwTmpFMU5USXhmREUzTWpFeE9ERXpOems0TWpSOFptRnNjMlY4VkU5TFJVNWZTVk5mVGxWTVRBPT0iLCJ0aXRsZSI6IuWFheeUteWunSIsIm9yZGVyX2RldGFpbCI6eyJwcmljZV9pbmZvIjp7Im9yZGVyX3ByaWNlIjoiMTAifSwiaXRlbV9pbmZvcyI6W3siZ29vZHNfbmFtZSI6IuWVhuWTgeWQjeensDEiLCJzYWxlX3JlYWxfcHJpY2UiOiIxMCIsIm91dF9pdGVtX2lkIjoib3V0MDAxIiwiaXRlbV9jbnQiOiIxIiwiZ29vZHNfaWQiOiJnb29kMDAxIiwiaXRlbV9pbnN0YWxsbWVudF9pbmZvIjp7InBlcmlvZF9udW0iOjEsInBlcmlvZF9tYXhfcHJpY2UiOiIxMCJ9LCJzYWxlX3ByaWNlIjoiMTAifV19LCJidXllcl9pZCI6IjIwODgxMDIzMTgxMjU4ODMiLCJleHRfaW5mbyI6eyJkb29yX3RpbWUiOiIyMDI0LTA3LTE3IDA5OjU3OjM2IiwiZGVkdWN0X3NpZ25fc2NlbmUiOiJJTkRVU1RSWXxDSEFOR0VfRElBTkRPTkdDSEVfWUFESSJ9fQ%3D%3D&cusid=990603054996018&randomstr=65126746&serviceid=2024042400001003000011461200&sign=136343B769B69E0D099867FB0525FA0D&trancode=alipay.open.mini.order.create&version=11
返回报文样例:
{"appid":"00007751","bizcode":"10000","bizdata":"{"order_id":"2024071701502300000008830039515021","out_order_id":"oid1721181456516"}","bizmsg":"Success","cusid":"990603054996018","randomstr":"217154448897","retcode":"SUCCESS","sign":"E7EFE3B33E686BBDEEFCF28E8CB859B2","trancode":"alipay.open.mini.order.create"}