10.3 钱包提现 - 汇联开放平台

请求参数

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

非必传项，目前仅代理商/服务商可传，普通商户和平台商户请勿传入

timestamp

string

时间戳

必需

请求时间戳单位秒，要求timestamp与当前时间间隔在60秒以内

requestId

string

请求id

必需

请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题

signType

string

签名方式

必需

固定值：RSA2

bizContent

object

请求参数

必需

由于工具限制，该字段必须转为JSON格式字符串，请注意

mchChannelCode

string

用户识别码

必需

settle

integer

提现类型

可选

银盛yqt钱包提现必传，1=个人钱包，2=企业钱包

walletId

string

钱包编号

必需

cashOrderNo

string

商户提现订单号

必需

amount

string

提现金额单位元

必需

notifyUrl

string

回调地址

可选

redirectUrl

string

重定向链接，业务成功后重定向到此链接当验证权限为密码校验时必填

可选

remark

string

提现备注

必需

accountType

string

提现资金账户类型

可选

银盛yqt 企业钱包必传
提现资金账户类型
01-一般消费类账户（bankAccountNo必填）
02-待结算账户（商户结算方式为平台内时bankAccountNo必填，否则无法到账）

bankAccountNo

string

提现卡号

可选

银盛yqt 企业钱包必传
提现银行卡号（仅已绑定的提现卡或结算卡）

linkId

string

绑卡id

可选

银盛yqt 个人钱包必传

sign

string

签名

必需

参照签名方法

示例

{
  "appId": "APP_8428691003",
  "subSn": "",
  "timestamp": "1736149707",
  "requestId": "5cfc158c-27c5-4cd4-b2c3-b18bbed35552",
  "signType": "RSA2",
  "bizContent": {
    "mchOrderNo": "a46c3dd1-e507-41d2-a4e2-37ac562d3b92",
    "requestId": "49",
    "cashOrderNo": "b381c750-dcda-4508-aecd-6dab66bf482d",
    "amount": "651.00",
    "notifyUrl": "https://mediocre-bid.org/",
    "remark": "consectetur esse"
  },
  "sign": "H6oAMOljItjCsEC72RmZ/s9VFg/BFZbv3oPtUKjoM7w3jeNgCLOrFASD0o3Qbesnd9xkCbT62IJt/sNBvs47ja02X2QGBYg5+aXIZ6zn6Uu+HegqdMYBTtjrY3t2sBHVr+QK5mZo59Ic7baVEz4NTBkS/BPbtlrwIvbcqq9quSZ5vCyBt/nkXUNy0JgxtzCofwT8I4pKWUQcWovI+AIt/a0wW8VOcoKA+vif4DmiNK0BitypOYpr4aFDZodj8DYdBRXQFA12KRCk1q3HERvQSLE33FAg+xF+LOKy2zLucqdjgzBSwne0CVOhjKDXU9EdQO1bH+fRam9A83HT0sUJsw=="
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.qywh8.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "APP_8428691003",
    "subSn": "",
    "timestamp": "1736149707",
    "requestId": "5cfc158c-27c5-4cd4-b2c3-b18bbed35552",
    "signType": "RSA2",
    "bizContent": {
        "mchOrderNo": "a46c3dd1-e507-41d2-a4e2-37ac562d3b92",
        "requestId": "49",
        "cashOrderNo": "b381c750-dcda-4508-aecd-6dab66bf482d",
        "amount": "651.00",
        "notifyUrl": "https://mediocre-bid.org/",
        "remark": "consectetur esse"
    },
    "sign": "H6oAMOljItjCsEC72RmZ/s9VFg/BFZbv3oPtUKjoM7w3jeNgCLOrFASD0o3Qbesnd9xkCbT62IJt/sNBvs47ja02X2QGBYg5+aXIZ6zn6Uu+HegqdMYBTtjrY3t2sBHVr+QK5mZo59Ic7baVEz4NTBkS/BPbtlrwIvbcqq9quSZ5vCyBt/nkXUNy0JgxtzCofwT8I4pKWUQcWovI+AIt/a0wW8VOcoKA+vif4DmiNK0BitypOYpr4aFDZodj8DYdBRXQFA12KRCk1q3HERvQSLE33FAg+xF+LOKy2zLucqdjgzBSwne0CVOhjKDXU9EdQO1bH+fRam9A83HT0sUJsw=="
}'

返回响应

🟢200OK

application/json

Body

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

data

object

返回数据体

必需

mchChannelCode

string

用户识别码

可选

商户通道唯一标识

cashOrderNo

string

提现订单编号

可选

payOrderNo

string

平台提现单号

可选

amount

string

提现金额

必需

settleDate

string

提现日期

必需

remark

string

提现备注

必需

orderStatus

string

提现状态

必需

1=初始化，2=处理中，3=成功，4=失败，5=人工介入中

pageUrl

string

密码验证页面

可选

walletId

string

钱包编号

必需

msg

string

返回信息

可选

appId

string

应用APPID

必需

sn

string

商户编码

可选

sign

string

签名

必需

timestamp

string

时间戳

必需

signType

string

签名方式目前仅支持RSA2

必需

示例

{
  "code": 2,
  "data": {
    "cashOrderNo": "anim",
    "payOrderNo": "adipisicing fugiat esse voluptate",
    "amount": "842.00",
    "settleDate": "2025-10-25",
    "remark": "commodo dolor",
    "orderStatus": "Duis"
  },
  "msg": "fugiat",
  "appId": "39",
  "sn": "cupidatat fugiat non",
  "sign": "sit enim ullamco culpa",
  "timestamp": "1736149897",
  "signType": "laborum eiusmod voluptate"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found