1. 10.附加说明
飞来汇开放平台
  • 0.版本记录
  • 1.接入指南
    • 1.1 接入指南
    • 1.2 SDK接入指南
  • 2.平台认证
    • 获取access_token
      POST
  • 3.入网实名
    • 企业实名认证
      POST
    • 实名审核结果回调通知
      POST
    • 实名审核结果查询
      POST
    • 会员费率设置
      POST
    • 会员费率查询
      POST
  • 4.进件开户
    • 账户开通申请
      POST
    • 开户结果回调通知
      POST
    • 账户信息查询
      POST
  • 5.账户入金
    • 5.1 VA账户入金
      • 资金到账通知
      • 资金到账查询
    • 5.2 外币入账飞来汇
      • 创建/修改入账交易单
      • 查询入账交易单详情
      • 关联入账流水并发起入账申请
      • 入账申请审核结果查询
      • 交易订单入账审核结果回调
      • 查询补充贸易审核结果
      • 补充贸易背景审核结果回调通知
  • 6.账户提现
    • 查询可提现金额
      POST
    • 提现到账金额试算
      POST
    • 提现申请
      POST
    • 提现结果回调通知
      POST
    • 提现记录状态查询
      POST
    • 提现CNY换卡重发
      POST
  • 7.汇兑
    • 即时换汇汇率查询
      POST
    • 即时换汇申请
      POST
    • 即时汇兑结果回调通知
      POST
    • 即时换汇申请详情查询
      POST
    • 支持即时汇兑的货币对查询
      GET
  • 8.飞来汇账户
    • 账户余额
  • 9.通用接口
    • 文件上传
  • 10.附加说明
    • 附加说明
    • 返回码说明
  1. 10.附加说明

附加说明

10.1 安全性说明#

第三方平台接入飞来汇开放平台,需要保证access_token和client_token的安全性,不得对外暴露

10.2 签名加密说明#

10.2.1 鉴权方式#

采用RSA非对称加密算法,商户生成RSA公钥私钥,并将商户的公钥提供给飞来汇。
驼驼向商户提供appSecret(信息加密密钥)和 飞来汇的RSA公钥,请妥善保管确保数据安全。

10.2.2 数据交互规范#

使用HTTPS协议进行数据通信;
使用POST方式发送请求;
请求头带上飞来汇开放平台的access_token。参数名:Authorization,参数值:Bearer值+空格+access_token值。
服务器端参数值和返回的数据均为UTF-8编码,请求\响应数据使用JSON格式;
请求/响应头Content-Type: application/json;charset=UTF-8;
通过RSA加解密算法完成数据签名验证;
请求的所有POST参数通过数据签名算法生成签名字符串sign随其他参数一起发送到服务端。

10.2.3 业务数据AES加密解密&RSA签名验签#

10.2.3.1 业务数据进行AES加密处理#

使用appSecret通过AES加密算法对业务输入参数加密并base64_encode后得到ciphertext,具体步骤如下:
1.
将业务数据转成json字符串。
2.
将上步骤得到的字符串进行AES加密。
3.
将加密后的数据进行base64_encode即可得到密文ciphertext。

10.2.3.2 RSA签名使用说明#

RSA私钥与公钥皆是通过OPENSSL来生成得出的。商户一套公私钥,飞来汇另有一套公私钥,双方交换各自的公钥。私钥用于生成签名串,公钥用于验签。
1.
待签名字符串生成规则如下:
按照Request-ID&Tuotuo-Timestamp的方式拼接,获取待签名字符串。&为分隔符。
2.
请求时签名
把待签名字符串与私钥一同进行签名运算,将运算后的数据进行base64_encode,从而得到签名结果字符串。
3.
响应返回时验证签名
当接收到响应后,把待签名字符串、公钥、参数中的sign进行base64_decode后的值三者一起进行验签。

10.3 支持VA账户#

