在线咨询
电话 联系电话
400-9999-359
QQ QQ客服
微信 官方微信

附录

1. 交易币种(ISO 4217)

币种名

代码

 

币种名

代码

Won

KRW

 

Russian Ruble

RUB

Yeni Türk Liras

TRY

Convertible Marks

BAM

Rand

ZAR

Bulgarian Lev

BGN

UAE Dirham

AED

Croatian Kuna

HRK

Mexican Peso

MXN

Forint

HUF

Chilean Peso

CLP

Lithuanian Litas

LTL

Belarussian Ruble

BYR

Latvian Lats

LVL

Malaysian Ringgit

MYR

Leu romacircnesc

RON

Denar

MKD

Serbian dinars

RSD

Serbian Dinar

CSD

Brazilian Real

BRL

Pakistan Rupee

PKR

Baht

THB

Hryvnia

UAH

New Israeli Sheqel

ILS

Iranian Rial

IRR

Yuan Renminbi

CNY

Tanzanian Shilling

TZS

US Dollar

USD

Armenian Dram

AMD

Pound Sterling

GBP

Iceland Krona

ISK

Euro

EUR

Azerbaijan Manat

AZN

Australian Dollar

AUD

Lek

ALL

Canadian Dollar

CAD

Taka

BDT

Yen

JPY

Saudi Riyal

SAR

Singapore Dollar

SGD

Lari

GEL

Hong Kong Dollar

HKD

Zloty

PLN

Malaysian Ringgit

MYR

New Zealand Dollar

NZD

Philippine Peso

PHP

Norvegian Krone

NOK

New Taiwan Dollar

TWD

Danish Krone

DKK

Indian Rupee

INR

Swedish Krona

SEK

Czech Koruna

CZK

Swiss Franc

CHF

 

 

 

2. 返回代码列表

2.1 业务错误码表

代码

描述

9900

支付成功

7700

支付失败

6600

处理中

2.2 返回代码表

代码

描述

00000

成功

I0001

商户号不能为空

I0002

网关接入号不能为空

I0003

加密值不能为空

I0004

商户号与网关接入号不匹配

I0005

商户号未激活。请联系客服

I0006

商户号停用。请联系客服

I0007

商户号不存在

I0008

商户号状态异常

I0009

网关接入号未激活

I0010

网关接入号停用

I0011

网关接入号删除

I0012

网关接入号状态异常

I0013

加密值错误

I0014

非正式网关接入号接入正式接口

I0015

非测试网关接入号接入测试接口

I0016

该网关接入号未绑定本接口

I0017

商户订单号不能为空

I0018

订单号不能超过50位

I0019

订单金额不能为空

I0020

订单金额不正确

I0021

订单金额小数位数不能超过2位且不能小于0

I0022

订单币种不能为空

I0023

订单币种错误

I0024

订单返回地址不能为空

I0025

订单返回地址长度不能超过1000个字符

I0026

卡号不能为空

I0027

卡号请输入至少13位

I0028

卡号请输入数字

I0029

卡号开头数字必须是4或5

I0030

卡号错误

I0031

月份不能为空

I0032

月份只能输入两位数

I0033

月份只能输入数字

I0034

月份必须为1-12月

I0035

年份不能为空

I0036

年份只能输入四位数

I0037

年份只能输入数字

I0038

年份和月份不能早于当前日期(不能为过期时间),年份不能超过10

I0039

(CVV)验证码不能为空

I0040

请输入3或4位数字的验证码

I0041

验证码只能输入数字

I0042

发卡行不能为空

I0043

请输入2-50位字符

I0044

名字不能为空

I0045

名字:请输入2-100个字符

I0046

姓氏不能为空

I0047

姓氏:请输入2-50个字符

I0048

邮箱地址不能为空

I0049

邮箱地址:请输入2-200个字符  

I0050

邮箱格式错误

I0051

持卡人电话号码不能为空

I0052

电话号码:请输入2-50位字符

