3.5.1 Payment History
The payment history service is used to get historical data of the transaction. it is strongly advised to use this service to get the valid transaction status when time out occurs during payment.
Payment History Flow
3.5.1.1 ICLPaymentHistoryHandler
The ICLPaymentHistoryHandler service class mainly used to get transaction history (Table ICLLoginHandler, in section 3.3.1.3 ICLLoginHandler).
| Method | Description |
|---|---|
doGetSalesHistory(int page, String param1, String param2) | This function gets transaction history based on invoice number and approval code descending on transaction time. tine input page is the pagination indicator with fixed 5 transactions per-page. |
doGetPaymentByTransactionId(int page, String transactionId) | this function gets transaction history based on TxId |
doGetPaymentByInvoiceAndApprovalCode(int page, String invoiceNo, String approvalCode) | this function get transaction history based on invoice approval code |
doGetPaymentByMerchantTransactionId(int page, String merchantTransactionId) | this function gets transaction history based on merchant transaction Id |
doGetPaymentByDate(int page, String transactionDate) | this function gets transaction history based on date |
3.5.1.2 ICLPaymentHistoryService
ICLPaymentHistoryService is a protocol provided by
ICLPaymentHistoryHandler. It will return a response through the delegate
method whenever it throws a success or an error. Make sure that protocol is
placed in class and set a delegate from ICLPaymentHistoryHandler before
sending the data.
The ICLPaymentHistoryService interfaces has methods/callbacks:
onSalesHistorySuccessonSalesHistoryErrorICLPaymentHistoryService is a protocol provided by ICLPaymentHistoryHandler. it will return a response through the delegate method whenever it throws a success or an error. make sure that protocol is placed in class and set a delegate from ICLPaymentHistoryHandler before sending the data. The ICLPaymentHistoryService interface has method/callbacks.
| Method | Description |
|---|---|
onSalesHistorySuccess(CLPaymentHistoryResponse response) | This callback is called when user can see transaction history |
onSalesHistoryError(CLErrorResponse error) | This callback is called when user can't see transaction history because there is an error |