地区国家支持币种收款卡说明是否审核清算网络银行卡开户编码
欧洲🇩🇪 德国EUR欧元区卡需要SEPA10000000000001
欧洲🇩🇰 丹麦AUD, CAD, EUR, GBP,
HKD, JPY, SEK, SGD,
USD, CNH, CHF, DKK,
NOK, NZD, AED, CZK,
HUF, ILS, MXN, PLN,
RON, SAR, TRY, ZAR
全球收款卡需要SWIFT10000000000002
欧洲🇩🇰 丹麦DKK本地收款卡需要INTRADAG,Kronos210000000000003
欧洲🇬🇧 英国GBP全球收款卡-SEPA10000000000004
欧洲🇬🇧 英国GBP本地收款卡-BACS, FPS, CHATS10000000000005
亚洲🇻🇳 越南VND本地收款卡需要NAPAS, CITAD10000000000016
亚洲🇲🇾 马来西亚MYR本地收款卡需要RENTAS, Inter GIRO, DuitNow10000000000017
亚洲🇹🇭 泰国THB本地收款卡需要Bahtnet, Smart, Direct Debit10000000000018
亚洲🇵🇭 菲律宾PHP本地收款卡需要Instapay, PESONet10000000000011
亚洲🇮🇩 印尼IDR本地收款卡需要BI-RTGS, SKNBI10000000000012
非洲🇳🇬 尼日利亚NGN本地收款卡需要NIBSS10000000000014

10.4 ISO标准国家代码#