I0053

持卡人国家不能为空

I0054

国家:请输入2-100个字符

I0055

持卡人地址不能为空

I0056

地址:请输入2-500个字符

I0057

持卡人邮编不能为空

I0058

邮编:请输入2-100个字符

I0059

Property{0},can not be empty

I0060

Property{0},length is more than {1}

I0061

商户订单号重复(如果在您这个网关接入号下已经存在一笔待处理/待确定/成功的交易,那么相同的商户订单号则不允许2次交易)

I0062

流水订单号已存在

I0063

持卡人的州/省份不能为空

I0064

州名:最多可输入100个字符

I0065

持卡人城市不能为空

I0066

城市名:请输入2-100个字符

I0067

备注: 最多可输入500个字符

I0068

2方接口受限(2方商户服务器ip未登记到对应的商户号下)

I0069

请选择支付方式

I0070

请选择支付类型

I0071

IP地址不能为空

I0072

IP地址格式错误

I0074

保存持卡人唯一标识码失败

I0075

请求持卡人唯一标识码失败

I0076

持卡人唯一标识符数据库中不存在

I0077

商户提供的持卡人卡号和唯一标识符与相应卡号不匹配

I0078

商户提供的持卡人cvv和唯一标识符与相应CVV不匹配

I0079

商户提供的持卡人信用卡有效月份和唯一标识符与相应的信用卡有效月份不匹配

I0080

商户提供的持卡人信用卡有效年份和唯一标识符与相应的信用卡有效月份不匹配

I0081

商户提供的持卡人名和唯一标识符与相应的姓名不匹配

I0082

商户提供的持卡人姓和唯一标识符与相应的姓名不匹配

I0083

商户提供的持卡人送货地址和唯一标识符与相应的送货地址不匹配

I0084

商户提供的持卡人所在城市和唯一标识符与相应的城市不匹配

I0085

商户提供的持卡人姓名和唯一标识符与相应的姓名不匹配

I0086

商户提供的持卡人所在国家和唯一标识符与相应的国家不匹配

I0087

商户提供的持卡人邮编和唯一标识符与相应的邮编不匹配

I0088

商户提供的持卡人发卡行和唯一标识符与相应的发卡行不匹配

I0089

商户提供的持卡人邮编和唯一标识符与相应的邮编不匹配

I0090

商户提供的持卡人电话号码和唯一标识符与相应的电话号码不匹配

I0091

qiwi用户名: 账号必须为10位数字

I0092

支付方式:支付方式错误

I0093

ebanx名不能为空

I0094

ebanx名:可输入2-50个字符

I0095

ebanx邮箱不能为空

I0096

ebanx邮箱:可输入2-50个字符

I0097

ebanx邮箱格式错误

I0098

ebanx类型须为【boleto】或【_tef】

I0099

银行代码为必填项,须为四位数字。

I0100

账户号不能为空

I0101

银行代码只能4-10位数字,开头数字不能为零

I0102

银行代码不能为空

I0103

银行代码为八位数字

 

R0000

高风险

R0001

未设置金额限定

 

C0001

商户网关接入号未绑定通道

C0002

商户网关接入号未设置扣率

C0003

商户网关接入号通道扣率设置错误

C0004

商户网关接入号通道扣率设置错误

C0005

币种未设置汇率

C0006

获取汇率失败

C0007

商户未绑定支付域名

C0008

商户网关接入号未绑定 {0} 通道

C0009

商户网关接入号未设置扣率

 

S0001

保存到异常交易表失败

S0002

保存到持卡人信息表失败

S0003

保存到非正式交易表失败

S0004

保存到附加交易表失败

S0005

获取通道信息异常

S0006

保存交易信息失败

S0007

更新测试表失败

S0008

删除异常记录表失败

S0009

保存交易记录表失败

S0010

获取商户绑定域名信息失败

S0011

保存持卡人信息表失败

S0012

获取银行通道信息失败

S0013

银行返回修改交易记录表失败

