菲律宾支付接口

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

限额

交易类型	限额(单位：PHP)
代收	100-50000
代付	1-50000

代收API

代收申请

简要描述：

创建代收订单

URL：/php/collect/apply 说明：appId需使用菲律宾比索对应的，用户支付成功后增加菲律宾比索余额 参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId	是	String	商户订单号(必须保证唯一性，长度不超过48)
name	是	String	收款人姓名(收款人姓名格式:英文大小写且允许有空格,1-30位,“firstName middleName lastName” (middleName非必填,特殊字符支持!-)
phone	是	String	真实手机号(格式：09 开头，纯数字, 共11位)，，符合格式即可
email	是	String	真实电子邮件
amount	是	String	交易金额(单位：₱，精确到小数点后两位；禁止添加标点符号，例如：”,”）范围:50-49999
payType	是	String	交易类型
inBankCode	是	String	支付方式
callBackUrl	是	String	用户支付成功后跳转地址
callBackFailUrl	是	String	用户支付失败后跳转地址
notifyUrl	否	String	回调地址
subject	否	String	支付备注
body	否	String	备注详情
partnerUserId	是	String	用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign	是	String	签名

request

{
  "appId": 1054,
  "orderId": "M233323000059",
  "amount": "300",
  "phone": "09230219312",
  "email": "23423@qq.com",
  "name": "test",
  "inBankCode": "PH_QRPH_DYNAMIC",
  "payType": "QR",
  "partnerUserId": "149597870",
  "sign": "af0gAHkUOyYHu9owQp8NJ4mPEeUW4vuJcjdxqLIzrVw8AvpLSjD1DXupReSG/CyuSkFRyiIvCp5u703AuGGmfgD2gKDH3Ywau41bAbG2jnHJ8mtjiSJ5iWUzanyd4Kr7d1+rETbzUl7/BkW3t0X8UUFdqpxwG8DPUjAwUKfplWDHV7koG51Ozexd80DCsmW6eWdouAZ1uNXGLYmV3ftE3BmfNRtuv1C5bfTJWrTEIOxbF6g2uYOFZTlIgrQgd7/2PsAYwQQXNz8Q8CYl4OxqCv4pXJxaLWPbR5tqZu9og5kn32C9aHW/NlU1y39vzz+4ef81yPAqUV9oHlSMSPrMmw=="
}

response

{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "orderId": "M233323000059",
    "orderNo": "6023071013539074",
    "payUrl": "https://a.api-uat.php.com/1L9zQS2",
    "bankCode": "GCASH_STATIC_VA",
    "bankNo": "PC0007I10000035",
    "qrCode": "00020101021228760011ph.ppmi.p2m0111OPDVPHM1XXX0315777148000000017041652948137245442930503001520460165303608540810000.php Of Mandalu62310010ph.allbank05062110000803***88310012ph.ppmi.qrph0111OPDVPHM1XXX63042763",
    "sign": "YEoA8Y2JzQFGVzwJSqmemm1Kfv/bfyIfCqv2dp7RNzT5B72AQvdD+nt2nR4sL1HWscvmNHyVt5ovAi7MMhy3ziih/sMph+wPx4YjH3W1h5DyBvSlWvaKfKrK5ViomZ0pPYWydwRHnnRnicxToHK9S6qtSy7Q73O0hdz4hJ9p41Th3ycBl2Q9SeqSZYSY1ohcPDhdyRf2y0prb8rHgpBKzxZ5BKX/1bsE9OmsSEHAEYT8OGgko6aNe8XPAhr4G48cpWTftvnGQuzh0O65nuZRI/PF+Axt2zJCVbFHDDSREI9NlAT82ebDqhlVdxQzKE67D1nxgjb3dPmDUYHOBpmwxQ=="
  }
}

返回data参数说明

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

代收查询

简要描述：

创建代付订单
当“payType=PAYMENT_GATEWAY” 时同步返回orderNo可以直接查询
其他支付方式异步通知后，通过orderNo查询二次确认状态

URL：/php/collect/query 参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId	是	String	商户订单号
orderNo	否	String	平台订单号（响应快）
sign	是	String	签名

request

{
  "appId": 1054,
  "orderId": "M22222000028",
  "sign": "EmyJGm3ELzG4FsOd0Krs9ncbSjo4oTGuXWML+7djYla3+VAwd9wS17z38p/7U2ZAjroO04XrE7YXcB1o76Dtyipj3h3bJzs7FYma1QNkMUdt9hh7m8U6hMsMQX7vIWHtXNwz4pbTSC75+kQWXaCew7KoE6LXECdJU8AISgNgeki2TK9R0pCfshr0Z2SZBPeuT6OvIH5LdmqgdZhuqnffGU2qnXk4KMkO848e6/WALLBR+LE1wyKHfPnYVcuKSMVYxkvKyyIL5JIPEgW0o5bh4RCbaUn3NZtyYwrU1uQ3ZDFRThm9j6XAQP+LBlmq3nOePqBtp/VDVarRaV+7FbQg3A=="
}

response

{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "orderId": "M22222000028",
    "orderNo": "6023042811314347",
    "amount": "50000.00",
    "actualAmount": "0.00",
    "fee": "0.00",
    "status": 1,
    "sign": "fP433ygWVDLVGxYkVnIJj7riGq0U3vyVX+MbBAImxfGLZkZcEAHVEoVYuULZSmXAAXKRSyd67WlDNm+24pougM54ofAoH4HMtCL2tfCoBReFyz3z02AGKkrKE2xWhSpWoqfQoBvzwuN5iGMMu0s9Q1YvqiwJ8WDVIENnmiIyD8qDJN7caHTW2US14/faG+69AvnuIgJ/nu7/jogOlgEYdZdVYU7gcRDE+d47KjlFGswQkJ/h/uzV7cWtUqrtOO7ZnZ3/z33Xx8awokX36QoYcPSWAU0h+Ij9O9402HNhm1eTbYcLU0uI/z8xCAtyAI/tTyiFijpiNlxUKQj+zKsILw=="
  }
}

