菲律宾支付接口

1586字约5分钟

注意

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

限额

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

账户余额查询

URL：/common/openapi/account/balance

param 参数：

参数名	必选	固定值	说明
country	是	PHL	国家编码
currency	是	PHP	币种

request

{
    "param": {
        "country": "PHL",
        "currency": "PHP",
    },
    "sign": "Gw6D0kuWlnngLMiSxQQ2Dz2ciZz4LUZ7gWA8dRkEbcsE+UoiTOy6T3g6vNvGUlz+vPV2aRHKZ6aPBh0PaJkWW36T/lf8qId4D9uh8lFeTe7zW0+hTgTnN9YmruA6rlRNCo9QytbMRk6qkEZh1PZ2NrFnC77FhYVEVdOk6bIOv/vnGo1RVpbmsO+Gw+tPnvkQ1jvVDEHUlKgnAFGYa7+oWw8eClh9T4Ob7ZUPI0Z+dhefAmEX+z8DCyUxZrtbgA0li21KW2TmErIiRJQxep/f4quWRoTKkPziiMefKo1jFgbyL/gVzgkp91YaMMyk1QJKW1UoZ8iqHKNMI6pmvBCk8g=="

}

response

{
    "code": 200,
    "message": "",
    "data": {
        "merId": "",
        "merName": "",
        "currency": "",
        "amountTotal": "0.00",
        "freeAmount": "1085178690.00",
        "unrecordedAmount": "0.00",
        "freezeAmount": "1085178690.00",
        "frzBal": "0.00",
        "sign": "签名"
    }
}

返回data参数说明

参数名	类型	说明
merId	string	商户号
merName	string	商户名称
currency	string	币种
amountTotal	BigDecimal	总金额
freeAmount	BigDecimal	可用金额
unrecordedAmount	BigDecimal	在途金额
freezeAmount	BigDecimal	冻结金额
sign	string	签名

代付接口

代付下单

URL：/phl/openapi/disbursement/transfer

param参数：

参数名	必选	类型	说明
amount	是	number	代付金额必填，支持两位小数(单位元) (小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
cardNumber	是	string	收款人账号，电子钱包传真实手机号，银行传银行卡号(真实手机号09开头,11位数)
chanelNo	是	string	通道编码
currency	是	string	币种(PHP)
customerName	是	string	收款人姓名
merchantOrderNo	是	string	商户订单id，格式：字母+数字, 1-32位
method	是	string	代付类型:1-银行渠道,2-钱包渠道)
notifyUrl	是	string	回调地址
remark	否	string	代付备注
timestamp	是	integer	交易时间戳
transferCode	是	string	收款渠道编码,目前支持所有渠道

request

{
    "param": {
        "amount": 0,
        "cardNumber": "",
        "chanelNo": "",
        "currency": "",
        "customerName": "",
        "merchantOrderNo": "",
        "method": "",
        "notifyUrl": "",
        "remark": "",
        "timestamp": 0,
        "transferCode": ""
    },
    "sign": ""
}

response

{
    "code": 0,
    "data": {
        "merchantOrderNo": "",
        "plaOrderNo": 0,
        "sign": "",
        "status": "",
        "timestamp": 0
    },
    "message": ""
}

返回data参数说明

参数名	类型	说明
merchantOrderNo	string	商户订单号
plaOrderNo	long	平台订单号
sign	string	验签
status	string	支付状态
timestamp	long	交易时间戳(毫秒时间戳)

银行编码(代付)

bankCode	bankName
ABP	AllBank Inc.
AUB	Asia United Bank
BDO	Banco de Oro
BMB	Bangko Mabuhay
BOC	Bank Of Commerce
BPIDB	BPI Direct BanKO, Inc., A Savings Bank
BPI	Bank of the Philippine Islands
BRB	Binangonan Rural Bank (BRBDigital)
CBC	China Banking Corporation(China Bank)
CBS	China Bank Savings, Inc
CMG	CAMALIG BANK
CTBC	Ctbc Bank (Philippines) Corp.
DBI	Dungganon Bank
DBP	Development Bank of the Philippines
EQB	Equicom Savings Bank
EWB	East-West Banking Corporation
EWR	East West Rural Bank (Green Bank)
IBI	ISLA Bank
ING	ING Bank N.V.
JPM	JP Morgan Chase Bank, N.A.
LBP	Land Bank of the Philippines
MET	Metrobank
MSB	Malayan Bank
ONB	One Network Bank
PAR	Partner Rural Bank(Cotabato) Inc.
PBB	Philippine Business Bank
PNB	Philippine National Bank
PRB	Producers Bank
PTC	Philippine Trust Company
PVB	Philippine Veterans Bank
QCB	Queen City Development Bank, Inc.
QRB	Quezon Capital Rural Bank
RCBC	Rizal Commercial Banking Corp. (RCBC)
RBG	RURAL BANK OF GUINOBATAN, INC.
RSBI	Rcbc Savings Bank Inc.
RSB	Robinsons Bank
SBA	Sterling Bank Of Asia
SBC	Security Bank
SPY	Starpay Corporation
SSB	Sun Savings Bank
UBP	Union Bank Of The Philippines
UCPB	United Coconut Planters Bank (UCPB)
WDB	Wealth Development Bank
YUANSB	Yuanta Savings Bank
CIMB	CIMB Bank Philippines Inc
GOTYME	GoTymeBank
SEAB	SeaBank Philippines

