Cycle Logo

Appendices

Additional references, lists, and examples for the Cycle Android SDK.

Appendix 1: Slip Printing

TypeDescription
BankAccount.getBankName()
Company nameAccount.getClientName()
Legal entity nameAccount.getClientLegalName()
Company phone numberAccount.getClientPhone()
Company websiteAccount.getClientWeb()
Transaction date and timepaymentResultContext.getTransactionItem().getDate()
Terminal numberpaymentResultContext.getTransactionItem().getTerminalName()
Receipt numberpaymentResultContext.getTransactionItem().getInvoice()
Verification coderesult.TransactionItem.AcquirerApprovalCode
Card number and typepaymentResultContext.getTransactionItem().getCard().getIin(), paymentResultContext.getTransactionItem().getCard().getPanMasked()
Transaction EMV tagspaymentResultContext.getEmvData()
Operation typepaymentResultContext.getTransactionItem().getOperation()
Transaction amountpaymentResultContext.getTransactionItem().getAmount()
FeeR 0.00
StatusSuccessful
Client’s signaturePlace for a signature if paymentResultContext.isRequiresSignature()==true, otherwise «Confirmed by entering PIN»

Slip Example

Bank name
Test Client	
"Test Client"
+27 00 000 0000
www.testclient.com
Transaction time and date: 21.03.2017 15:47:34
Terminal: II040001
Receipt: RM7ZEDMAAE7L
Confirmation code: SIMULATION
Payment card: mastercard **** 5631
AID: A0000000041010
TSI: 6800
TVR: 8020008000
Operation type: Purchase
Total: R 33 
Fee: R 0.00 
Status: Successful
Confirmed by entering PIN.

Appendix 2: Example of a Receipt

  • Position 1 – Without VAT
  • Position 2 – VAT 10%
  • Position 3 – VAT 15%
  • Position 4 – VAT 18%
  • Position 5 – VAT 20%

Appendix 3: Error Codes for TTK-protocol

TypeDescription
B4ERN incorrect number
BBLog synchronization is required
FEIncorrect message format, missing mandatory fields
JFReconciliation of totals is required
NFThe original transaction is not found by a bank receipt number
UNThe operation cannot be completed due to the functionality limitations
UPSoftware update is required

Appendix 4: List of Supported Currencies

TypeDescription
ARSArgentine peso
BNDBrunei dollar
BOBBolivian boliviano
BRLBrazilian real
CADCanadian dollar
CLPChilean peso
COPColombian peso
CRCCosta Rican colon
CUPCuban peso
DOPDominican peso
EUREuro
HNLHonduran lempira
HTGHaitian Gourde
IDRIndonesian rupiah
KHRCambodian riel
KRWSouth Korean won
LAKLaos kip
MMKMyanmar kyat
MXNMexican peso
MYRMalaysian ringgit
NIONicaraguan cordoba
PABPanamanian balboa
PENPeruvian sol
PHPPhilippine peso
PYGParaguayan guarani
SGDSingapore dollar
THBThai baht
USDUSA dollar
UYUUruguayan peso
VNDVietnamese dong
ZARSouth African Rand
KESKenyan Shilling
NADNamibian Dollars
BWPBotswana Pula
GHSGhanaian Cedi
MURMauritian Rupees
ZMWZambian Kwacha
UGXUgandan Shilling
MWKMalawian Kwacha
TZSTanzanian Shilling
SCRSeychellois Rupee
MADMorrocan Dirham

Appendix 5: Reader Event Parameter List

INIT_SUCCESSFULLY (For reader Cycle One only)

  • bootloaderVersion
  • hardwareVersion
  • firmwareVersion
  • posId (Reader serial number)

CARD_INFO_RECEIVED (For reader Cycle One only)

  • panHash (Hashed card number)