巴基斯坦接口

2848字约9分钟

注意

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

限额

交易类型	限额(单位:PKR)
代收	10-500000
代付	10-100000

代收API

代收申请

简要描述：

创建代收订单

URL：/pkr/collect/apply 说明：appId需使用巴基斯坦卢比对应的，用户支付成功后增加巴基斯坦卢比余额

参数：

参数名	必选	类型	说明
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	用户支付成功后跳转地址
callBackFailUrl	是	String	用户支付失败后跳转地址
notifyUrl	否	String	回调地址
subject	否	String	支付备注
body	否	String	备注详情
idCard	否	String	身份证号，HBL_KONNECT、JAZZCASH方式必需
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)	限额	状态	说明
PKR	PAYMENT_GATEWAY	CASHIER	10-500000	可用	收银台模式
PKR	EWALLET	JAZZCASH	10-500000	可用	JazzCash钱包
PKR	EWALLET	EASYPAISA	10-500000	可用	EasyPaisa钱包
PKR	EWALLET	ALFA	10-500000	维护	ALFA钱包
PKR	EWALLET	HBL_KONNECT	10-500000	维护	HBL KONNECT钱包

代付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
idCard	否	String	身份证号，JAZZCASH方式必需
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	签名

支付方式

币种	支付类型(accountType)	支付编码(bankCode)	限额	状态	说明
PKR	EWALLET	ALFA	10-100000	可用	ALFA钱包
PKR	EWALLET	BAFL	10-100000	可用	Bank Alfalah Limited
PKR	EWALLET	EASYPAISA	10-100000	可用	EasyPaisa钱包
PKR	EWALLET	JAZZCASH	10-100000	可用	JazzCash钱包
PKR	EWALLET	HBL_KONNECT	10-100000	可用	HBL KONNECT钱包
PKR	BANK_ACCOUNT	ABBL	10-100000	可用	Al Baraka Bank Limited
PKR	BANK_ACCOUNT	ABHI	10-100000	可用	Abhi Finance
PKR	BANK_ACCOUNT	ABL	10-100000	可用	Allied Bank Limited
PKR	BANK_ACCOUNT	ACBL	10-100000	可用	Askari Commercial Bank
PKR	BANK_ACCOUNT	ADVANS	10-100000	可用	Advans Pakistan
PKR	BANK_ACCOUNT	APNA	10-100000	可用	Apna Microfinance Bank
PKR	BANK_ACCOUNT	BAHL	10-100000	可用	Bank AL Habib Limited
PKR	BANK_ACCOUNT	BARWAQT	10-100000	可用	Barwaqt
PKR	BANK_ACCOUNT	BIPL	10-100000	可用	BankIslami Pakistan
PKR	BANK_ACCOUNT	BOK	10-100000	可用	Bank of Khyber
PKR	BANK_ACCOUNT	BOP	10-100000	可用	Bank of Punjab
PKR	BANK_ACCOUNT	BYKEA	10-100000	可用	BYKEA
PKR	BANK_ACCOUNT	CDNS	10-100000	可用	CDNS
PKR	BANK_ACCOUNT	CITI	10-100000	可用	Citi Bank
PKR	BANK_ACCOUNT	DIBPL	10-100000	可用	Dubai Islamic Bank
PKR	BANK_ACCOUNT	FAYSAL	10-100000	可用	Faysal Bank Limited
PKR	BANK_ACCOUNT	FINCA	10-100000	可用	FINCA Microfinance Bank
PKR	BANK_ACCOUNT	FINJA	10-100000	可用	FINJA EMI
PKR	BANK_ACCOUNT	FMB	10-100000	可用	First Microfinance Bank
PKR	BANK_ACCOUNT	FWBL	10-100000	可用	First Women Bank Limited
PKR	BANK_ACCOUNT	HBL	10-100000	可用	Habib Bank Limited
PKR	BANK_ACCOUNT	HBLASSET	10-100000	可用	HBL ASSET MANAGEMENT
PKR	BANK_ACCOUNT	HMBL	10-100000	可用	Habib Metropolitan Bank
PKR	BANK_ACCOUNT	ICBC	10-100000	可用	ICBC
PKR	BANK_ACCOUNT	JSB	10-100000	可用	JS Bank
PKR	BANK_ACCOUNT	KHUSHALI	10-100000	可用	Khushali Bank
PKR	BANK_ACCOUNT	MCB	10-100000	可用	MCB Bank Limited
PKR	BANK_ACCOUNT	MCBARIF	10-100000	可用	MCB ARIF HABIB
PKR	BANK_ACCOUNT	MCIB	10-100000	可用	MCB Islamic Banking
PKR	BANK_ACCOUNT	MEEZAN	10-100000	可用	Meezan Bank Limited
PKR	BANK_ACCOUNT	MOD	10-100000	可用	MOD
PKR	BANK_ACCOUNT	NAYAPAY	10-100000	可用	NayaPay Private Limited
PKR	BANK_ACCOUNT	NBP	10-100000	可用	National Bank of Pakistan
PKR	BANK_ACCOUNT	NBPF	10-100000	可用	NBP Funds
PKR	BANK_ACCOUNT	NRSP	10-100000	可用	NRSP Microfinance
PKR	BANK_ACCOUNT	PAYMAX	10-100000	可用	PayMax (Zong)
PKR	BANK_ACCOUNT	SADAPAY	10-100000	可用	SadaPay
PKR	BANK_ACCOUNT	SAMBA	10-100000	可用	SAMBA
PKR	BANK_ACCOUNT	SCB	10-100000	可用	Standard Chartered Bank
PKR	BANK_ACCOUNT	SILK	10-100000	可用	Silk Bank
PKR	BANK_ACCOUNT	SIMPAISA	10-100000	可用	SimPaisa
PKR	BANK_ACCOUNT	SINDH	10-100000	可用	Sindh Bank
PKR	BANK_ACCOUNT	SME	10-100000	可用	SME Bank Limited
PKR	BANK_ACCOUNT	SONERI	10-100000	可用	Soneri Bank Limited
PKR	BANK_ACCOUNT	SUMMIT	10-100000	可用	Summit Bank
PKR	BANK_ACCOUNT	UBANK	10-100000	可用	Ubank
PKR	BANK_ACCOUNT	UBL	10-100000	可用	United Bank Limited
PKR	BANK_ACCOUNT	WHITE	10-100000	可用	WHITE LABEL ATM
PKR	BANK_ACCOUNT	ZARAI	10-100000	可用	Zarai Taraqiati Bank