返回data参数说明

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

支付方式

币种	支付类型(payType)	支付编码(inBankCode)	限额	状态	说明
PHP	QR	PH_QRPH_DYNAMIC	100-50000	可用	QRPH动态码
PHP	PAYMENT_GATEWAY	GCASH_QR	100-50000	可用	Gcash钱包(唤醒)
PHP	PAYMENT_GATEWAY	GCASH_URL	100-50000	可用	Gcash钱包(直连)
PHP	PAYMENT_GATEWAY	GRPY_URL	100-50000	可用	GrabPay钱包
PHP	PAYMENT_GATEWAY	PAYMAYA_URL	100-50000	可用	PayMaya钱包

代付API

代付申请

简要描述：

创建代付订单

URL：/php/pay/apply 参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId	是	String	商户订单号(必须保证唯一性，长度不超过48)
amount	是	String	交易金额（单位：₱，精确到小数点后两位；禁止添加标点符号，例如：”,”）
accountType	是	String	账户类型：EWALLET（电子钱包） , BANK_ACCOUNT（银行）
bankCode	是	String	钱包编码和银行代码
accountNo	是	String	用户银行/钱包账号
name	是	String	收款人姓名(收款人姓名格式：英文大小写且允许有空格，1-30位,“firstName middleName lastName” (middleName 非必填, 特殊字符支持 ’.-))
phone	是	String	真实手机号（格式：09 开头，纯数字, 共11位）
email	是	String	真实电子邮件
notifyUrl	否	String	回调地址
subject	否	String	支付备注（交易标题，商品名称，支付原因）
body	否	String	备注详情
partnerUserId	是	String	用户唯一标识（如用户ID userId），用于风控系统，必须真实有效，否则会影响交易。格式要求：数字、大小写字母或常用符号-~!@#$%&*()_。
sign	是	String	签名

request（accountType为BANK_ACCOUNT类型时）

{
  "appId": 1054,
  "orderId": "M100000450012",
  "amount": "500",
  "accountType": "BANK_ACCOUNT",
  "bankCode": "BDO",
  "accountNo": "09876543210",
  "name": "john doe",
  "phone": "09876543210",
  "email": "johndoe@cashfree.com",
  "subject": "iphone13",
  "body": "ProMotion technology with adaptive refresh rates up to 120Hz",
  "partnerUserId": "149597870",
  "sign": "I1PeK3eJOVsFFNowxVRqMXpeWm1lr/BcRpBi8WsW4wVo1+5CC3JsrFq/m/L2O69NzKHvtDWi4zia3DL3dPut0yMyUyqL91LNCSaeISbGsQPlhEsQpyTOryS/RKOfsrn2Xo37SCF/phAvndOk2jwwGwqM5xLz1ms9Ukl85wv27QFNrXIMxK2p18oe7MpMYrgf+xvEBE/VqCtKMtN9pO449wWwXzHWNPbZ76s4pAvKwRE9yXQDr7Iw14Dktcnl1FoLM4gWM/obkO+mz6SyAGDuXhVh/+OD/IGNiCyTCNq6ciQY28UnCFV6ZIP40gxsFhfBJKbK+Raw7y1Bh912ifYfug=="
}

