受益人申请 - 珊瑚跨境开放平台

请求参数

Header 参数

X-Request-Id

string

请求标识

必需

默认值:

Body 参数application/json

partnerSerialNumber

string

必需

流水标识〔集成产商流水〕

<= 36 字符

scene

enum<string>

场景类型

必需

枚举值:

WITHDRAWALTRANSFER

accountNumber

string

银行账号

必需

accountHolder

string

必需

持卡人
币种为非 CNY 下只允许为英文、数字以及英文符号「含空格」

bankName

string

必需

开户银行名称
币种为非 CNY 下只允许为英文、数字以及英文符号「含空格」

bankAddress

string

必需

开户银行地址
币种为非 CNY & 转账场景下只允许为英文、数字以及英文符号「含空格」

bankBranch

string

开户支行名称

可选

bankBic

string

可选

开户银行 BIC
币种为非 CNY & 转账场景下必填

country

enum<string>

国家

必需

枚举值:

ADAEAFAGAIALAMAOARATAUAWAZBABBBDBEBFBGBHBIBJBMBNBOBRBSBTBWBYBZCACDCFCGCHCICKCLCMCNCOCRCUCVCYCZDEDJDKDMDODZECEEEGERESETFIFJFKFMFOFRGAGBGDGEGFGHGIGLGMGNGPGQGRGTGUGWGYHKHNHRHTHUIDIEILINIQIRISITJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENGNINLNONPNRNZOMPAPEPFPGPHPKPLPMPRPSPTPWPYQARERORURWSASBSCSDSESGSHSKSLSMSNSOSRSTSVSYSZTCTDTGTHTJTMTNTOTRTTTVTWTZUAUGUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

currency

enum<string>

币种

必需

枚举值:

USDEURJPYGBPAUDCADCNYIDRSGDHKDKRWDKKMYRTHBAEDVND

beneficiaryName

string

可选

受益人名称
转账场景下必填
币种为非 CNY & 转账场景下只允许为英文、数字以及英文符号「含空格」

beneficiaryCountry

enum<string>

可选

受益人国家
转账场景下必填

枚举值:

ADAEAFAGAIALAMAOARATAUAWAZBABBBDBEBFBGBHBIBJBMBNBOBRBSBTBWBYBZCACDCFCGCHCICKCLCMCNCOCRCUCVCYCZDEDJDKDMDODZECEEEGERESETFIFJFKFMFOFRGAGBGDGEGFGHGIGLGMGNGPGQGRGTGUGWGYHKHNHRHTHUIDIEILINIQIRISITJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENGNINLNONPNRNZOMPAPEPFPGPHPKPLPMPRPSPTPWPYQARERORURWSASBSCSDSESGSHSKSLSMSNSOSRSTSVSYSZTCTDTGTHTJTMTNTOTRTTTVTWTZUAUGUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

beneficiaryAddress

string

可选

受益人地址
转账场景下必填
币种为非 CNY & 转账场景下只允许为英文、数字以及英文符号「含空格」

account

enum<string>

账户类型

必需

枚举值:

PERSONALCOMPANY

document

array[string]

可选

资质证明
必填场景〔转账场景 & 币种为 CNY〕 | 〔提现场景〕
文件内容

1.

企业 - 进出口资质证明

2.

个人 - 银行开户证明
文件格式支持 .pdf .xls .xlsx .doc .docx .jpg .jpeg .png 数量不超过 5 个
单个文件大小不超过 10 M
使用文件上传接口上传后, 置入文件标识

示例

{
    "partnerSerialNumber": "string",
    "scene": "WITHDRAWAL",
    "accountNumber": "string",
    "accountHolder": "string",
    "bankName": "string",
    "bankAddress": "string",
    "bankBranch": "string",
    "bankBic": "string",
    "country": "AD",
    "currency": "USD",
    "beneficiaryName": "string",
    "beneficiaryCountry": "AD",
    "beneficiaryAddress": "string",
    "account": "PERSONAL",
    "document": [
        "string"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://gateway-openapi.coralglobal.cn/v1/beneficiary/apply' \
--header 'X-Request-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partnerSerialNumber": "string",
    "scene": "WITHDRAWAL",
    "accountNumber": "string",
    "accountHolder": "string",
    "bankName": "string",
    "bankAddress": "string",
    "bankBranch": "string",
    "bankBic": "string",
    "country": "AD",
    "currency": "USD",
    "beneficiaryName": "string",
    "beneficiaryCountry": "AD",
    "beneficiaryAddress": "string",
    "account": "PERSONAL",
    "document": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

code

string

错误编码

可选

message

string

错误信息

可选

data

object (BeneficiaryApplyVO)

响应主体

可选

beneficiaryId

string

受益人标识

可选

partnerSerialNumber

string

可选

流水标识〔集成产商流水〕

timestamp

string

时间戳

可选

示例

{
  "code": "",
  "message": "",
  "data": {
    "beneficiaryId": "",
    "partnerSerialNumber": ""
  },
  "timestamp": ""
}