8.5 对内转账 - 汇联开放平台

请求参数

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

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

timestamp

string

时间戳

必需

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

requestId

string

请求id

必需

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

signType

string

签名方式

必需

固定值：RSA2

bizContent

object

请求参数

必需

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

transferType

integer

操作类型

必需

1=账户类，2=钱包类，3=电子户类，4=其他类

mchChannelCode

string

通道用户标识

必需

outMchChannelCode

string

付款方用户识别码

必需

如果是钱包转账就是付款方钱包编号

inMchChannelCode

string

收款方用户识别码

必需

如果是钱包转账就是收款方钱包编号

mchOrderNo

string

转账订单号

必需

amount

string

转账金额，元

必需

remark

string

转账备注

必需

yqtTransferType

string

转账类型

可选

目前仅银盛yqt渠道必传，其他留空
P2B-平台转商户 P2C-平台转用户
B2P-商户转平台 B2B-商户转商户
B2C-商户转用户 C2C-用户转用户

notifyUrl

string

异步通知地址

可选

redirectUrl

string

同步跳转地址

可选

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

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

通道用户标识

必需

transferType

integer

转账类型

可选

银盛yqt渠道必传，1=个人钱包，2=企业钱包

mchOrderNo

string

商户转账订单号

必需

payOrderNo

string

平台转账订单号

必需

amount

string

转账金额

必需

status

string

转账状态

必需

1=初始化 2=需验证 3=转账中 4=转账完成 5=转账失败

remark

string

转账备注

可选

message

string

转账提示

可选

successTime

string

转账成功时间

可选

outMchChannelCode

string

付款方用户识别码

必需

如果是钱包转账就是付款方钱包编号

inMchChannelCode

string

收款方用户识别码

必需

如果是钱包转账就是收款方钱包编号

pageUrl

string

密码验证页面

可选

用于短信验证确认接口

authSn

string

认证序列号

可选

有效期5分钟，过期后需重新请求

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