国家三位代码中文名英文名
AND安道尔(安多拉)Andorra
ARE阿拉伯联合酋长国United Arab Emirates
AFG阿富汗Afghanistan
ATG安提瓜岛Antigua and Barbuda
AIA安圭拉岛Anguilla
ALB阿尔巴尼亚Albania
ARM亚美尼亚Armenia
ANT荷属安的列斯群岛Netherlands Antilles
AGO安哥拉Angola
ARG阿根廷Argentina
ASM美属萨摩亚American Samoa
AUT奥地利Austria
AUS澳大利亚Australia
ABW阿鲁巴岛Aruba
AZE阿塞拜疆Azerbaijan
BIH波斯尼亚Bosnia and Hercegovina
BRB巴巴多斯岛Barbados
BGD孟加拉国Bangladesh
BEL比利时Belgium
BFA布基纳法索Burkina Faso
BGR保加利亚Bulgaria
BHR巴林群岛Bahrain
BDI布隆迪Burundi
BEN贝宁湾Benin
BMU百慕大群岛Bermuda
BRN文莱Brunei
BOL玻利维亚Bolivia
BRA巴西Brazil
BHS巴哈马群岛Bahamas
BTN不丹Bhutan
BWA博茨瓦纳Botswana
BLR白俄罗斯Belarus
BLZ伯利兹城Belize
CAN加拿大Canada
COD刚果 金Democratic Republic of Congo
CAF中非共和国Central African Republic
COG刚果 布The Republic of Congo
CHE瑞士Switzerland
CIV科特迪瓦Ivory Coast
COK库克群岛Cook Islands
CHL智利Chile
CMR喀麦隆Cameroon
CHN中国大陆China
COL哥伦比亚Colombia
CRI哥斯达黎加Costa Rica
CUB古巴Cuba
CPV佛得角共和国Cape Verde
CYP塞浦路斯Cyprus
CZE捷克Czech Republic
DEU德国Germany
DJI吉布提Djibouti
DNK丹麦Denmark
DMA多米尼加Dominica
DOM多米尼加共和国Dominican Republic
DZA阿尔及利亚Algeria
ECU厄瓜多尔Ecuador
EST爱沙尼亚Estonia
EGY埃及Egypt
ERI厄立特里亚Eritrea
ESP西班牙Spain
ETH埃塞俄比亚Ethiopia
FIN芬兰Finland
FJI斐济Fiji
FLK福克兰群岛Falkland Islands
FSM密克罗尼西亚Micronesia,Federated States of
FRO法罗群岛Faeroe Islands
FRA法国France
GAB加蓬Gabon
GRD格林纳达Grenada
GEO格鲁吉亚Georgia
GUF法属圭亚那French Guiana
GHA加纳Ghana
GIB直布罗陀Gibraltar
GRL格陵兰Greenland
GMB冈比亚Gambia
GIN几内亚Guinea
GLP瓜德罗普岛Guadeloupe
GNQ赤道几内亚Equatorial Guinea
GRC希腊Greece
GTM危地马拉Guatemala
GUM关岛Guam
GNB几内亚比绍共和国Guinea-Bissau
GUY圭亚那Guy ana
HKG中国香港Hong Kong (China)
HND洪都拉斯Honduras
HRV克罗地亚Croatia
HTI海地Haiti
HUN匈牙利Hungary
IDN印尼Indonesia
IRL爱尔兰Ireland
ISR以色列Israel
IND印度India
IRQ伊拉克Iraq
IRN伊朗Iran
ISL冰岛Iceland
ITA意大利Italy
JAM牙买加Jamaica
JOR约旦Jordan
JPN日本Japan
KEN肯尼亚Kenya
KGZ吉尔吉斯斯坦Kirghizia (formerly Kyrgyzstan)
KHM柬埔寨Cambodia
KIR基里巴斯Kiribati
COM科摩罗Comoros
KNA圣基茨和尼维斯SaNumber Kitts and Nevis
PRK朝鲜North Korea
KOR韩国South Korea
KWT科威特Kuwait
CYM开曼群岛Cayman Islands
KAZ哈萨克Kazakhstan
LAO老挝国Laos
LBN黎巴嫩Lebanon
LCA圣卢西亚SaNumber Lucia
LIE列支敦士登Liechtenstein
LKA斯里兰卡Sri Lanka
LBR利比里亚Liberia
LSO莱索托Lesotho
LTU立陶宛Lithuania
LUX卢森堡Luxembourg
LVA拉脱维亚Latvia
LBY利比亚Libya
MAR摩洛哥Morocco
MCO摩纳哥Monaco
MDA摩尔多瓦Moldova
MNE黑山Montenegro
MDG马达加斯加岛Madagascar
MHL马绍尔群岛Marshall Islands
MKD马其顿Macedonia
MLI马里Mali
MMR缅甸Myanmar
MNG蒙古Mongolia
MAC中国澳门Macau
MNP北马里亚纳群岛Northern Mariana islands
MTQ马提尼克Martinique
MRT毛利塔尼亚Mauritania
MSR蒙特塞拉特岛Montserrat
MLT马耳他Malta
MUS毛里求斯Mauritius
MDV马尔代夫Maldives
MWI马拉维Malawi
MEX墨西哥Mexico
MYS马来西亚Malaysia
MOZ莫桑比克Mozambique
NAM纳米比亚Namibia
NCL新喀里多尼亚New Caledonia
NER尼日尔Niger
NFK诺福克Norfolk Island
NGA尼日利亚Nigeria
NIC尼加拉瓜Nicaragua
NLD荷兰Netherlands(Holland)
NOR挪威Norway
NPL尼泊尔Nepal
NRU瑙鲁Nauru
NIU纽埃Niue
NZL新西兰New Zealand
OMN阿曼Oman
PAN巴拿马Panama
PER秘鲁Peru
PYF法属波利尼西亚French Polynesia
PNG巴布亚新几内亚Papua New Guinea
PHL菲律宾共和国Philippines
PAK巴基斯坦Pakistan
POL波兰Poland
PRI波多黎各Puerto Rico
PRT葡萄牙Portugal
PLW帕劳群岛Palau
PRY巴拉圭Paraguay
QAT卡塔尔Qatar
REU留尼汪岛Reunion Island
ROU罗马尼亚Romania
SRB塞尔维亚共和国Serbia
RUS俄罗斯Russia
RWA卢旺达Rwanda
SAU沙特阿拉伯Saudi Arabia
SLB所罗门Solomon Islands
SYC塞舌尔Seychelles
SDN苏丹Sudan
SWE瑞典Sweden
SGP新加坡Singapore
SVN斯洛文尼亚Slovenia
SVK斯洛伐克Slovakia
SLE塞拉利昂Sierra Leone
SMR圣马力诺San Marino
SEN塞内加尔Seneg al
SOM索马里Somalia
SUR苏里南Suriname
SSD南苏丹South Sudan
STP圣多美和普林西比Sao Tome and Principe
SLV萨尔瓦多El Salvador
SYR叙利亚共和国Syria
SWZ斯威士兰Swaziland
TCA特克斯和凯科斯群岛Turks and Caicos Islands
TCD乍得Chad
TGO多哥Togo
THA泰国Thailand
TJK塔吉克斯坦Tajikistan
TLS东帝汶East Timor
TKM土库曼斯坦Turkmenistan
TUN突尼斯Tunisia
TON汤加Tonga
TUR土耳其Turkey
TTO特立尼达和多巴哥Trinidad and Tobago
TUV图瓦卢Tuvalu
TWN中国台湾Taiwan (China)
TZA坦桑尼亚Tanzania
UKR乌克兰Ukraine
UGA乌干达Uganda
GBR英国United Kingdom
USA美国United States
URY乌拉圭Uruguay
UZB乌兹别克斯坦Uzbekistan
VAT梵蒂冈Vatican City
VCT圣文森特和格林纳丁斯SaNumber Vincent and Grenadines
VEN委内瑞拉Venezuela
VGB英属维尔京群岛British Virgin Islands
VIR美属维尔京群岛US Virgin Islands
VNM越南VietNam
VUT瓦努阿图Vanuatu
WLF瓦利斯群岛Wallis and Futuna Islands
WSM萨摩亚Sam oa
YEM也门Yemen,Repubic of
ZAF南非South Africa
ZMB赞比亚Zambia
ZWE津巴布韦Zimbabwe