response

{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "orderId": "M100000450013",
    "orderNo": "3023062014149637",
    "sign": "LmhUnkw5j0pMiimsG8rKwdNNZGvXH5MpSmD6mdHZwq1SQwuK5BohmdEoqKB/jkMk28o3da4Cxh6Q+tW97+yTCemRrF+dMaHA73rpOeUuujKQl/UcFvJuMhfLBa2tp09L71NzoBqpPD6aXf37mYAz8E1HmERwFPpac5FVxIYanHG8cqmMLJYsVmHTSxWavgWU03ys9UczBePkBiR8sl2FSOhFABB0wAP28lswrV/ABS68IsLKtyd1fyI3GBfSbIK5nDEEnlE+EdElFdLs9taAxJImeVF1x4eT47+bkPJ2qS8z3K8QGzKLF3W+8SiRZGfSwDTsLKH+2Vycvy5auRl+ag=="
  }
}

返回data参数说明

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

代付查询

简要描述：

创建代付订单

URL：/php/pay/query 参数：

参数名	必选	类型	说明
appId	是	Long	业务ID（后台获取，需要根据URL中的币种传递对应的业务ID）
orderId	是	String	商户订单号
orderNo	否	String	平台订单号（响应快）
sign	是	String	签名

request

{
  "appId": 1000,
  "orderId": "M1234567111",
  "orderNo": "3022111516571436",
  "sign": "ZxkVZL+GAyv0VhvWn4IvuYahTzxgQuthkuV2ONWiqIfIDb2avvHlFOUJVzqZi1q8CPHXZm1ltanRTRVTxfsuftLvGeDioUHglWt46/RU6c1OPznpLGsZ35Q3n5tW2y1EnOsxPynXBFLuDQy+aZ3l9u6AQ30T0zQexMGT+IxuFkmUp02g/6juaHa5ZgNMv7lN67ixIp162wrM7OJuaOif872QijSceRdZhzaMGImAwB0D4MosRV4WMBOKkwgPdmS7GuZN66YUidXk3wTGqX3MYRw6M0kj4eNegSUwPXvp4q4p0KO8Y3xUMld54GY2ApX3WN3CBtC/vpJqEszjGBbbGg=="
}

response — 订单失败

{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "orderId": "M1234567111",
    "orderNo": "3022111516571436",
    "amount": "100000.00",
    "fee": "0.00",
    "status": 3,
    "errorMsg": "Đơn hàng không tồn tại",
    "sign": "KKuvCl0SuNANJs+l2ogDaJm8pmV+Hi+Xa7q27vJ6D1Ehs4aOp13kRbITfJAhczh3T81BE9qwHeJaYwf+r0EypKM9TL6pMwfG8Az4gRy1D57wiUaVjl2PWcvbEqrn1hL0b+btkjvAM9I+CcSv+wuOW3/uku17Ws3FhgJLj9sFsQUBAPjDO+758VnwBytCOLBmljLBXyKgNgpmFQ1/DNkqWl0UNzyLK45Zw3yf5NiwhEFbvW0jlOWlfu/ql4hluISUQG573jEoFCBEnQLb2tQoRZj1QYNRCXPf5lbej0vzqbEwvR9h+ZOf255t1MocJkdIe463DTV5U3KZdVT87HMagw=="
  }
}

response — 订单成功

{
  "status": "1",
  "error": "00000000",
  "msg": "",
  "data": {
    "orderId": "M1234567112",
    "orderNo": "3022111517401574",
    "amount": "100000.00",
    "fee": "1003.00",
    "status": 2,
    "payTime": "2024-03-01 23:59:59",
    "sign": "khPtOmGq+cpKX0HFAI/lbP0dx4oVyNAnL5oLsdmhDJdASlQm0yg5I3o+MhImYggEsL6c2bo5fP29t54OZFqSdQDfIuNDvGbAMAr4mRBxc0hoHLkBLyyagfVPBLyQA1JY8XV3ZL4ySzQ3ZQnMCfrh2K39ueUuz6HpZ03Hj0KYijVRCXAZaio/L5jfLBT12QXmvIfAHa8s/k9flhK05ENHPep3zjj/MZGOEaX7jkEJLfjK0duypDCa61BRQjM+oePOdVsgleIl1Yf98UAxMDZ/A3912KFHEb+/jvmdnulNbiJFyuT1fEe+j2teUgw3vFsZAtwNWAgxhC7UO+N0Q5z4EA=="
  }
}