S0014

通道未绑定邮件域名

S0015

更新交易记录表重复支付标识失败

S0016

更新交易参考号失败

 

 

E0000

关闭支付页面

E0001

操作超时

E0002

操作超时

E0003

发送银行失败

E0004

调用银行异常

E0005

银行返回的通道代码不存在

E0006

返回银行失败

E0007

系统错误

E0008

客户Cancel订单(点击取消)

 

 

T0001

交易成功,测试交易

T0002

待处理

T0003

成功,2方接口未连接至银行

 

 

A0001

授权类型不能为空

A0002

授权类型错误

A0003

返回URL 不能为空

A0004

返回URL 长度过长,不能超过100

A0005

流水订单号不能为空

A0006

流水订单号错误

A0007

此订单不是预授权交易

A0008

此订单不能发起授权操作

A0009

超过授权完成有限时间

A0010

备注不能超过100个字符

 

3. 退款申请代码列表

错误代码

描述

英文描述

00

退款申请成功

Processing

01

传入对象为空

Incorrect parameter transmission

03

访问ip错误

Incorrect registered IP address

04

传入参数不全

Insufficient parameter transmission

05

商户号错误

Invalid Merchant ID

06

网关接入号错误

Invalid Gateway ID

08

流水订单号格式错误

Incorrect format of Ref No.

09

退款金额大于交易金额

Refunded amount over original amount

10

退款类型设置错误

Incorrect refund Type

12

签名信息错误

Incorrect SHA256

13

订单状态非成功,不可申请退款

Failed transaction,can not apply for refund

14

订单已冻结,不可申请退款

Transaction suspended,can not apply for refund

15

交易金额不正确

Incorrect transaction amount

16

币种不正确

Incorrect currency

17

保证金已制表,不可申请退款

Rolling reserve is being settled,can not apply for refund

18

退款金额格式不正确

Incorrect refund amount format

19

退款金额和退款类型不符

Incorrect refund amount and type

20

该通道不支持部分退款

Partial refund is not supported

21

划款已处理,不能退款

Transaction is being settled,can not apply for refund

22

交易金额格式不正确

Incorrect transaction amount format

23

退款原因长度过长

Refund reason over length

24

交易未勾兑,不可申请退款

Pending for transaction reconciliation

25

退款金额大于可退金额,不可申请退款

Refunded amount over refundable amount

26

商户跟踪号过长

MerTrackNo over length

27

订单已超过180天,不可申请退款

Over 180 days,can not be refunded

29

退款金额不能为0

The refund amount cannot be 0

98

无此交易

No transaction record on file

109

请稍后再试

Try again later

110

退款成功

Refund Approved

111

退款被银行拒绝

The refund was rejected by the bank

 

4. 退款明细查询接口调用响应代码列表

错误代码

描述

英文描述

00

调用接口成功

Interface call success

04

退款编号不存在

Refund number does not exist

05

签名信息错误

Error signature information

06

你方IP未登记

Incorrect registered IP address

90

无效的商户跟踪号

Invalid MerTrackNo

91

无效的交易流水号

Invalid TradeNo

92

无此交易

No transaction record on file

93

无效的退款编号

Invalid Refund batch number

94

无效的网关接入号

Invalid Gateway ID

95

无效的商户号

Invalid Merchant ID

96

传入参数不全

Insufficient parameter transmission

97

无此交易

No transaction record on file

98

传入对象为空

Incorrect parameter transmission

99

查询退款发生异常

System error

 

5. 退款状态代码列表

错误代码

描述

英文描述

00

已退款

Refunded

01

审核成功未处理

Audit Success untreated

02

待审核

Pending

03

审核失败

Audit failure

 

6. sha256加密方式

注意:若参数中带有 & “ ‘ < >请html转码之后再进行加密。

● Java 加密方式:

signInfo=sha256(merNo+gatewayNo+orderNo+orderCurrency+orderAmount+returnUrl+signkey);