10.5 本地付款限制#

字段名字段要求以色列
对私
孟加拉国
对私
欧洲
对私
欧洲
对公
美国&USD
对公
美国&USD
对私
其他非中国地区
对公/对私
CNY
对私
CNY
对公
收款人名称1-100字符YYYYYYYYY
银行账号4-34数字/大小写字母YYYYYYYYY
开户银行2-100字符,中国大陆CNY从接口获取YYYYYYYYY
开户行 SWIFT Code8/11位英文/英文+数字YYYY二选一必填二选一必填Y//
开户行 Routing number3-11字符,数字Y///二选一必填二选一必填///
分行代码3-11字符/Y///////
收款人省/州1-50字符NNNNYYN//
收款人城市1-50字符NNNNYYN//
收款人地址5-200字符,英文字符+数字NNYYYYY//
邮政编码3-12字符,数字NNNNYYN//
开户行所在省-///////YY
开户行所在市-///////YY
分行支行名称不支持空格、特殊字符!@#$%^&*()、英文符号、标点符号///////YY
企业营业执照号码-////////N
持卡人身份证号-///////N/
开户行联行号12位数字///////YY
预留手机号-///////NN
备注-NNNNNNNNN

10.6 pobo付款限制#

支持币种:AUD(澳大利亚元)、CAD(加拿大元)、EUR(欧元)、GBP(英镑)、HKD(港币)、JPY(日元)、SEK(瑞典克朗) 、SGD(新加坡元)、USD(美元)、CNH(离岸人民币)、CHF(瑞士法郎) 、DKK(丹麦克朗)、NOK(挪威克朗)、NZD(新西兰元)
收款人必须要有SWIFTCODE,且SWIFTCODE前8位!=DHBKHKHH

10.7 mainProductClass#

keyvalue
301办公文教&工商业
302表
303电玩游戏
304服装
305发制品
306婚纱礼服
307家居与花园
308家用电器
309母婴用品
310时尚配件
311手机和手机附件
312数码相机、摄影器材
313玩具与礼物
314箱包机箱包辅料
315鞋类及鞋类辅料
316乐器
317运动乐户外产品
318照明灯饰
319珠宝
320其他产品

10.8 支持汇兑的币种对#

