1. Payee
OPEN-API
  • API Call Description
  • Constant Declaration
    • Wallet
      • Wallet Status
      • In Out Type
      • Transaction Type
      • Transaction Status
    • Bin
      • Bin Type
      • Bin Mode
      • Bin Status
    • Card
      • Card Status
      • Card Trade
        • Card Trade Type
        • Card Trade Result
    • Order
      • Card Type
      • Order Type
      • Order Status
      • Order Bill
        • Order Bill Type
        • In Out Type
        • Bill Category
    • Payee
      • Payee Status
    • Payment
      • Fee Mode
      • Payment Status
  • Webhook
    • Card Notify
      • Order
      • Card
      • Card Trade
    • Payee Notify
    • Payment Notify
    • Wallet Notify
  • Api
    • Wallet
      • 钱包列表
      • 钱包详情
      • 交易流水列表
      • 交易详情
      • 获取兑换汇率
    • Card
      • Bin
        • 卡Bin列表
        • 卡Bin详情
        • 卡Bin费用
        • 卡Bin限制
      • Card
        • 卡列表
        • 卡详情
        • 卡激活
        • 卡冻结
        • 卡解冻
        • 发起销卡
        • 卡交易列表
        • 商户交易评分
      • Order
        • 开卡
        • 卡充值
        • 订单列表
        • 订单详情
      • Holder
        • 持卡人列表
        • 创建持卡人
        • 编辑持卡人
        • 持卡人详情
        • 删除持卡人
    • PayMethod
      • 付款方式
    • Payee
      • 运营资金来源列表
        POST
      • 预期付款目的列表
        POST
      • 创建收款方
        POST
      • 编辑收款方
        POST
      • 申请收款方
        POST
      • 删除收款方
        POST
      • 收款方列表
        POST
      • 收款方详情
        POST
    • Payment
      • 付款原因
      • 创建付款
      • 付款列表
      • 付款详情
  1. Payee

创建收款方

POST
/{{version}}/openApi/payee/createPayee

使用场景#

 创建收款方。
请求参数#
Http Post Application/json
字段类型是否必传描述
customer_idlong是客户id
app_idlong是应用id
keystring是授权key
working_capitalarray[int]是运营资金来源, 通过接口获取选项列表,如:[1,2,3]
payment_purposearray[int]是预期付款目的, 通过接口获取选项列表,如:[1,2,3]
is_high_riskint否是否高风险
countrystring是收款方国家
currencystring是收款方币种
pay_methodstring是付款方式,通过选择国家后,加载支持的付款方式进行选择
swift_codestring否SWIFT 号
remittance_routingstring否支付路由
bank_accountstring是银行账户
account_nostring是银行账号
bank_namestring是银行名称
bank_addressstring是银行地址
company_namestring否企业名
company_nick_namestring否企业昵称
company_emailstring否企业邮箱地址
company_countrystring否企业国家
company_citystring否企业城市
company_addressstring否企业地址
remarkstring否备注信息
示例
{
    "customer_id": 10001004,
    "app_id": 100006,
    "key": "0408ab79eb214e7d81d9fd447b5916a2",
    "working_capital": [1,2],
    "payment_purpose": [1,2,3],
    "is_high_risk": 0,
    "country": "HK",
    "currency": "HKD",
    "pay_method": "RTGS",
    "swift_code": "9988776655",
    "remittance_routing": "2134243254",
    "bank_account": "bank_account",
    "account_no": "4353453463464567",
    "bank_name": "bank_name",
    "bank_address": "bank_address",
    "account_name": "hk-egc",
    "company_name": "k-egc",
    "company_nick_name": "k-egc",
    "company_email": "k-egc@gmail.com",
    "company_country": "HK",
    "company_city": "HongKong",
    "company_address": "HongKong...xxxxxxx.",
    "remark": "remark"
}
响应内容#
字段类型是否必传描述
totalint是总数
page_noint是当前页码
page_sizeint是当前每页记录数
payment_purpose_listarray[object]是运营资金来源数组
payment_purpose_list.codeint是编号
payment_purpose_list.namestring是目的名称
示例
{
    "code": 0,
    "message": "success",
    "data": {
        "payee_id": "p_1gMQmij0",
        "status": 1
    }
}

请求参数

Body 参数application/json

示例
{
    "customer_id": 10001004,
    "app_id": 100006,
    "key": "0408ab79eb214e7d81d9fd447b5916a2",
	"working_capital": [1,2],
	"payment_purpose": [1,2,3],
	"is_high_risk": 0,
	"country": "HK",
	"currency": "HKD",
	"pay_method": "RTGS",
	"swift_code": "9988776655",
	"remittance_routing": "2134243254",
	"bank_account": "bank_account",
    "account_no": "4353453463464567",
    "bank_name": "bank_name",
    "bank_address": "bank_address",
	"company_name": "k-egc",
	"company_nick_name": "k-egc",
	"company_email": "k-egc@gmail.com",
	"company_country": "HK",
	"company_city": "HongKong",
	"company_address": "HongKong...xxxxxxx.",
	"remark": "remark"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'http://prod-cn.your-api-server.com/{{version}}/openApi/payee/createPayee' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer_id": 10001004,
    "app_id": 100006,
    "key": "0408ab79eb214e7d81d9fd447b5916a2",
	"working_capital": [1,2],
	"payment_purpose": [1,2,3],
	"is_high_risk": 0,
	"country": "HK",
	"currency": "HKD",
	"pay_method": "RTGS",
	"swift_code": "9988776655",
	"remittance_routing": "2134243254",
	"bank_account": "bank_account",
    "account_no": "4353453463464567",
    "bank_name": "bank_name",
    "bank_address": "bank_address",
	"company_name": "k-egc",
	"company_nick_name": "k-egc",
	"company_email": "k-egc@gmail.com",
	"company_country": "HK",
	"company_city": "HongKong",
	"company_address": "HongKong...xxxxxxx.",
	"remark": "remark"
}'

返回响应

🟢200成功
application/json
Body

示例
{}
修改于 2026-03-19 06:16:48
上一页
预期付款目的列表
下一页
编辑收款方
Built with