● PHP 加密方式:

$signInfo=hash("sha256",$merNo.$gatewayNo.$orderNo.$orderCurrency.$orderAmount.$returnUrl.$signkey);

● C# 加密方式:

public string GetSHA256(string strData)
{
  	 //使用SHA256加密算法:
   	System.Security.Cryptography.SHA256 sha256 = new System.Security.Cryptography.SHA256Managed();

   	byte[] sha256Bytes = System.Text.Encoding.Default.GetBytes(strData);
  	byte[] cryString = sha256.ComputeHash(sha256Bytes);
   	string sha256Str = string.Empty;
  	for (int i=0;i < cryString.Length;i++)
   	{
   		 sha256Str += cryString[i].ToString("X2");
  	}
   	return sha256Str;
}

 

7. 签名验证

在调试接口的过程中,您可以通过点击签名验证链接对signkey字段进行预先验证。

可验证接口包含: 两方、三方、勾兑、预授权、退款、上传物流单号。

 

8. 运输商编码

139快递【139Express】

递四方速递【4PXExpress】

aCommerce【aCommerce】

阿联酋邮政【AEPost】

阿富汗邮政【AFPost】

安提瓜和巴布达邮政【AGPost】

安圭拉邮政【AIPost】

阿尔巴尼亚邮政【ALPost】

亚美尼亚邮政【AMPost】

安骏物流【AnJun】

荷属安的列斯邮政【ANPost】

安哥拉邮政【AOPost】

Aramex【Aramex】

ARAS【ARAS】

阿根廷邮政【ARPost】

奥地利邮政【ATPost】

Fastway快递【AUFastway】

澳大利亚邮政【AUPost】

阿鲁巴邮政【AWPost】

奥兰群岛邮政【AXPost】

阿塞拜疆邮政【AZPost】

孟加拉EMS【BangladeshEMS】

波黑邮政【BAPost】

巴巴多斯邮政【BBPost】

孟加拉邮政【BDPost】

永利八达通【BDT】

比利时邮政(International)【BEInternationalPost】

比利时邮政【BEPost】

百世快递【BestEx】

布基纳法索邮政【BFPost】

保加利亚邮政【BGPost】

巴林邮政【BHPost】

布隆迪邮政【BIPost】

百慕大邮政【BMPost】

文莱邮政【BNPost】

玻利维亚邮政【BOPost】

巴西邮政【BRPost】

BRTItaly【BRTIT】

巴哈马邮政【BSPost】

不丹邮政【BTPost】

博茨瓦纳邮政【BWPost】

白俄罗斯邮政【BYPost】

伯利兹邮政【BZPost】

加拿大邮政【CAPost】

CDEK【CDEK】

刚果民主共和国邮政【CDPost】

刚果共和国邮政【CGPost】

中国邮政EMS【ChinaEMS】

赛时国际货运【CHOICE】

瑞士邮政【CHPost】

出口易【Chukou1】

科特迪瓦邮政【CIPost】

希杰物流【CJLogistics】

城晓国际快递【CKEEX】

可为易达【ClevyLinks】

智利邮政【CLPost】

CNE速一物流【CNE】

中国邮政小包【CNPost】

ColisPrive【ColisPrive】

哥伦比亚邮政【COPost】

CouriersPlease【CouriersPlease】

哥斯达黎加邮政【CRPost】

佛得角邮政【CVPost】

塞浦路斯邮政【CYPost】

捷克邮政【CZPost】

DBSchenker【DBSchenker】

AsendiaDE【DEAsendia】

DHL【DHL】

DHLExpress【DHLEX】

DHLeCommerceAsia【DHLGlobalMailAsia】

DHLeCommerceUS【DHLGlobalMailUS】

德国DHL小包【DHLPacket】

吉布提邮政【DJPost】

丹麦邮政【DKPost】

多米尼克邮政【DMPost】

多米尼加邮政【DOPost】

德国DPD【DPD】

DPEX【DPEX】

