| 接口说明 | 创建收款人 | |||||
| 接口地址 | https://api.moni.im/transfer/api/v1/create_recipient | |||||
| 测试接口地址 | https://testwebapi.omipay.com.cn/transfer/api/v1/create_recipient | |||||
| 请求参数 | 参数名称 | 类型 | 属性 | |||
| type | String | 必录，收款人类型。
|
||||
| currency | String | 必录，收款货币
传递ISO-4217规范中的货币代码 |
||||
| first_name | String | 当收款人类型为个人时，该字段传个人的名 | ||||
| middle_name | String | 非必录，该字段传个人的中间名 | ||||
| last_name | String | 当收款人类型为个人时，该字段传个人的姓 | ||||
| company_name | String | 公司名称为企业时必填 | ||||
| country | String | 必录，收款人所在国家
传递ISO-3166-1规范中的二位国家代码 |
||||
| bank_country | String | 必录，收款银行所在国家
传递ISO-3166-1规范中的二位国家代码 |
||||
| state | String | 必录，收款人所在州/省 | ||||
| city | String | 必录，收款人所在城市 | ||||
| street_address | String | 必录，收款人街道地址 | ||||
| street_address2 | String | 非必录，收款人街道地址补充信息 | ||||
| postal_code | String | 必录，收款人所在地邮编信息 | ||||
| String | 非必录，收款人邮箱 | |||||
| nickname | String | 非必录，收款人昵称 | ||||
| account_type | String | 收款人账户类型，具体参见《Omi-Transfer Playbook》 | ||||
| account_info | Object | 收款人账户信息，具体参见《Omi-Transfer Playbook》 | ||||
| 返回值 | 名称 | 类型 | 说明 | |||
| 成功返回 | is_success | Bool | 成功时返回true | |||
| recipient_id | Long | 收款人ID | ||||
| 失败返回 | is_success | Bool | 成功时返回false | |||
| error_code | String | 错误码 | ||||
| error_msg | String | 错误信息 | ||||
| 错误说明 | 错误码 | 说明 | ||||
| RISKCONTROL_DENIED | 风控拒绝，不能创建收款人 | |||||
| ACCOUNT_TYPE_ERROR | 收款人账户类型错误，可能原因是传递了错误的账户类型，或该账户类型不在对应币种的支持范围中 | |||||
| 其他错误见《Omi-Transfer Playbook》中的定义 | ||||||