返回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	签名

支付方式

币种	支付类型(payType)	支付编码(inBankCode)	限额	状态	说明
PHP	EWALLET	GCASH	1-50000	可用	GCash Wallet
PHP	EWALLET	COINS	1-50000	可用	Coins Wallet
PHP	EWALLET	PAYMAYA	1-50000	可用	PayMaya Wallet
PHP	EWALLET	GRABPAY	1-50000	可用	GrabPay Wallet
PHP	EWALLET	SHOPEE	1-50000	可用	ShopeePay Wallet
PHP	EWALLET	OMNIPAY	1-50000	可用	OmniPay Wallet
PHP	BANK_ACCOUNT	ABP	1-50000	可用	AllBank Inc.
PHP	BANK_ACCOUNT	ALIP	1-50000	可用	Alipay Philippines Inc
PHP	BANK_ACCOUNT	AUB	1-50000	可用	Asia United Bank
PHP	BANK_ACCOUNT	BDO	1-50000	可用	Banco de Oro
PHP	BANK_ACCOUNT	BMB	1-50000	可用	Bangko Mabuhay
PHP	BANK_ACCOUNT	BOC	1-50000	可用	Bank Of Commerce
PHP	BANK_ACCOUNT	BPI	1-50000	可用	Bank of the Philippine Islands
PHP	BANK_ACCOUNT	BPIDB	1-50000	可用	BPI Direct BanKO, Inc., A Savings Bank
PHP	BANK_ACCOUNT	BRB	1-50000	可用	Binangonan Rural Bank (BRBDigital)
PHP	BANK_ACCOUNT	CBC	1-50000	可用	China Banking Corporation(China Bank)
PHP	BANK_ACCOUNT	CBS	1-50000	可用	China Bank Savings, Inc
PHP	BANK_ACCOUNT	CCI	1-50000	可用	CIS BAYAD CENTER INC
PHP	BANK_ACCOUNT	CEBRUR	1-50000	可用	Cebuana Lhuillier Rural Bank, Inc.
PHP	BANK_ACCOUNT	CIMB	1-50000	可用	CIMB Bank Philippines, Inc.
PHP	BANK_ACCOUNT	CMG	1-50000	可用	CAMALIG BANK
PHP	BANK_ACCOUNT	CRB	1-50000	可用	COMMUNITY RURAL BANK OF ROMBLON, INC
PHP	BANK_ACCOUNT	CRD	1-50000	可用	CARD Bank
PHP	BANK_ACCOUNT	CSB	1-50000	可用	Citystate Savings Bank
PHP	BANK_ACCOUNT	CSI	1-50000	可用	CARD SME BANK INC
PHP	BANK_ACCOUNT	CTBC	1-50000	可用	Ctbc Bank (Philippines) Corp.
PHP	BANK_ACCOUNT	DBI	1-50000	可用	Dungganon Bank
PHP	BANK_ACCOUNT	DBP	1-50000	可用	Development Bank of the Philippines
PHP	BANK_ACCOUNT	DCI	1-50000	可用	DUMAGUETE CITY DEVELOPMENT BANK, INC.
PHP	BANK_ACCOUNT	DCP	1-50000	可用	DCPay Philippines Inc.
PHP	BANK_ACCOUNT	DOP	1-50000	可用	DEVT. BANK OF THE PHILIPPINES
PHP	BANK_ACCOUNT	EQB	1-50000	可用	Equicom Savings Bank
PHP	BANK_ACCOUNT	EWB	1-50000	可用	East-West Banking Corporation
PHP	BANK_ACCOUNT	EWR	1-50000	可用	East West Rural Bank (Green Bank)
PHP	BANK_ACCOUNT	GTB	1-50000	可用	GoTyme Bank
PHP	BANK_ACCOUNT	IBI	1-50000	可用	ISLA Bank
PHP	BANK_ACCOUNT	ING	1-50000	可用	ING Bank N.V.
PHP	BANK_ACCOUNT	JPM	1-50000	可用	JP Morgan Chase Bank, N.A.
PHP	BANK_ACCOUNT	LBP	1-50000	可用	Land Bank of the Philippines
PHP	BANK_ACCOUNT	LSB	1-50000	可用	LEGAZPI SAVINGS BANK INC
PHP	BANK_ACCOUNT	LUL	1-50000	可用	LULU FINANCIAL SERVICES (PHILS), INC.
PHP	BANK_ACCOUNT	MBP	1-50000	可用	Maybank Philippines
PHP	BANK_ACCOUNT	MCC	1-50000	可用	MINDANAO CONSOLIDATED COOPERATIVE
PHP	BANK_ACCOUNT	MET	1-50000	可用	Metrobank
PHP	BANK_ACCOUNT	MSB	1-50000	可用	Malayan Bank
PHP	BANK_ACCOUNT	ONB	1-50000	可用	One Network Bank
PHP	BANK_ACCOUNT	OWN	1-50000	可用	ownbank
PHP	BANK_ACCOUNT	PAP	1-50000	可用	PalawanPay
PHP	BANK_ACCOUNT	PAR	1-50000	可用	Partner Rural Bank(Cotabato) Inc.
PHP	BANK_ACCOUNT	PBB	1-50000	可用	Philippine Business Bank
PHP	BANK_ACCOUNT	PBCOM	1-50000	可用	Philippine Bank of Communications
PHP	BANK_ACCOUNT	PNB	1-50000	可用	Philippine National Bank
PHP	BANK_ACCOUNT	PNS	1-50000	可用	PNB Savings Bank
PHP	BANK_ACCOUNT	PRB	1-50000	可用	Producers Bank
PHP	BANK_ACCOUNT	PSB	1-50000	可用	Philippine Savings Bank
PHP	BANK_ACCOUNT	PTC	1-50000	可用	Philippine Trust Company
PHP	BANK_ACCOUNT	PVB	1-50000	可用	Philippine Veterans Bank
PHP	BANK_ACCOUNT	QCB	1-50000	可用	Queen City Development Bank, Inc.
PHP	BANK_ACCOUNT	QRB	1-50000	可用	Quezon Capital Rural Bank
PHP	BANK_ACCOUNT	RBG	1-50000	可用	RURAL BANK OF GUINOBATAN, INC.
PHP	BANK_ACCOUNT	RCBC	1-50000	可用	Rizal Commercial Banking Corp. (RCBC)
PHP	BANK_ACCOUNT	RSB	1-50000	可用	Robinsons Bank
PHP	BANK_ACCOUNT	RSBI	1-50000	可用	Rcbc Savings Bank Inc.
PHP	BANK_ACCOUNT	SBA	1-50000	可用	Sterling Bank Of Asia
PHP	BANK_ACCOUNT	SBC	1-50000	可用	Security Bank
PHP	BANK_ACCOUNT	SEB	1-50000	可用	SEABANK PH
PHP	BANK_ACCOUNT	SPY	1-50000	可用	Starpay Corporation
PHP	BANK_ACCOUNT	SSB	1-50000	可用	Sun Savings Bank
PHP	BANK_ACCOUNT	TSB	1-50000	可用	THE STANDARD CHARTERED BANK
PHP	BANK_ACCOUNT	TYC	1-50000	可用	Tayocash
PHP	BANK_ACCOUNT	UBP	1-50000	可用	Union Bank Of The Philippines
PHP	BANK_ACCOUNT	UCBSB	1-50000	可用	UCBP Savings bank
PHP	BANK_ACCOUNT	UCPB	1-50000	可用	United Coconut Planters Bank (UCPB)
PHP	BANK_ACCOUNT	USS	1-50000	可用	USSC Money Services
PHP	BANK_ACCOUNT	WDB	1-50000	可用	Wealth Development Bank
PHP	BANK_ACCOUNT	YUANSB	1-50000	可用	Yuanta Savings Bank
PHP	BANK_ACCOUNT	ZTI	1-50000	可用	ZYBI TECH, INC.

快速开始

商户指南

公共支付

全球支付

统一支付

测试与上线

附录

商户QA

菲律宾支付接口

限额

代收API

代收申请

代收查询

支付方式

代付API

代付申请

代付查询

支付方式

快速开始

商户指南

公共支付

全球支付

统一支付

测试与上线

附录

商户QA

​限额

​代收API

​代收申请

​代收查询

​支付方式

​代付API

​代付申请

​代付查询

​支付方式

限额

代收API

代收申请

代收查询

支付方式

代付API

代付申请

代付查询

支付方式