甬易支付文档中心

主题

商户提现查询 ​

接口描述 ​

  • 接入方可以通过该接口进行商户提现结果查询。

请求URL ​

  • /merchant/settleQuery

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是stringappId202409561403450909
signature是string签名
transNonce是string32请求流水号123456
transDate是string13请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
merchantNo是string32商户编号XS241111000102
originalRequestNo否string32原请求流水号123456789
drawNo否string32提现流水号1856546347350794241
  • 注：drawNo和originalRequestNo不能同时为空

请求报文示例 ​

json
 {
  "appId": "202415629590370906",
  "merchantNo": "XS241111000102",
  "originalRequestNo": "18595450000003001",
  "signature": "UA1MOjpmc/XCHT7v7FwtisdzBEMdWDcXs+GcWK5n0wd3vhcpFJgLo0A/KfS/LQRmq4Cm2kHSJ8J6GNml0Qxn6JtXmEoJVTQDnIrHvy/0Z/a/+OEyFMhaqVkV+fD7+3hsd8QFaJ/9+C3+95dtbF5bNIxU1lYdq3aYmzyrprfskwFjFy8R1P0VdIbmupQZo1MaZTl7ck4IZf0jcz36kJmzjFQaa5dCfHxWkYJxRx+8LjBCRR+bk0aiRMFTIoT22QA6Bq9xAj09cG7BkQXrTQQvwPNke+AtWS4aPnqJbp358eRljZFaLNqAFP2d2Kd0ebIEtWjdgoPz+ZX5nZ269ed1xg==",
  "transDate": "1731470119410",
  "transNonce": "ac12c789-6d3b-43df-93f5-54d23eb1b30e"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码00000000
message是string响应信息成功
signature是string签名
transNonce是string32请求流水号(同入参)123456
transDate是string13请求时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例
merchantNo是string32商户号XS241111000102
requestNo是string32请求流水号123456789
drawNo是string32提现流水号1856546347350794241
drawAmount是long32提现金额(单位分)100
drawStatus是string32提现状态：
INIT-初始，PROCESSING-处理中，ERROR-异常处理中，SUCCESS-成功，FAIL-失败		SUCCESS
resultCode否string响应码
resultMsg否string响应描述
applyTime是string申请时间(yyyyMMddHHmmss)20240101120000
paymentTime否string出款时间(yyyyMMddHHmmss)20240101120002
bankAccountNo是string银行卡号脱敏值
bankAccountName是string银行账户名称脱敏值
bankAccountType是string银行账户类型：
BU-对私账户，BC-对公账户		BU
bankNo是string银行卡开户行行号
bankName是string银行卡开户行名称
bankBranchNo是string银行卡开户支行行号
bankBranchName是string银行卡开户支行名称

响应示例 ​

json
 {
  "appId": "202408554212370909",
  "merchantNo": "XS241113000204",
  "requestNo": "123456789",
  "drawNo": "1856546347350794241",
  "drawAmount": 100,
  "drawStatus": "SUCCESS",
  "resultCode": "0000",
  "resultCode": "提现成功",
  "bankAccountName": "**然",
  "bankAccountNo": "621700*********1460",
  "bankAccountType": "BU",
  "bankBranchName": "招商银行股份有限公司武汉东西湖支行",
  "bankBranchNo": "308521015284",
  "bankName": "招商银行",
  "bankNo": "308584000013",
  "signature": "exCsFUiaSptDPtolFklsDx0yHrDGi5u1E9ujvoT/4mMPFW3Vq2criGow0fCh7ZyLRFe4CtYPrE/QH8RypiZtroofmlPytqbZKUX3cBCgOPkac/2Fhx1ffJdYrAhUeBSxtTNVC16kUSLjBn0wlcQr2AvFIj72nAj92MHUHeiQO3INuCYaA3cj8tWw5W5WoCBUWjYpdaxcIbOrJrHGu4yo+JcHoe/u/rxUN8crWXQvnSKdiMIPjigJeZ6S648Heui58ffhLrK7zuUOKwu4JdVBLOq+ta9Q1MUp3KkK6iR1ovqUuK0/lTk/F3QMZiBNdFq4yqMy8GRNSWAA7P99nC85qg==",
  "transDate": "1731486017900",
  "transNonce": "879df171f3de481d825e1e185638ee22"
}

备注 ​