8.1 通知接口（financeNotification）

这支API是由合作伙伴提供,透过下列时机由SKYPAY发动请求，对合作伙伴发送「充值、结算、提现」之入帐通知。

• 充值、结算、提现
  • (1)打款帐户充值-当人工充值并由SKYPAY财务确认入帐系统时
  • (2)收款结算转充值–当收款结算后，将收款帐户资金转充值打款帐户(人工或配置自动)
  • (3)帐户馀额互转–当不同公司帐户打款馀额进行互转时，将同时通知2个帐户
  • (4)收款交易结算-当系统自动结算收款交易，并入帐时
  • (5)收款帐户提现-当收款结算后进行提现(后台功能)，SKYPAY财务确认完成打款时
  • (6)打款帐户提现–由合作伙伴申请从打款帐户提现，SKYPAY财务确认完成打款时

充值、结算、提现通知流程

Input parameters

参数	类型	长度	必填	描述
userName	string	50	是	使用者名称 由SkyPay提供 Ex:"userName":"AppName@skypay"
action	string	50	是	调用行为 financeNotification(固定参数值) Ex:"action":"financeNotification"
authentication	string	255	是	验证密钥 Ex:"authentication":"E1234567-123C-1234-123F-A12345670"
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-001D-20231204-001,skypay-20231204

Post data

{
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
:
}

Output parameters

参数	类型	长度	描述
responseTime	DateTime	50	回传时间 yyyy-MM-dd HH:mm:ss.SSSS
responseCode	int	4	回传代码 1000
responseDescription	string	255	回传内容描述 响应信息

Output data：

{
: ,
: ,
:
}

Return code

状态代码	状态描述
1000	Success