附录

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

银行代码为八位数字

I0061

商户订单号重复

I0062

流水订单号重复

I0067

注意最多只能输入500个字符

 

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

退款申请成功

Refunded

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

98

无此交易

No transaction record on file

99

申请退款发生异常

System error

 

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

错误代码

描述

英文描述

00

调用接口成功

Interface call success

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;
}