4.1.1请求接口


接口地址:
生产环境: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"}


yinjr 2024年8月26日 11:10 收藏文档