POST
收款方添加
创建可用于后续 Transfer 打款的收款方。
请求
merchantNoOnerway 分配的商户号。通常在沙盒或生产商户开通后，从商户后台或开户材料中获取。
示例：
801129merchantRefId商户侧的用户或收款方引用 ID，可用于内部映射、检索或对账。
bankCountry收款方目标国家。
示例：
PKpayoutCurrency收款方使用的打款币种。
示例：
PKRentityType收款主体类型；
0 表示企业，1 表示个人。示例：
1paymentMethod该收款方使用的付款方式，需与收款方的国家、币种和主体类型匹配。
示例：
E_WALLETreceiverInfo{ companyName, lastName, ... }以 JSON 字符串编码的收款人身份信息，并按所选付款方式补齐要求的身份字段。
address{ countryCode, state, ... }以 JSON 字符串编码的收款地址信息；如有要求，需包含国家、省州、城市和地址行。
accountInfomation{ cardNumber, accountType, ... }以 JSON 字符串编码的收款账户信息，并按所选付款方式补齐对应账户字段。
sign请求签名字符串，需使用商户私钥按 Transfer 请求签名规则生成。
curl -X POST 'https://sandbox-api.onerway.com/payout/api/v1/beneficiary/add' \
-H 'Content-Type: application/json' \
--data-raw '{
"accountInfomation": "{\"walletType\":\"EASYPAISA\",\"walletPhone\":\"03001234567\"}",
"address": "{\"countryCode\":\"PK\",\"state\":\"Punjab\",\"city\":\"Lahore\",\"addressLine1\":\"12 Demo Street\",\"postalCode\":\"54000\"}",
"bankCountry": "PK",
"entityType": "1",
"merchantNo": "801129",
"merchantRefId": "bene_demo_001",
"paymentMethod": "E_WALLET",
"payoutCurrency": "PKR",
"receiverInfo": "{\"firstName\":\"Beta\",\"lastName\":\"Tester\",\"areaCode\":\"+92\",\"phone\":\"3001234567\",\"email\":\"beneficiary@example.com\",\"identityType\":\"NID\",\"identityNumber\":\"3520212345671\"}",
"sign": "{{SIGN}}"
}'响应
respCodeOnerway 返回的响应码。
respMsgOnerway 返回的响应信息。
data{ beneficiaryId, payeeStatus }创建收款方的结果。
{
"respCode": "20000",
"respMsg": null,
"data": {
"beneficiaryId": "1984102812163112960",
"payeeStatus": "unnecessary"
}
}该接口暂未记录错误响应。