注意

阅读该接口文档前，务必先查看 接口说明

限额

交易类型	限额(单位:PKR)
代收	额度上限主要取决于用户的账户

代付API

代付申请

简要描述：

• 创建代付订单

URL：/pkr/pay/apply

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取）
orderId	是	String	商户订单号(必须保证唯一性)
amount	是	String	交易金额（精确到小数点后两位；禁止添加标点符号，例如：”,”）
accountType	是	String	账户类型：EWALLET（电子钱包） , BANK_ACCOUNT（银行）
bankCode	是	String	付款编码
accountNo	是	String	用户银行账号或钱包账号
name	是	String	收款人姓名
phone	是	String	手机号
email	是	String	电子邮件
subject	否	String	支付备注（交易标题，商品名称，支付原因）
body	否	String	备注详情
birth	是	String	出生年月日，格式：yyyy-MM-dd
gender	是	String	性别，参考值：MALE, FEMALE or OTHER
sign	是	String	签名

返回data参数说明

参数名	必选	类型
orderId	String	商户订单号(必须保证唯一性)
orderNo	String	平台订单号
sign	String	签名

代付查询

简要描述：

• 查询代付订单

URL：/pkr/pay/query

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取）
orderId	是	String	商户订单号
orderNo	否	String	平台订单号（响应快）
sign	是	String	签名

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号(必须保证唯一性)
orderNo	String	平台订单号
amount	String	交易金额
fee	String	手续费
status	Integer	状态(0未开始，1支付中，2成功（终态），3失败（终态）, -1异常待确认)
payTime	String	支付成功时间（当status=2时有值）(巴基斯坦时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsg	String	支付失败原因（当status=3时有值）
sign	String	签名

付款编码

银行编码

bankCode	bankName
ABBL	Al Baraka Bank Limited
ABHI	Abhi Finance
ABL	Allied Bank Limited
ACBL	Askari Commercial Bank
ADVANS	Advans Pakistan
APNA	Apna Microfinance Bank
BAHL	Bank AL Habib Limited
BARWAQT	Barwaqt
BIPL	BankIslami Pakistan
BOK	Bank of Khyber
BOP	Bank of Punjab
BYKEA	BYKEA
CDNS	CDNS
CITI	Citi Bank
DIBPL	Dubai Islamic Bank
FAYSAL	Faysal Bank Limited
FINCA	FINCA Microfinance Bank
FINJA	FINJA EMI
FMB	First Microfinance Bank
FWBL	First Women Bank Limited
HBL	Habib Bank Limited
HBLASSET	HBL ASSET MANAGEMENT
HMBL	Habib Metropolitan Bank
ICBC	ICBC
JSB	JS Bank
KHUSHALI	Khushali Bank
MCB	MCB Bank Limited
MCBARIF	MCB ARIF HABIB
MCIB	MCB Islamic Banking
MEEZAN	Meezan Bank Limited
MOD	MOD
NAYAPAY	NayaPay Private Limited
NBP	National Bank of Pakistan
NBPF	NBP Funds
NRSP	NRSP Microfinance
PAYMAX	PayMax (Zong)
SADAPAY	SadaPay
SAMBA	SAMBA
SCB	Standard Chartered Bank
SILK	Silk Bank
SIMPAISA	SimPaisa
SINDH	Sindh Bank
SME	SME Bank Limited
SONERI	Soneri Bank Limited
SUMMIT	Summit Bank
UBANK	Ubank
UBL	United Bank Limited
WHITE	WHITE LABEL ATM
ZARAI	Zarai Taraqiati Bank

钱包编码

bankCode	bankName
ALFA	ALFA Wallet
BAFL	Bank Alfalah Limited
EASYPAISA	Telenor Microfinance Bank
JAZZCASH	Mobilink Microfinance
HBL_KONNECT	HBL Konnect Wallet

代收API

代收申请

简要描述：

• 创建代收订单

URL：/pkr/collect/apply

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取）
orderId	是	String	商户订单号(必须保证唯一性)
name	是	String	收款人姓名
phone	是	String	手机号，需要真实手机号，用于接收验证码(OPT)支付
email	是	String	电子邮件
amount	是	String	交易金额
payType	是	String	交易类型
inBankCode	是	String	支付方式
callBackUrl	是	String	支付完成后跳转地址
subject	否	String	支付备注
body	否	String	备注详情
sign	是	String	签名

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号(必须保证唯一性)
orderNo	String	平台订单号
payUrl	String	支付链接
qrCode	String	二维码内容-可自行生成二维码(QR)
sign	String	签名

代收查询

简要描述：

• 查询代收订单

URL：/pkr/collect/query

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取）
orderId	是	String	商户订单号
orderNo	否	String	平台订单号（响应快）
sign	是	String	签名

返回data参数说明

参数名	类型	说明
orderId	String	商户订单号(必须保证唯一性)
orderNo	String	平台订单号
amount	String	交易金额
actualAmount	String	收到金额
fee	String	手续费
status	Integer	状态(0未开始，1支付中，2成功（终态），3失败（终态）, -1异常待确认)
payTime	String	支付成功时间（当status=2时有值）(巴基斯坦时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsg	String	失败原因（当status=3时有值）
sign	String	签名

支付方式

payType	inBankcode	说明
PAYMENT_GATEWAY	CASHIER	收银台模式
EWALLET	ALFA	ALFA钱包
EWALLET	HBL_KONNECT	HBL KONNECT钱包
EWALLET	JAZZCASH	JAZZCASH钱包
EWALLET	EASYPAISA	EASYPAISA钱包

privateKey

secreteKey

url

Request Sample: