下发转账任务

请求参数

Body 参数application/json

cardNo

string

可选

卡号:为空默认为主账号

importBatchNo

string

必需

商户批次订单号:由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复

merchantId

integer <int64>

商户ID

必需

notifyUrl

string

可选

下发结果回调推送地址

orderTitle

string

可选

转账标题：酬劳发放(default), 福利发放, 佣金结算, 用户提现, 推广佣金, 费用报销, 货款结算

payTrans

array[object (SafePayBatchPayee) {15}]

必需

收款明细列表,此字段不参与签名

accountName

string

必需

收款账户名:[accountType]为1,2时填姓名;为3,4时填收款账户名

accountNo

string

必需

收款账户:[accountType]为1,3时填银行卡号;为2,4时填支付宝账号

accountType

integer <int32>

必需

收款账户类型:1-个人对私银行卡;2-个人对私支付宝;3-企业对公银行卡;4-企业对公支付宝

aliLoginType

string

可选

支付宝账户类型:[accountType=2,4时必传]ALIPAY_LOGON_ID：支付宝登录帐号；ALIPAY_USER_ID：支付宝用户ID

bankName

string

可选

银行名称:对公银行账户必填

branchCode

string

可选

支行联行号:[accountType]为3时与[branchName]二选一必填

branchName

string

可选

支行名称:[accountType]3时与[branchCode]二选一必填

city

string

可选

支行所在市:[accountType]为3时必填

idCardNo

string

身份证号

可选

importBizNo

string

商户明细订单号

必需

mobile

string

收款人联系方式

可选

orderTitle

string

可选

转账标题：酬劳发放(default), 福利发放, 佣金结算, 用户提现, 推广佣金, 费用报销, 货款结算

province

string

可选

支行所在省:[accountType]为3时必填

remark

string

备注

可选

transAmount

number

必需

转账金额:四舍五入保留两位

sign

string

签名

必需

timestamp

integer <int64>

请求时间戳

必需

totalCount

integer <int64>

批次总条数

必需

totalTransAmount

string

必需

批次总金额，单位元，精度2位小数

dynamicPassword

string

动态密码

必需

示例

{
  "cardNo": "string",
  "importBatchNo": "string",
  "merchantId": 0,
  "notifyUrl": "string",
  "orderTitle": "string",
  "payTrans": [
    {
      "accountName": "string",
      "accountNo": "string",
      "accountType": 0,
      "aliLoginType": "string",
      "bankName": "string",
      "branchCode": "string",
      "branchName": "string",
      "city": "string",
      "idCardNo": "string",
      "importBizNo": "string",
      "mobile": "string",
      "orderTitle": "string",
      "province": "string",
      "remark": "string",
      "transAmount": 0
    }
  ],
  "sign": "string",
  "timestamp": 0,
  "totalCount": 0,
  "totalTransAmount": "string",
  "dynamicPassword": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/safe-pay/batchPay/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardNo": "string",
    "importBatchNo": "string",
    "merchantId": 0,
    "notifyUrl": "string",
    "orderTitle": "string",
    "payTrans": [
        {
            "accountName": "string",
            "accountNo": "string",
            "accountType": 0,
            "aliLoginType": "string",
            "bankName": "string",
            "branchCode": "string",
            "branchName": "string",
            "city": "string",
            "idCardNo": "string",
            "importBizNo": "string",
            "mobile": "string",
            "orderTitle": "string",
            "province": "string",
            "remark": "string",
            "transAmount": 0
        }
    ],
    "sign": "string",
    "timestamp": 0,
    "totalCount": 0,
    "totalTransAmount": "string",
    "dynamicPassword": "string"
}'

返回响应

🟢200成功

*/*

OK

Body

响应数据

code

integer <int32>

可选

响应状态码:200=成功

data

object (BatchPayResultVo)

业务数据

可选

id

string

系统批次号

可选

importBatchNo

string

商户批次订单号

可选

merchantId

integer <int64>

商户ID

必需

sign

string

响应数据签名

必需

timestamp

integer <int64>

响应时间戳

必需

totalCount

integer <int64>

批次总条数

可选

totalTransAmount

string

可选

批次总金额，单位元，精度2位小数

msg

string

消息提示

可选

示例

{
  "code": 0,
  "data": {
    "id": "string",
    "importBatchNo": "string",
    "merchantId": 0,
    "sign": "string",
    "timestamp": 0,
    "totalCount": 0,
    "totalTransAmount": "string"
  },
  "msg": "string"
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在