钱包编码(代付)

bankCode	bankName
GCASH	gcash电子钱包渠道
GRABPAY	grabpay电子钱包渠道
OMNIPAY	omnipay电子钱包渠道
PAYMAYA	paymaya电子钱包渠道

代收接口

支付视频

PH_GCASH_URL:

PH_QRPH_DYNAMIC:

收款

URL：/phl/openapi/payment/generate

param参数：

参数名	必选	类型	说明
amount	是	number	订单金额必填，支持两位小数 (小数点后尾数不带0, 例如: 禁止传输 123.40, 应传: 123.4)
cardNumber	否	string	用户付款卡号(真实)使用网银转账时必传
chanelNo	是	string	平台通道编码（固定：608259）
channelCode	是	string	收单渠道编码
currency	是	string	币种
customerName	是	string	收款人姓名（付款人姓名格式:英文大小写且允许有空格,1-30位,"firstName middleName lastName" (middleName非必填,特殊字符支持!-)
email	是	string	付款人邮箱
merchantOrderNo	是	string	商户订单号
mobile	是	string	付款人手机(真实手机号09开头11位)
notifyUrl	是	string	回调地址
redirectUrl	是	string	商户重定向地址
remark	否	string	代付备注
timestamp	是	integer	秒交易时间戳

request

{
    "param": {
        "amount": 0,
        "cardNumber": "",
        "chanelNo": "",
        "channelCode": "",
        "currency": "",
        "customerName": "",
        "email": "",
        "merchantOrderNo": "",
        "mobile": "",
        "notifyUrl": "",
        "redirectUrl": "",
        "remark": "",
        "timestamp": 0
    },
    "sign": ""
}

response

{
    "code": 0,
    "data": {
        "merchantOrderNo": "",
        "payData": "",
        "plaOrderNo": 0,
        "sign": "",
        "status": "",
               "payUrl": "",
        "timestamp": 0
    },
    "message": ""
}

返回data参数说明

参数名	类型	说明
merchantOrderNo	string	商户订单号
payData	string	支付信息(QR内容)
plaOrderNo	long	平台订单号
sign	string	验签
status	string	支付状态
timestamp	long	交易时间戳
payUrl	string	支付链接

支付渠道

渠道编码channelCode	支付渠道描述
PH_PAYMAYA_URL	paymaya登录付款（金额100起步）
PH_QRPH_DYNAMIC	动态码
PH_GCASH_URL	GCASH登录付款
PH_GRABPAY_URL	grab登录付款

交易状态查询

URL：/phl/openapi/orderStatus

param参数：

参数名	必选	类型	说明
merchantOrderNo	是	String	商户单号
plaOrderNo	是	String	平台订单号

request

{
    "param": {
        "plaOrderNo": "1223050839733260230"
    },
    "sign": "111"
}

response — 订单成功

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "amount": "50000",
        "merchantOrderNo": "5825683320230508569",
        "merchantPayTime": "2023-05-08 11:13:21",
        "plaOrderNo": "1223050839733260230",
        "plaStatusTime": "2023-05-08 11:13:41",
        "status": "COMPLETED",
        "sign": "sadnmfasdnmz"
    }
}

返回data参数说明

参数名	类型	说明
amount	string	订单金额
merchantOrderNo	string	商户订单id，格式：字母+数字, 1-32位
merchantPayTime	string	商户交易时间
plaOrderNo	long	平台订单号
plaStatusTime	string	平台订单状态流转时间
sign	string	验签
status	string	支付状态

订单回调通知

URL：系统交易完成或余额不足时会发送回调到notify_url回调通知地址

响应：接受请求后请返回“success”字符串给我们

请求方式：

method: POST
Content Type: application/json

body参数：

参数名	类型	说明
amount	string	订单金额
merchantNo	string	商户号(gcash代收时有值)
merchantOrderNo	string	商户订单id，格式：字母+数字, 1-32位
merchantPayTime	string	商户交易时间
plaOrderNo	integer(int64)	平台订单号(gcash代收时为string类型)
plaStatusTime	string	平台订单状态流转时间
sign	string	验签
status	string	支付状态
statusValue	string	支付状态描述(paymaya,PHQR和代付回调时有值)
fee	string	手续费
code	string	状态码(代付回调有值)
message	string	提示语(代付回调有值)
errorCode	int	状态码(gcash代收，状态失败回调时有值)
errorMessage	string	提示语(gcash代收，状态失败回调时有值)

request

{
    "amount": 0,
    "merchantOrderNo": "",
    "merchantPayTime": "",
    "plaOrderNo": 0,
    "plaStatusTime": "",
    "sign": "",
    "status": "",
       "fee": "",
    "code": 0,
    "message": ""
}