EasyPay API

收款人信息校验

POST

/v3/beneficiaries/validate

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

legal_entity_type

enum<string>

账户类型

必需

枚举值:

PERSONCOMPANY

payment_type

enum<string> | enum<null>

付款方式

可选

枚举值:

LOCALSWIFT

region

string

地区

必需

currency

string

币种

必需

bank_name

string

银行名称

必需

bank_branch_name

string | null

银行支行名称

可选

bank_location

string | null

银行地址

可选

account_holder_name

string

必需

银行账户持有人 (支持填写汉字英文字母大小写空格英文符号 ! # $ % ‘ ( ) * + , - . / : ; ‘= ? @ [ ] ^ _ ` { } ~ 其它均不支持)

account_number

string

银行账号/IBAN

必需

bic_number

string | null

路由号/SWIFT

可选

aba

string | null

ABA

可选

sort_code

string | null

Sort Code

可选

id_number

string | null

收款方证件号

可选

cnaps_code

string

可选

联行号[企业人民币付款必填]

mobile

string | null

收款方联系方式

可选

first_name

string | null

可选

收款方 first name

last_name

string | null

可选

收款方 last name

state_or_province

string | null

收款方所在州或省

可选

city

string | null

收款方所在城市

可选

address

string | null

可选

收款方所在地址（支持填写汉字英文字母大小写空格英文符号 ! # $ % ‘ ( ) * + , - . / : ; ‘= ? @ [ ] ^ _ ` { } ~ 其它均不支持）

zip_code

string | null

收款方所在地邮编

可选

relationship

enum<string> | enum<null>

与收款方关系

可选

枚举值:

Sharehold / DirectorParent Company to holding companySubsidiaryBusiness partnersEmployerRelativesColleague

正则匹配:

[a-zA-Z0-9/\-:.,+\s]+

intermediary_bank_bic_number

string | null

可选

指定中转行路由号/SWIFT (2024-12-10生效)

business_nature

string | null

主营业务

可选

正则匹配:

[a-zA-Z0-9/\-:.,+\s]+

company_website

string | null

公司网址

可选

正则匹配:

[a-zA-Z0-9/\-:.,+\s]+

示例

{
  "legal_entity_type": "PERSON",
  "payment_type": "LOCAL",
  "region": "string",
  "currency": "string",
  "bank_name": "string",
  "bank_branch_name": "string",
  "bank_location": "string",
  "account_holder_name": "string",
  "account_number": "string",
  "bic_number": "string",
  "aba": "string",
  "sort_code": "string",
  "id_number": "string",
  "cnaps_code": "string",
  "mobile": "string",
  "first_name": "string",
  "last_name": "string",
  "state_or_province": "string",
  "city": "string",
  "address": "string",
  "zip_code": "string",
  "relationship": "Sharehold / Director",
  "intermediary_bank_bic_number": "string",
  "business_nature": "string",
  "company_website": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://demo-api.easypayx.com/v3/beneficiaries/validate' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "legal_entity_type": "PERSON",
    "payment_type": "LOCAL",
    "region": "string",
    "currency": "string",
    "bank_name": "string",
    "bank_branch_name": "string",
    "bank_location": "string",
    "account_holder_name": "string",
    "account_number": "string",
    "bic_number": "string",
    "aba": "string",
    "sort_code": "string",
    "id_number": "string",
    "cnaps_code": "string",
    "mobile": "string",
    "first_name": "string",
    "last_name": "string",
    "state_or_province": "string",
    "city": "string",
    "address": "string",
    "zip_code": "string",
    "relationship": "Sharehold / Director",
    "intermediary_bank_bic_number": "string",
    "business_nature": "string",
    "company_website": "string"
}'

返回响应

🟢201OK

application/json

Body

data

boolean

必需

示例

{
  "data": true
}

修改于 2023-05-26 04:04:30

提交实名更新

通过实名