软猫引擎API开放平台
  1. 收银台API
软猫引擎API开放平台
  • 接口安全API(必看)
    • 获取AccessToken
      POST
  • 用户基础API
    • 获取永久用户标识
      • 获取永久用户标识UserId(根据临时用户标识userCode)
      • 获取永久用户标识UserId(根据已注册的手机号码)
    • 用户登录/退出
      • 发送短信验证码(用户登录)
      • 用户登录(通过短信验证码)
      • 用户登录(通过密码)
      • 用户退出登录
    • 用户注册
      • 发送短信验证码(用户注册)
      • 上传用户头像(用户注册)
      • 用户注册
    • 修改用户登录密码
      • 发送短信验证码(修改用户登录密码)
      • 修改用户登录密码
    • 修改用户安全密码
      • 发送短信验证码(修改用户安全密码)
      • 修改用户安全密码
    • 修改用户手机号码
      • 发送短信验证码(修改用户手机号码-新手机号码)
      • 发送短信验证码(修改用户手机号码-原手机号码)
      • 修改用户手机号码
    • 用户资料
      • 获取用户资料
      • 获取用户等级
      • 获取用户职称
      • 设置用户头像
      • 设置用户昵称
      • 设置用户性别
      • 设置用户所在地
    • 用户配置
      • 配置Key说明
      • 读取用户配置
      • 批量读取用户配置
      • 修改用户配置
  • 用户收件地址API
    • 获取用户的收件地址列表
      POST
    • 获取用户的收件地址(根据id获取)
      POST
    • 添加用户收件地址
      POST
    • 修改用户收件地址
      POST
    • 删除用户收件地址
      POST
    • 设置默认用户收件地址
      POST
  • 用户资产API
    • 余额配置
    • 积分配置
    • 代币配置
    • 用户银行卡
      • 获取支持的银行列表
      • 验证银行卡号是否正确
      • 绑定用户银行卡
      • 解绑用户银行卡
      • 获取已绑定的用户银行卡列表
  • 文件API
    • 上传临时图片文件
    • 上传临时视频文件
    • 上传临时音频文件
  • 系统功能API
    • 功能Key说明
    • 获取所有已开通的功能列表
    • 验证是否已开通指定功能
  • 行政区划API
    • 获取省市区树
    • 获取省份列表(一级行政区划)
    • 获取城市列表(二级行政区划)
    • 获取区/县/镇列表(三级行政区划)
  • 收银台API
    • 获取订单支付句柄(用于发起支付)
      POST
    • 发起余额支付
      POST
    • 发起积分支付
      POST
    • 发起代币支付
      POST
    • 判断是否已开通微信支付
      POST
    • 发起微信支付
      POST
    • 判断(微信支付)订单是否已付款
      POST
    • 判断订单是否已付款
      POST
  • 数据模型
    • 标准响应模型
    • 用户银行卡数据模型
    • 用户收件地址数据模型
  1. 收银台API

发起余额支付

POST
https://api.rmao.cn/order/balancepay

特别注意#

1)当用户配置SecurePassword=1且SecurePasswordSchema[]=BlancePay时,需传入安全密码securityPassword
2)可通过【用户基础API->用户配置】接口读取用户配置SecurePassword、SecurePasswordSchema
3)因安全密码问题返回的错误信息有以下几种:
{"code": 10021,"codeEn":"NeedSecurityPassword","msg":"需传入安全密码"}  //收到该响应后,应该弹出安全密码输入框,让客户输入6位安全密码,再重新发起支付
{"code": 10022,"codeEn":"UnsetedSecurityPassword","msg":"未设置安全密码,请先设置安全密码"} //收到该响应后,应该引导客户设置安全密码,最后再重新发起支付
{"code": 10023,"codeEn":"SecurityPasswordErrorMax","msg":"安全密码连续输入错误次数超过XX次,请修改安全密码后重试"} //收到该响应后,应该引导客户修改安全密码,再重新发起支付
{"code": 10024,"codeEn":"SecurityPasswordError","msg":"安全密码输入错误,请重新输入"} //收到该响应后,应该弹出安全密码输入框,让客户重新输入6位安全密码,再重新发起支付

请求参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.rmao.cn/order/balancepay' \
--header 'AccessToken: xHw/8kBN3cX+GYeqwyy/+6Y2b4jd/Bgc3AN9iMv4Z4YlRENRtV6umDQW1i8rzXyc3/Oearu6ersb6t1MJaDD6132FFJ99/wIWHDd2PXZeCpQ3SevE4jaKBeyXlK1Sj5n5fNUNasdNdNdkbf4QxRvA1Csgm71Ke4prpIaYrq0IPmSRLeYUuKSeARTpsqqWHiu+lbq5QusK5pIdpWJVQ6mTIslMFsentq/MPSw6yr7W7TnMXqjBbqdNMbdqNEmfDxRZwNGpgJnaUjovTBCiBSFup+ojujxvQbKKvRbF1Lcy0jcNN7BYFsiarDH/NwLcLfT0MSGNGBC2dYiZvScjLQ0Ew==' \
--form 'userId="cadd4401-32d3-46c9-abde-825af9a79285"' \
--form 'userCode="dBdW2vFQ2abDaVNNjFb0H3"' \
--form 'code="251221004947080068405259"' \
--form 'securityPassword="698d51a19d8a121ce581499d7b701668"'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 1,
    "codeEn": "SUCCESS",
    "msg": "请求成功",
    "requestId": "2e29fdda-81f4-435d-9d41-72339fccd28a",
    "time": 1765361127640
}
修改于 2025-12-20 17:15:45
上一页
获取订单支付句柄(用于发起支付)
下一页
发起积分支付
Built with