Skip to content

创建支付订单

IMPORTANT

创建订单需要先创建任务并审核通过,订单要求用户姓名、手机号二要素匹配。如用户未完成签约和报名任务,将无法进行发放。

请注意

IMPORTANT

创建订单接口返回并不代表发起或支付成功,如不清晰发起支付的状态和结果需要重试时,请 不要 更换业务流水号,一定要使用 原业务流水号 重试,否则可能 造成重复支付 等资金风险。同一个流水号只能上报一次,重复上报接口将提示外部订单号重复错误。

明确订单状态,可通过订单查询接口查询。

发起生产前,请您确认是否按照 异常订单处理方案 处理了异常订单的各种错误处理,否则可能会导致资金损失!

接口地址

order/create

请求参数

参数名称是否必须类型描述
outerTradeNotrueString外部订单号(您系统的订单号,保持唯一)
realNametrueString真实姓名
phonetrueString不再需要传入,自动取签约手机号
idCardtrueString证件号
idCardTypefalseInteger证件类型,目前固定传入 1,身份证
payAccounttrueString支付账号(支持手机号/邮箱/银行卡)
reasontrueString建议填写 “服务费”,不能包含的敏感词:工资、薪酬、提现、薪、补贴、分红、奖金、返现、劳务费、分润、备用金、咨询等,否则可能触发风控拦截
bizAccounttrueString业务账号(您系统的用户唯一索引)
balancetrueDouble支付金额 (单位元,最多两位小数,0.1-50000)
taskIdtrueLong任务ID (需任务通过审核)
bizAccounttrueString业务账号(您系统的用户唯一索引)
extensionfalseString透传字段,原样返回
notifyUrlfalseString回调通知地址,优先使用,应用兜底

明确创建订单成功的状态

如理账狮明确收到了您的创建订单请求,我们将固定返回状态码 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

用户未签约,可引导用户完成自由职业者签约后再发起支付,请在 理账狮后台 > 任务管理 > 详情 > 签约二维码 ,获取签约二维码展示给用户。

如您是主动上报签约,请参考 上报签约并派单

如果您可以引导用户自行完成签约,请按照 生成签约链接 进行签约流程。 其他签约方式请咨询客服。

其他未知状态

如果您收到了其他没有列出的状态码,不代表理账狮没有收到您的订单创建请求,此时请不要对您的订单进行任何操作

您可以通过主动查询 订单查询 接口来获得订单的状态后再操作。