收款账户开通申请 - PayKKa OpenAPI Documentation

请求参数

Header 参数

X-Merch-Id

string

可选

默认值:

M24061911365700670

Body 参数application/json

request_id

string

必需

请求号，请求方系统内唯一

>= 1 字符<= 32 字符

region

string

必需

收款国家/地区,使用ISO3166-2标准2位国家/地区代码(全球账户目前只支持HK,本地账户支持的收款国家见附件)

type

enum<string>

必需

账户类型 LOCAL-本地,SWIFT-全球

枚举值:

LOCALSWIFT

currency

string

必需

收款账户币种类型, 单币种: 使用ISO-4217标准3位币种代码, 多币种: MUL

remark_name

string

收款账户备注名

必需

>= 1 字符<= 20 字符

示例

{
    "request_id": "string",
    "region": "string",
    "type": "LOCAL",
    "currency": "string",
    "remark_name": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://open-fat.cb.paykka.com/api/v2/merch/va/apply' \
--header 'X-Merch-Id: M24061911365700670' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "string",
    "region": "string",
    "type": "LOCAL",
    "currency": "string",
    "remark_name": "string"
}'

返回响应

🟢200成功

*/*

OK

Body

request_id

string

必需

请求号，请求方系统内唯一

>= 1 字符<= 32 字符

type

enum<string>

必需

账户类型 LOCAL-本地,SWIFT-全球

枚举值:

LOCALGLOBAL

country_code

string

收款国家，原样返回

必需

currencies

array[string]

收款币种，原样返回

必需

枚举值:

EURUSDCNYGBPJPYAUDCADSGDHKDPHPCNH

account_no

string

必需

收款账号(长度20字符)

>= 0 字符<= 20 字符

status

enum<string>

必需

账户状态: ENABLED-启用, PENDING-待审核, REJECTED-审核拒绝

枚举值:

ENABLEDPENDINGREJECTED

bank_name

string

必需

银行名称(长度64字符)

>= 0 字符<= 64 字符

bank_address

string

必需

银行地址(长度128字符)

>= 0 字符<= 128 字符

account_holder_name

string

必需

账户持有者(100字符)

>= 0 字符<= 100 字符

bic_swift_code

string

必需

bic/swift_code(长度16字符)

>= 0 字符<= 16 字符

routing_number

string

可选

routing number/ach routing number/wire routing number三返一

示例

{
    "request_id": "string",
    "type": "LOCAL",
    "country_code": "string",
    "currencies": [
        "EUR"
    ],
    "account_no": "string",
    "status": "ENABLED",
    "bank_name": "string",
    "bank_address": "string",
    "account_holder_name": "string",
    "bic_swift_code": "string",
    "routing_number": "string"
}

🟠400请求有误

🟠401没有权限

🟠404记录不存在

🟠429429

🔴500服务器错误