Table of content
Use Cases
- Internal fund transfer between NCB accounts:
A customer uses the bank's mobile app or internet banking platform to transfer money from one NCB account to another within the same banking system. This is a typical in-house transaction that ensures real-time fund movement without incurring interbank fees.
Error Handling
| Code | Description | Resolution |
| ESB.005.01.008 | Error connecting to targetService | Show message error: TBD by PO |
| ESB.005.01.009 | Invalid FunctionCode | Show message error: TBD by PO |
| ESB.005.02.004 | Debit account is missing | Show message error: TBD by PO |
| ESB.005.02.004 | Credit account is missing | Show message error: TBD by PO |
| ESB.005.02.004 | Invalid debit account number | Show message error: TBD by PO |
| ESB.005.02.004 | Invalid credit account number | Show message error: TBD by PO |
| ESB.005.02.004 | Debit account currency is missing | Show message error: TBD by PO |
| ESB.005.02.004 | Credit account currency is missing | Show message error: TBD by PO |
| ESB.005.02.004 | Debit account currency does not match the transaction currency. | Show message error: TBD by PO |
| ESB.005.02.004 | Credit account currency does not match the transaction currency. | Show message error: TBD by PO |
| ESB.005.02.004 | Field length exceeds max length | Show message error: TBD by PO |
| ESB.005.02.004 | TransDate is not numeric | Show message error: TBD by PO |
| ESB.005.02.004 | Duplicated trace number | Show message error: TBD by PO |
| ESB.005.02.004 | Debit account has insufficient money to transfer | Show message error: TBD by PO |
| ESB.005.02.004 | Transfer amount exceeds maximum internal transfer limit per transaction or per day | Show message error: TBD by PO |
| ESB.005.02.004 | Debit account is restricted from debiting or limited in transactions. | Show message error: TBD by PO |
| ESB.005.02.004 | Credit account is restricted from crediting or limited in transactions. | Show message error: TBD by PO |
- Top-up to flexible savings account:
A customer decides to add funds to their flexible savings account (accumulated savings) either on a scheduled basis or as a one-time action. This helps increase their savings balance and benefit from interest accrual, while still maintaining flexibility. - QR code payment for Sun World tickets:
At a Sun World amusement park or service counter, a customer scans a VNPay QR code using the NCB app. The system calls thecreate-qrftAPI to process the payment, enabling quick and secure ticket purchases without cash or card. - Check transfer fee before processing:
Before confirming a fund transfer, the system uses theinquiry-ft-feeAPI to retrieve and display the applicable transaction fee. This provides transparency and allows the customer to make an informed decision before proceeding with the transfer.
