Onerway
POST

打款方新增

查看 Markdown
创建可用于后续 Transfer 打款的打款方。

请求

merchantNostring必填
Onerway 分配的商户号。通常在沙盒或生产商户开通后，从商户后台或开户材料中获取。
示例：801129
subEntityTypestring必填
付款主体类型；0 表示企业，1 表示个人。该选择会决定后续需要补齐企业还是个人主体字段。
示例：0
countrystring必填
付款方国家。
示例：GB
companyNameEnstring可选
企业付款方的英文公司名称。
companyNamestring可选
企业付款方的本地公司名称。
addressEn1string必填
付款方地址第一行。
postcodestring必填
付款方邮编。
emailstring必填
付款方邮箱。
areaCodestring必填
电话号码区号。
phoneNumberstring必填
付款方手机号。
statestring必填
付款方省州。
citystring必填
付款方城市。
idTypestring必填
付款方证件类型。具体取值取决于付款方是企业还是个人。
idNumberstring必填
付款方证件号码。
idValidDateTostring必填
付款方证件到期日。
signstring必填
请求签名字符串，需使用商户私钥按 Transfer 请求签名规则生成。

请求示例

curl -X POST 'https://sandbox-api.onerway.com/payout/api/v1/acct/addPayer' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "addressEn1": "Nanshan Science & Technology Park, Shenzhen",
  "areaCode": "+86",
  "city": "London",
  "companyName": "Demo Company Ltd",
  "companyNameEn": "Demo Company Ltd",
  "country": "GB",
  "email": "payer@example.com",
  "idNumber": "4563456546",
  "idType": "2",
  "idValidDateTo": "2046-08-04",
  "merchantNo": "801129",
  "phoneNumber": "15072871023",
  "postcode": "518057",
  "sign": "{{SIGN}}",
  "state": "London",
  "subEntityType": "0"
}'

响应

respCodestring
Onerway 返回的响应码。
respMsgstring
Onerway 返回的响应信息。
datastring
成功创建后返回的付款方 ID。

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": "1984096429476806656"
}
该接口暂未记录错误响应。

收款方详情查询

查询单个收款方的资料详情和审核状态。

通过收款方ID发起打款

使用已审核通过的收款人 ID 发起 Transfer 打款。