HaiPay

简体中文

English

简体中文

English

外观

菲律宾支付接口

2076字约7分钟

注意

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

限额

交易类型限额（单位：PHP）
代收50-50000
代付1-50000

代收API

代收申请

简要描述：

  • 创建代收订单

URL：/php/collect/apply 说明：appId 菲律宾比索， amount 菲律宾比索，实收结算菲律宾比索

参数：

参数名必选类型说明
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支付完成后跳转地址
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参数说明

参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
payUrlString支付链接
bankNoString还款卡号（VA）
bankCodeString通道Code(VA)
qrCodeString二维码内容-可自行生成二维码(QR)
signString签名

代收查询

简要描述：

  • 创建代付订单
  • 当“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参数说明

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

支付方式

二维码-支持菲律宾的所有钱包以及银行APP扫码支付

payTypeinBankCode限额说明是否可用
QRPH_QRPH_DYNAMIC（100-49999peso）动态码：已设置好金额，不需要手动输入，一次性还款二维码可用

原生网关orWebPay

payTypeinBankCode限额说明情况
PAYMENT_GATEWAYGCASH_URL50-50000GCash登录付款可用
PAYMENT_GATEWAYGRPY_URL50-50000GrabPay可用
PAYMENT_GATEWAYPAYMAYA_URL50-50000Paymaya Online可用
PAYMENT_GATEWAYGCASH_QR100-50000GCash QR唤醒可用

收银台模式

payTypeinBankCode说明情况
CASHIERCASHIER收银台可用

代付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参数说明

参数名必选类型
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
signString签名

代付查询

简要描述：

  • 创建代付订单

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参数说明

参数名类型说明
orderIdString商户订单号(必须保证唯一性)
orderNoString平台订单号
amountString交易金额
feeString手续费
statusInteger状态(0未开始，1支付中，2成功（终态），3失败（终态）, -1异常待确认)
payTimeString支付成功时间（当status=2时有值）(菲律宾时间), 格式: yyyy-MM-dd HH:mm:ss
errorMsgString支付失败原因（当status=3时有值）
signString签名

钱包编码和银行代码

钱包编码EWALLET（电子钱包）

bankCodebankName
GCASHgcash电子钱包渠道
COINScoins电子钱包渠道
PAYMAYApaymaya电子钱包渠道
GRABPAYgrabpay电子钱包渠道
SHOPEEshopeepay电子钱包渠道
OMNIPAYomnipay电子钱包渠道

银行代码BANK_ACCOUNT（银行卡）

bankCodebankName
ABPAllBank Inc.
ALIPAlipay Philippines Inc
AUBAsia United Bank
BDOBanco de Oro
BMBBangko Mabuhay
BOCBank Of Commerce
BPIBank of the Philippine Islands
BPIDBBPI Direct BanKO, Inc., A Savings Bank
BRBBinangonan Rural Bank (BRBDigital)
CBCChina Banking Corporation(China Bank)
CBSChina Bank Savings, Inc
CCICIS BAYAD CENTER INC
CEBRURCebuana Lhuillier Rural Bank, Inc.
CIMBCIMB Bank Philippines, Inc.
CMGCAMALIG BANK
CRBCOMMUNITY RURAL BANK OF ROMBLON, INC.(NetBank)
CRDCARD Bank
CSBCitystate Savings Bank
CSICARD SME BANK INC
CTBCCtbc Bank (Philippines) Corp.
DBIDungganon Bank
DBPDevelopment Bank of the Philippines
DCIDUMAGUETE CITY DEVELOPMENT BANK, INC.
DCPDCPay Philippines Inc.
DOPDEVT. BANK OF THE PHILIPPINES
EQBEquicom Savings Bank
EWBEast-West Banking Corporation
EWREast West Rural Bank (Green Bank)
GTBGoTyme Bank
IBIISLA Bank
INGING Bank N.V.
JPMJP Morgan Chase Bank, N.A.
LBPLand Bank of the Philippines
LSBLEGAZPI SAVINGS BANK INC
LULLULU FINANCIAL SERVICES (PHILS), INC.
MBPMaybank Philippines
MCCMINDANAO CONSOLIDATED COOPERATIVE
METMetrobank
MSBMalayan Bank
ONBOne Network Bank
OWNownbank
PAPPalawanPay
PARPartner Rural Bank(Cotabato) Inc.
PBBPhilippine Business Bank
PBCOMPhilippine Bank of Communications
PNBPhilippine National Bank
PNSPNB Savings Bank
PRBProducers Bank
PSBPhilippine Savings Bank
PTCPhilippine Trust Company
PVBPhilippine Veterans Bank
QCBQueen City Development Bank, Inc.
QRBQuezon Capital Rural Bank
RBGRURAL BANK OF GUINOBATAN, INC.
RCBCRizal Commercial Banking Corp. (RCBC)
RSBRobinsons Bank
RSBIRcbc Savings Bank Inc.
SBASterling Bank Of Asia
SBCSecurity Bank
SEBSEABANK PH
SPYStarpay Corporation
SSBSun Savings Bank
TSBTHE STANDARD CHARTERED BANK
TYCTayocash
UBPUnion Bank Of The Philippines
UCBSBUCBP Savings bank
UCPBUnited Coconut Planters Bank (UCPB)
USSUSSC Money Services
WDBWealth Development Bank
YUANSBYuanta Savings Bank
ZTIZYBI TECH, INC.

Theme by cotmier

Copyright © 2019-2025 HaiPay | MIT License