注意

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

限额

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

代收API

代收申请

简要描述：

• 创建代收订单

URL：/pkr/collect/apply

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId	是	String	商户订单号(必须保证唯一性，长度不超过48)
name	是	String	收款人姓名
phone	是	String	真实手机号，非收银台模式需要真实真实手机号，用于接收验证码(OTP)支付，3开头，共10位
email	是	String	真实电子邮件
amount	是	String	交易金额
payType	是	String	交易类型
inBankCode	是	String	支付方式
callBackUrl	是	String	支付完成后跳转地址
notifyUrl	否	String	回调地址
subject	否	String	支付备注
body	否	String	备注详情
idCard	否	String	身份证号，HBL_KONNECT方式必需
partnerUserId	是	String	用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。 格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign	是	String	签名

返回data参数说明

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

代收查询

简要描述：

• 查询代收订单

URL：/pkr/collect/query

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务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钱包

代付API

代付申请

简要描述：

• 创建代付订单

URL：/pkr/pay/apply

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId	是	String	商户订单号(必须保证唯一性，长度不超过48)
amount	是	String	交易金额（精确到小数点后两位；禁止添加标点符号，例如：”,”）
accountType	是	String	账户类型：EWALLET（电子钱包） , BANK_ACCOUNT（银行）
bankCode	是	String	付款编码
accountNo	是	String	用户银行账号或钱包账号
name	是	String	收款人姓名
phone	是	String	真实手机号
email	是	String	真实电子邮件
notifyUrl	否	String	回调地址
subject	是	String	支付备注（交易标题，商品名称，支付原因）
body	否	String	备注详情
birth	是	String	出生年月日，格式：yyyy-MM-dd
gender	是	String	性别，可选值：MALE, FEMALE or OTHER
partnerUserId	是	String	用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。 格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign	是	String	签名

返回data参数说明

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

代付查询

简要描述：

• 查询代付订单

URL：/pkr/pay/query

参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务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