阿尔及利亚邮政【DZPost】

厄瓜多尔邮政【ECPost】

爱沙尼亚邮政【EEPost】

爱沙尼亚邮政(Post11)【EEPost11】

埃及邮政【EGPost】

易可成物流【EKC】

厄立特里亚邮政【ERPost】

西班牙邮政【ESPost】

eTotal快递【eTotal】

埃塞俄比亚邮政【ETPost】

俄通收中俄专线【ETSExpress】

Exelot【Exelot】

Fedex【Fedex】

芬兰邮政【FIPost】

斐济邮政【FJPost】

飞特物流【FlytExpress】

法罗群岛邮政【FOPost】

法国DPD【FRDPD】

法国邮政【FRPost】

加蓬邮政【GAPost】

GATI【GATI】

GATI-KWE【GATIKWE】

格林纳达邮政【GDPost】

GDSK【GDSK】

格鲁吉亚邮政【GEPost】

根西岛邮政【GGPost】

加纳邮政【GHPost】

直布罗陀邮政【GIPost】

菜鸟网络全球物流【GlobalCainiao】

格陵兰邮政【GLPost】

GLS【GLS】

GLSFrance【GLSFR】

GLSItaly【GLSIT】

冈比亚邮政【GMPost】

希腊邮政【GRPost】

危地马拉邮政【GTPost】

光驰物流【GuangChi】

圭亚那邮政【GYPost】

Hermes【Hermes】

恒捷宇通【HJYT】

AsendiaHK【HKAsendia】

香港DPD【HKDPD】

香港邮政【HKPost】

洪都拉斯邮政【HNPost】

克罗地亚邮政【HRPost】

海地邮政【HTPost】

匈牙利邮政【HUPost】

瀚轩国际物流【HXGJExpress】

印尼邮政【IDPost】

爱尔兰DPD【IEDPD】

爱尔兰邮政【IEPost】

以色列邮政【ILPost】

iMile【iMile】

IML【IML】

印度邮政【INPost】

伊拉克邮政【IQPost】

伊朗邮政【IRPost】

冰岛邮政【ISPost】

意大利邮政【ITPost】

意大利SDA【ITSDA】

佳成国际物流【JCEX】

JDLogistics【JD】

泽西岛邮政【JEPost】

京东印尼物流【JExpress】

牙买加邮政【JMPost】

JNE快递【JNE】

捷网国际物流【JNet】

约旦邮政【JOPost】

日本邮政【JPPost】

肯尼亚邮政【KEPost】

吉尔吉斯斯坦邮政【KGPost】

柬埔寨邮政【KHPost】

基里巴斯邮政【KIPost】

科摩罗邮政【KMPost】

朝鲜邮政【KPPost】

韩国邮政【KRPost】

科威特邮政【KWPost】

开曼群岛邮政【KYPost】

哈萨克斯坦邮政【KZPost】

老挝邮政【LAPost】

LazadaeLogistics【LazadaELogistics】

黎巴嫩邮政【LBPost】

圣卢西亚邮政【LCPost】

列支敦士登邮政【LIPost】

利佳顺国际货运【LJS】

斯里兰卡邮政【LKPost】

LoneStarOvernight(LSO)【LSO】

立陶宛邮政【LTPost】

卢森堡邮政【LUPost】

拉脱维亚邮政【LVPost】

MailAmericas【MailAmericas】

摩洛哥邮政【MAPost】

摩尔多瓦邮政【MDPost】

Meest物流【Meest】

黑山邮政【MEPost】

马达加斯加邮政【MGPost】

马其顿邮政【MKPost】

缅甸邮政【MMPost】

蒙古邮政【MNPost】

MondialRelay【MondialRelay】

澳门邮政【MOPost】

马耳他邮政【MTPost】

毛里求斯邮政【MUPost】

马尔代夫邮政【MVPost】

马拉维邮政【MWPost】

墨西哥邮政【MXPost】

马来西亚邮政【MYPost】

莫桑比克邮政【MZPost】

纳米比亚邮政【NAPost】

新喀里多尼亚邮政【NCPost】

尼日尔邮政【NEPost】

尼日利亚邮政【NGPost】

尼加拉瓜邮政【NIPost】

荷兰邮政【NLPost】

挪威邮政【NOPost】

瑙鲁邮政【NRPost】

新西兰邮政【NZPost】

阿曼邮政【OMPost】

万欧国际【OneWorld】

橙联【OrangeConnex】

巴拿马邮政【PAPost】

英国Parcelforce【Parcelforce】

PCAExpress【PCAExpress】

秘鲁邮政【PEPost】

巴布亚新几内亚邮政【PGPost】

菲律宾邮政【PHPost】

巴基斯坦邮政【PKPost】

波兰DPD【PLDPD】

波兰邮政【PLPost】

PONY快递【PONY】

巴勒斯坦邮政【PSPost】

葡萄牙邮政【PTPost】

巴拉圭邮政【PYPost】

卡塔尔邮政【QAPost】

罗马尼亚DPD【RODPD】

罗马尼亚邮政【ROPost】

英国皇家邮政【RoyalMail】

塞尔维亚邮政【RSPost】

俄罗斯DPD【RUDPD】

俄罗斯邮政【RUPost】

卢旺达邮政【RWPost】

沙特阿拉伯邮政【SAPost】

塞舌尔邮政【SCPost】

DirectLink【SEDLPost】

瑞典邮政【SEPost】

三态速递【SFC】

顺丰速运【SFExpress】

新加坡邮政【SGPost】

中外运跨境电商物流【Sinoair】

斯洛文尼亚邮政【SIPost】

斯洛伐克邮政【SKPost】

塞拉利昂邮政【SLPost】

SMSA快递【SMSA】

塞内加尔邮政【SNPost】

索马里邮政【SOPost】

SpecialisedFreight【SpecialisedFreight】

俄罗斯联邦快递【SPSRExpress】

苏里南邮政【SRPost】

萨尔瓦多邮政【SVPost】

速邮达【SYD】

顺友物流【SYPost】

斯威士兰邮政【SZPost】

深圳市众汇易达【SZZHYD】

TaipeiForever【TaipeiForever】

多哥邮政【TGPost】

KerryExpressThailand【THKerryExpress】

泰国邮政【THPost】

塔吉克斯坦邮政【TJPost】

土库曼斯坦邮政【TMPost】

突尼斯邮政【TNPost】

TNT【TNT】

TOLL【TOLL】

汤加邮政【TOPost】

土耳其邮政【TRPost】

特立尼达和多巴哥邮政【TTPost】

台湾邮政【TWPost】

坦桑尼亚邮政【TZPost】

乌克兰EMS【UAEMSPost】

乌克兰邮政【UAPost】

利通物流【UBISmartParcel】

乌干达邮政【UGPost】

英国Asendia【UKAsendia】

DPD快递【UKDPD】

欣运优物流【UPost】

UPS【UPS】

AsendiaUSA【USAAsendia】

美国邮政USPS【USPS】

UVAN宇环通快递【UVAN】

乌拉圭邮政【UYPost】

乌兹别克斯坦邮政【UZPost】

委内瑞拉邮政【VEPost】

越南邮政【VNPost】

瓦努阿图邮政【VUPost】

万邑通【Winit】

Wish邮【WishPost】

萨摩亚邮政【WSPost】

科索沃邮政【XOPost】

燕文物流【YanWen】

英国Yodel【Yodel】

YRC【YRC】

圆通快递【YTO】

韵达快递【Yunda】

云途物流【Yunexpress】

南非Fastway【ZAFastway】

南非邮政【ZAPost】

上海翼速【ZCE】

俄顺国际物流【ZESExpress】

赞比亚邮政【ZMPost】

中通快递【ZTO】

津巴布韦邮政【ZWPost】

其他【Other】