请求URL

POST {域名}/api/settle/platform-apply-settle

请求参数

加密数据dataContent

序号 域名 变量名 必填 长度 备注
1. 商户号 userNo M Number 商户在GEP系统开通的唯一商户编号
2. 证书编号 certificateId M Number GEP提供给商户的证书编号
3. 出款申请单号 userReqNo M String(32) 商户请求GEP系统的申请订单号,由商户保证此单号唯一
4. 出款币种 paymentCcy M String(3) 商户开通的出款币种
5. 出款金额 paymentAmount M Number 实际出款的资金
6. 付款用途 paymentPurpose M Number 付款用途:1-往来结算款、2-贷款、3-差旅费、4-生活费、5-投资款项、6-办公费用、7-工程款、8-劳务费/薪酬、9-学费、10-其他
7. 行业类型 industryType O String(2) 行业类型:01=货物贸易 06=物流 08-广告收入默认是01
8. 通知地址 callBackUrl M String(128) 商户侧的请求地址,汇款成功或失败后会通过此地址通知给商户,通知参数见结汇结果通知接口
9. 结汇订单明细文件编号 paymentMaterial M Number(19) 通过文件上传接口上传文件之后返回的文件编号
10. 结汇订单明细文件名称 paymentMaterialName M String(64) 付款凭证的文件名称,注意目前只支持Excel文件
11. 出款店铺集合 paymentStoreList M Array 出款店铺集合,可通过可出款店铺查询接口查询
11.1 店铺编号 storeNo M Number 出款的店铺编号,此店铺编号可通过页面端获取或通过提出款店铺信息查询接口中查询
11.2 出款金额 paymentAmt M Number 店铺的出款金额,店铺出款的币种同申请中的出款币种一致

dataContent示例

{
  "callBackUrl": "http://10.0.60.55:8083/link3",
  "certificateId": "2103031802000005106",
  "industryType": "01",
  "paymentAmount": "100",
  "paymentCcy": "USD",
  "paymentMaterial": 13330739,
  "paymentMaterialName": "GEP-结汇货物贸易明细XLSX模版.xlsx",
  "paymentPurpose": "1",
  "paymentStoreList": [
    {
      "paymentAmt": "100",
      "storeNo": "2112161112000115915"
    }
  ],
  "userNo": "5181200731000138828",
  "userReqNo": "202408191158377275854047"
}

响应参数

结果信息result

序号 域名 变量名 必填 长度 备注
01. GEP订单号 orderId M String GEP内部的唯一订单号
02. 商户号 userNo M Number 商户在GEP系统开通的唯一商户编号
03. 证书编号 certificateId M Number GEP提供给商户的证书编号
04. 汇款申请单号 userReqNo M String(32) 商户请求GEP系统的申请订单号,由商户保证此单号唯一
05. 付款币种 paymentCcy M String(3) 商户开通的出款币种
06. 付款金额 paymentAmount M Number 实际付款的资金,当付款币种和收款币种不一致时,并且固定模式为1时,此字段必须大于0,固定模式为2时此字段填写0
07. 收款到账币种 payeeCcy M String(3) 实际境外收款的币种
08. 收款到账金额 payeeAmount M Number 实际境外收款的资金,当付款币种和收款币种不一致时,并且固定模式为1时,此字段必须为0,固定模式为2时此字段必须大于0
09. 交易汇率 tradeRate M Number 交易汇率,交易和到账币种不一致时需先汇兑
10. 固定模式 fixedModel M Number 固定模式:1-固定付款金额,2-固定收款金额
11. 付款用途 paymentPurpose M Number 付款用途:1-往来结算款、2-贷款、3-差旅费、4-生活费、5-投资款项、6-办公费用、7-工程款、8-劳务费/薪酬、9-学费、10-其他
12. 付款附言 paymentReference O String(128) 汇款附言,只能是英文
13. 费用承担方式 costBorne M String(3) 费用承担方式:SHA-非全额到账、OUR-全额到账、BEN-收款人承担
14. 付款材料文件ID paymentMaterial M Number 通过文件上传接口上传成功之后返回的文件编号
15. 银行账号 cardNo M String(128) 已经在GEP平台绑定的帐号
16. 账户名称 accountName 已经在GEP平台绑定的账户名称,其中银行帐号 + 账户名 + 收款到账币种确认一个收款人帐号信息
17. 付款手续费币种 paymentFeeCcy M String(3) 只能是商户开通的账户币种,出款的手续费币种
18. 付款的手续费金额 paymentFeeAmount M Number 付款的手续费金额
19. 交易手续费金额汇率 paymentFeeRate M Number 手续费的汇率,因为GEP平台手续费都是按照USD来计算,出款的手续费不是USD时,需要折算成对应手续费

result示例

{
  "applyDate": "2024-08-19 11:58:39",
  "costBorne": "OUR",
  "orderId": 2408191158000049700,
  "payeeAmount": 714.84,
  "payeeCcy": "CNH",
  "paymentAmount": 100,
  "paymentCcy": "USD",
  "paymentFeeAmount": 0,
  "paymentFeeCcy": "USD",
  "paymentFeeRate": 100,
  "paymentPurpose": 1,
  "status": 1,
  "tradeRate": 714.84,
  "userNo": 5181200731000139000,
  "userReqNo": "202408191158377275854047"
}