源币种目标币种
AEDUSD
AUDUSD
CADUSD
CNHUSD
EURUSD
GBPUSD
HKDUSD
IDRUSD
JPYUSD
SARUSD
SGDUSD
THBUSD
TRYUSD
CHFUSD
NZDUSD
CADAUD
EURAUD
GBPAUD
HKDAUD
JPYAUD
SEKAUD
SGDAUD
USDAUD
CNHAUD
AUDCAD
EURCAD
GBPCAD
HKDCAD
JPYCAD
SEKCAD
SGDCAD
USDCAD
CNHCAD
NZDCAD
GBPEUR
CNHEUR
USDEUR
AUDGBP
CADGBP
EURGBP
HKDGBP
JPYGBP
SEKGBP
SGDGBP
USDGBP
CNHGBP
AUDHKD
CADHKD
EURHKD
GBPHKD
SGDHKD
USDHKD
CNHHKD
AUDJPY
CADJPY
EURJPY
GBPJPY
HKDJPY
SEKJPY
SGDJPY
USDJPY
CNHJPY
AUDSEK
CADSEK
EURSEK
GBPSEK
HKDSEK
JPYSEK
SGDSEK
USDSEK
CNHSEK
AUDSGD
CADSGD
EURSGD
GBPSGD
HKDSGD
JPYSGD
SEKSGD
USDSGD
CNHSGD
AUDCNH
CADCNH
EURCNH
GBPCNH
HKDCNH
JPYCNH
SGDCNH
USDCNH
CHFCNH
DKKCNH
NZDCNH
PHPUSD
MXNUSD
MYRUSD
CZKAUD
CZKCAD
CZKEUR
CZKGBP
CZKHKD
CZKJPY
CZKSEK
CZKSGD
CZKCNH
CZKCHF
CZKDKK
CZKNOK
CZKNZD
CZKAED
CZKHUF
CZKILS
CZKMXN
CZKPLN
CZKRON
CZKSAR
CZKTRY
CZKZAR
HUFAUD
HUFCAD
HUFEUR
HUFGBP
HUFHKD
HUFJPY
HUFSEK
HUFSGD
HUFUSD
HUFCNH
HUFCHF
HUFDKK
HUFNOK
HUFNZD
HUFAED
HUFCZK
HUFILS
HUFMXN
HUFPLN
HUFRON
HUFSAR
HUFTRY
HUFZAR
ILSAUD
ILSCAD
ILSEUR
ILSGBP
ILSHKD
ILSJPY
ILSSEK
ILSSGD
ILSUSD
ILSCNH
ILSCHF
ILSDKK
ILSNOK
ILSNZD
ILSAED
ILSCZK
ILSHUF
ILSMXN
ILSPLN
ILSRON
ILSSAR
ILSTRY
ILSZAR
MXNAUD
MXNCAD
MXNEUR
MXNGBP
MXNHKD
MXNJPY
MXNSEK
MXNSGD
MXNCNH
MXNCHF
MXNDKK
MXNNOK
MXNNZD
MXNAED
MXNCZK
MXNHUF
MXNILS
MXNPLN
MXNRON
MXNSAR
MXNTRY
MXNZAR
PLNAUD
PLNCAD
PLNEUR
PLNGBP
PLNHKD
PLNJPY
PLNSEK
PLNSGD
PLNCNH
PLNCHF
PLNDKK
PLNNOK
PLNNZD
PLNAED
PLNCZK
PLNHUF
PLNILS
PLNMXN
PLNRON
PLNSAR
PLNTRY
PLNZAR
RONAUD
RONCAD
RONEUR
RONGBP
RONHKD
RONJPY
RONSEK
RONSGD
RONCNH
RONCHF
RONDKK
RONNOK
RONNZD
RONAED
RONCZK
RONHUF
RONILS
RONMXN
RONPLN
RONSAR
RONTRY
RONZAR
ZARAUD
ZARCAD
ZAREUR
ZARGBP
ZARHKD
ZARJPY
ZARSEK
ZARSGD
ZARCNH
ZARCHF
ZARDKK
ZARNOK
ZARNZD
ZARAED
ZARCZK
ZARHUF
ZARILS
ZARMXN
ZARPLN
ZARRON
ZARSAR
ZARTRY
VNDUSD
SARRON
SARTRY
SARZAR
TRYAUD
TRYCAD
TRYEUR
TRYGBP
TRYHKD
TRYJPY
TRYSEK
TRYSGD
TRYCNH
TRYCHF
TRYDKK
TRYNOK
TRYNZD
TRYAED
TRYCZK
TRYHUF
TRYILS
TRYMXN
TRYPLN
TRYRON
TRYSAR
TRYZAR
AEDAUD
AEDCAD
AEDEUR
AEDGBP
AEDHKD
AEDJPY
AEDSEK
AEDSGD
AEDCNH
AEDCHF
AEDDKK
AEDNOK
AEDNZD
AEDCZK
AEDHUF
AEDILS
AEDMXN
AEDPLN
AEDRON
AEDSAR
AEDTRY
AEDZAR
SARAUD
SARCAD
SAREUR
SARGBP
SARHKD
SARJPY
SARSEK
SARSGD
SARCNH
SARCHF
SARDKK
SARNOK
SARNZD
SARAED
SARCZK
SARHUF
SARILS
SARMXN
SARPLN
VNDCNH
NGNUSD
USDIDR
USDNGN
USDPHP
USDMYR
USDKRW
THBCNH
MYRCNH
注意:支持的币种对会随着政策、国际形式和公司战略调整而变化,最新支持币种可参考接口 7.汇兑-支持汇兑的币种对查询接口
修改于 2025-12-17 08:29:54
上一页
文件上传
下一页
返回码说明
Built with