8.2 查詢接口(notificationInquiry)
这支API是由SKYPAY提供,由合作伙伴发动请求進行查詢。提供日期区间及类型之查询,并返回日期及类型范围内「充值、结算、提现」之通知记录。
Input parameters
参数 | 类型 | 长度 | 必填 | 描述 |
---|---|---|---|---|
userName | string | 50 | 是 | 使用者名称 由SkyPay提供 Ex:"userName":"AppName@skypay" |
action | string | 50 | 是 | 调用行为 notificationInquiry(固定参数值) Ex:"action":"notificationInquiry" |
authentication | string | 255 | 是 | 验证密钥 Ex:"authentication":"E1234567-123C-1234-123F-A12345670" |
transctionDate | Date | 10 | 是 | 通知日期 开始 Ex:2023-06-18 |
transEndDate | Date | 10 | 是 | 通知日期 结束 Ex:2023-06-19 |
statementTypes | string[] | 是 | 通知类型: 1:打款帐户充值 2:收款结算转充值 3:帐户馀额互转 4:收款交易结算 5:收款帐户提现 6:打款帐户提现 |
Post data
{
: ,
: ,
: ,
: ,
:
}
Output parameters
参数 | 类型 | 描述 | |
---|---|---|---|
responseTime | DateTime | 50 | 回传时间 yyyy-MM-dd HH:mm:ss.SSSS |
responseCode | int | 4 | 回传代码 1000 |
responseDescription | string | 255 | Success |
notifications | string[] | 255 | 通知数组名 Array |
transctionDate | DateTime | 50 | 通知日期 Ex:2023-06-18 17:52:10 |
companyPrefix | string | 5 | 公司编码 Ex:SKY98 |
companyName | string | 200 | 公司名称 Ex:Skybridge Payment Inc. |
accountNo | string | 5 | 帐户 Ex:SKY98 |
sourceAccountNo | string | 20 | 资金来源帐号 (实际银行帐号,只在提现时提供) |
beneficiaryAccountNo | string | 20 | 资金目的帐号 (实际银行帐号,只在充值及提现时提供) |
statementType | string | 1 | 通知类型 : 1:打款帐户充值 2:收款结算转充值 3:帐户馀额互转 4:收款交易结算 5:收款帐户提现 6:打款帐户提现 |
signType | string | 10 | 资金增减类型 : recharge:增项 reduce:减项 |
Amount | int | 金額 Ex:1200000 | |
Currency | string | 3 | 固定币别 PHP |
referenceNumber | string | 15 | 交易编号(唯一) 此编号可于后台查询。 S–开头编号为结算功能(後台)中生成的交易。 D–开头编号为充值功能(後台)中生成的交易 {callerName}–开头编号为系统自动结算的交易。 Ex:S-20231204-001,D-20231204-001,skypay-20231204 |
Output data
{
: ,
: ,
: ,
:[
{
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
:
},
{
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
:
}
]
}
Return code
状态代码 | 状态描述 |
---|---|
1000 | Success |