Transaction Events

Transaction Results

This class holds the possible transaction processing result codes that will be raised with onTransactionResult callback method.

CodeTypeDescription
0TransactionSuccessfulEvent code indicates transaction has been carried out successfully and the transaction cycle has been completed as well.
7004TransactionDeclinedEvent code indicates the transaction is declined by kernel.
7005TransactionFailedEvent code indicates the kernel has failed to process the trasaction.
7006TransactionNoAppErrorEvent code indicates the card tapped does not have any schemes in it.
7007TransactionFailedAllowFallbackEvent code indicates the transaction has failed but allowing fallback mechanism. Please handle this error the same way as how TransactionFailed is handled.
7008TransactionCardExpiredEvent code indicates the transaction has failed due to the card type has expired.
7020TransactionOnlineFailedEvent code indicates the transaction has failed due to online host rejection.
7024TransactionCancelEvent code indicates the transaction has been cancelled intentionally by the user.
7028TransactionTimeoutEvent code indicates the transaction has failed due to timer that starts counting since transaction start has elapsed.
7054TransactionRequireCDCVMEvent code indicates that CDCVM is required, advise customer to see phone for instructions.
7055TransactionEndApplicationEvent code indicates the card has no further AID to read; treat sthis as a decline.
7056TransactionTryAgainEvent code indicates the Tap to Pay SDK has failed to communicate with the card tapped. This is most likely happened when the card has moved away in the midst of transaction processing.
7059TransactionPinNotSupportedEvent code indicates the transaction has failed due to transaction amount above CVM limit and PIN is not supported for the particular card type.
7060TransactionCardNotSupportedEvent code indicates the card tapped does not supported.
7063TransactionNoKeyErrorEvent code indicates the transaction failed because of key is not available.
7064TransactionOfflineNotPermittedEvent code indicates the offline transaction failed because it is not permitted. E.g. Card expired, Amount over CVM limit
7065TransactionNotPermittedAttestationNotDoneEvent code indicates the transaction not permitted because attestation is not performed.
7066TransactionOfflineTimeAllowanceExceededEvent code indicates the offline transaction not permitted because allow time exceeded.
7067TransactionCardNotMatchedEvent code indicates the card tapped does not matched with originally presented.
7068TransactionManualPanNotPermittedEvent code indicates the manual PAN is not permitted.
7069TransactionInvalidSCATokenEvent code indicates the transaction failed due to invalid SCA token.

Transaction UI Event

This class holds the possible UI events raised by Faastap that may need to show the user.

CodeTypeDescription
71PresentCardEvent code indicates reader is ready for transaction.
72CardPresentedEvent code indicates the card is detected by the reader.
74PresentCardTimeoutEvent code indicates present card has timeout.
23CardReadOkEvent code indicates the contactless card has been processed successfully, can remove card from the terminal.
24CardReadErrorEvent code indicates the contactless card processing has failed.
25CardReadRetryEvent code indicates card read is incomplete and card read retry has been called.
65EnterPinEvent code indicates PIN is required.
66CancelPinEvent code indicates PIN is cancelled.
67PinBypassEvent code indicates PIN is bypassed.
68PinEnterTimeoutEvent code indicates PIN is not entered and timed out.
69PinEnteredEvent code indicates PIN is submitted.
73AuthorisingEvent code indicates sending for online authorization.
70RequestSignatureEvent code indicates request for signature.
80RequiredCDCVMEvent code indicates transaction requires CDCVM.
81ProcessingEvent code indicates transaction is processing

Transaction Status

If the transaction is declined by host, the host error will be returned in statusMessage field if any, please refer to MPOSTransactionOutcome.

CodeTypeDescription
100APPROVEDTransaction approved
101REVERSEDTransaction reversed
102VOIDEDTransaction voided
103PENDING_SIGNATURETransaction pending singature
104SETTLEDTransaction settled
105PENDING_SETTLEMENTTransaction pending settlement
106REFUNDEDTransaction refunded
127PENDING_APPROVALTransaction pending approval
251DECLINEDTransaction declined