8.1 financeNotification
This API is provided by partners and is requested by SKYPAY to send payment notifications for "recharge, settlement, and withdrawal" to partners at the following times.
Recharge、settle、withdraw
(1) Payment account recharge - When manually recharged and confirmed by SKYPAY finance to be credited to the system
(2) Payment settlement to recharge - After payment settlement, transfer funds from the payment account to the recharge and payment account (manually or automatically configured)
(3) Account balance transfer - When the transfer of funds from different company accounts occurs, two accounts will be notified simultaneously
(4) Payment transaction settlement - When the system automatically settles payment transactions and merges them into the account
(5) Withdrawal from receiving account - Withdrawal will be made after receiving settlement (backend function), and SKYPAY finance will confirm the completion of payment
(6) Withdrawal from payment account - When the partner applies for withdrawal from the payment account and SKYPAY finance confirms completion of the payment
Recharge、 settlement、 and withdrawal notification process
Input parameters
| parameter | type | length | must | describe |
|---|---|---|---|---|
| userName | string | 50 | YES | User name provided by SkyPay - "userName":"AppName@skypay" |
| action | string | 50 | YES | Call behavior financeNotification(Fixed parameter values) - Ex:"action":"financeNotification" |
| authentication | string | 255 | YES | Verification Code Verification Key - Ex:"authentication":"E1234567-123C-1234-123F-A12345670" |
| transctionDate | DateTime | 50 | YES | notice date - ex:2023-06-18 17:52:10 |
| companyPrefix | string | 5 | YES | Company Code ex:SKY98 |
| companyName | string | 200 | YES | corporate name ex:Skybridge Payment Inc. |
| accountNo | string | 5 | YES | account - ex:SKY98 |
| sourceAccountNo | string | 20 | YES | Fund source account (actual bank account number, only provided at withdrawal) |
| beneficiaryAccountNo | string | 20 | YES | Fund purpose account (actual bank account number, only provided during recharge and withdrawal) |
| statementType | string | 1 | YES | Notification type: 1: Recharge from payment account 2: Recharge from collection settlement 3: Account balance transfer 4: Collectiontransactionsettlement 5: Withdrawal from payment account 6: Withdrawal from payment account |
| signType | string | 10 | YES | Type of fund increase or decrease recharge:Additional items reduce:deduction |
| Amount | int | YES | money Ex:1200000 | |
| Currency | string | 3 | YES | Fixed Currency PHP |
| referenceNumber | string | 15 | YES | Transaction Number (Unique) This number can be queried in the background- S The starting number is the transaction generated in the settlement function (backend)- D The starting number is the transaction generated in the recharge function (backend) {caller Name} The starting number is the transaction automatically settled by the system。 ex:S-20231204-001D-20231204-001,skypay-20231204 |
Post data
{
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
: ,
:
}
Output parameters
| parameter | type | length | describe |
|---|---|---|---|
| responseTime | DateTime | 50 | Return time yyyy-MM-dd HH:mm:ss.SSSS |
| responseCode | int | 4 | Return code 1000 |
| responseDescription | string | 255 | Return content description response information |
Output data：
{
: ,
: ,
:
}
Return code
| Status Code | Status Description |
|---|---|
| 1000 | Success |