Appearance
创建支付订单
IMPORTANT
创建订单需要先创建任务并审核通过,订单要求用户姓名、手机号二要素匹配。如用户未完成签约和报名任务,将无法进行发放。
请注意
IMPORTANT
创建订单接口返回并不代表发起或支付成功,如不清晰发起支付的状态和结果需要重试时,请 不要 更换业务流水号,一定要使用 原业务流水号 重试,否则可能 造成重复支付 等资金风险。同一个流水号只能上报一次,重复上报接口将提示外部订单号重复错误。
明确订单状态,可通过订单查询接口查询。
发起生产前,请您确认是否按照 异常订单处理方案 处理了异常订单的各种错误处理,否则可能会导致资金损失!
接口地址
order/create
请求参数
| 参数名称 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| outerTradeNo | true | String | 外部订单号(您系统的订单号,保持唯一) |
| realName | true | String | 真实姓名 |
| 不再需要传入,自动取签约手机号 | |||
| idCard | true | String | 证件号 |
| idCardType | false | Integer | 证件类型,目前固定传入 1,身份证 |
| payAccount | true | String | 支付账号(支持手机号/邮箱/银行卡) |
| reason | true | String | 建议填写 “服务费”,不能包含的敏感词:工资、薪酬、提现、薪、补贴、分红、奖金、返现、劳务费、分润、备用金、咨询等,否则可能触发风控拦截 |
| bizAccount | true | String | 业务账号(您系统的用户唯一索引) |
| balance | true | Double | 支付金额 (单位元,最多两位小数,0.1-50000) |
| taskId | true | Long | 任务ID (需任务通过审核) |
| bizAccount | true | String | 业务账号(您系统的用户唯一索引) |
| extension | false | String | 透传字段,原样返回 |
| notifyUrl | false | String | 回调通知地址,优先使用,应用兜底 |
明确创建订单成功的状态
如理账狮明确收到了您的创建订单请求,我们将固定返回状态码 200,且 data 将返回订单模型,详情请查看 订单模型
明确创建订单失败的状态
此接口提供创建订单的服务,如此接口返回以下状态码,表示理账狮收到了创建订单的请求,但目前无法创建订单,您可以在您的系统内为客户走退款流程:
500001 INVALID_APP_KEY
无效的AppKey,请确认使用了正确的 appKey 发起请求
500002 APP_DISABLED
应用已被禁用,请确认后台是否禁用了应用(您可以在异常时主动禁用应用,处理完毕后再启用应用)
500003 SIGNATURE_INVALID
签名无效,请确认是否按照签名规则对请求进行了签名。
500004 DECRYPT_DATA_FAIL
解密数据失败,请确认应用的加解密方式以及密钥是否一致,否则可能导致解密数据失败。
500005 API_NOT_SUPPORT
接口不支持,请求了不被支持的API接口,请按对接接口文档的URL进行请求。
500008 REPEAT_REQUEST
重复请求,请求的 nonce 参数已经使用过了,请重新生成新的随机串。
500009 TIMESTAMP_INVALID
时间戳无效,请求的 timestamp 参数无效,超过了前后 1 分钟,请确认获取的时间是否是毫秒时间戳,或者服务器时间是否已经同步。
500011 JSON_DECODE_FAIL
JSON解码失败,请确认传入的content加密前是标准的JSON结构,且数据类型、属性名和对接文档保持一致。
102001 ORDER_TASK_NOT_FOUND
提交的任务ID不存在,请确认是从理账狮后台获取的任务ID。
102002 ORDER_ENTERPRISE_PARK_BALANCE_LIMIT
订单金额超出了当前企业可用余额,请确认订单金额是否超出了当前企业可用余额。
102003 ORDER_NOT_FOUND
没有查询到指定外部订单号的订单,您可以判断此状态后为客户进行退款操作。
102101 ORDER_LIMIT_AMOUNT
订单金额超出了限制,请确认订单金额是否超出了限制。
102102 ORDER_LIMIT_YEAR_AMOUNT
全年发放总额超过限制,目前限制为 500W。
102103 ORDER_LIMIT_BANK_REASON
银行摘要不能包含敏感词。
102104 ORDER_LIMIT_REMARK
备注不能包含敏感词
102105 ORDER_NOT_SIGNED
用户未签约,可引导用户完成自由职业者签约后再发起支付,请在 理账狮后台 > 任务管理 > 详情 > 签约二维码 ,获取签约二维码展示给用户。
如您是主动上报签约,请参考 上报签约并派单
如果您可以引导用户自行完成签约,请按照 生成签约链接 进行签约流程。 其他签约方式请咨询客服。
其他未知状态
如果您收到了其他没有列出的状态码,不代表理账狮没有收到您的订单创建请求,此时请不要对您的订单进行任何操作。
您可以通过主动查询 订单查询 接口来获得订单的状态后再操作。
