SoftPOS SDK

┌─────────────────────────────────────────────────────────────┐
│                    AtlasSoftPos (SDK Facade)                │
├─────────────────────────────────────────────────────────────┤
│                      Entry Point                            │
│         (PPSE Selection, AID Matching, Kernel Routing)      │
├──────────────┬──────────────┬──────────────┬───────────────┤
│ Visa Kernel  │   MC Kernel  │ Amex Kernel  │ Discover      │
│  (payWave)   │  (PayPass)   │ (ExpressPay) │  (D-PAS)      │
├──────────────┴──────────────┴──────────────┴───────────────┤
│                    Core Components                          │
│        TLV Parser  │  APDU Framework  │  Crypto Utils      │
├─────────────────────────────────────────────────────────────┤
│                  NFC Card Reader                            │
│              (Android NFC / IsoDep)                         │
└─────────────────────────────────────────────────────────────┘

dependencies {
    implementation 'com.atlas:softpos-sdk:1.0.0'
}

class PaymentActivity : AppCompatActivity() {

    private lateinit var softPos: AtlasSoftPos

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Initialize SDK
        softPos = AtlasSoftPos.Builder(this)
            .setMerchantId("MERCHANT123456789")
            .setTerminalId("TERM0001")
            .setCvmRequiredLimit(2500)  // $25.00 CVM limit
            .build()
    }

    fun startPayment(amountCents: Long) {
        softPos.startTransaction(
            amount = amountCents,
            type = TransactionType.PURCHASE,
            callback = object : TransactionCallback {
                override fun onWaitingForCard() {
                    showUI("Tap card to pay")
                }

                override fun onCardDetected() {
                    showUI("Processing...")
                }

                override fun onResult(result: TransactionResult) {
                    when (result) {
                        is TransactionResult.OnlineRequired -> {
                            // Send to acquirer
                            sendToAcquirer(result.authorizationRequest)
                        }
                        is TransactionResult.Approved -> {
                            showUI("Approved")
                        }
                        is TransactionResult.Declined -> {
                            showUI("Declined: ${result.reason}")
                        }
                        is TransactionResult.Error -> {
                            showUI("Error: ${result.message}")
                        }
                    }
                }

                override fun onError(error: TransactionError) {
                    showUI("Error: $error")
                }

                override fun onCancelled() {
                    showUI("Cancelled")
                }
            }
        )
    }

    override fun onResume() {
        super.onResume()
        softPos.onResume()
    }

    override fun onPause() {
        super.onPause()
        softPos.onPause()
    }
}

data class AuthorizationRequest(
    val pan: String,                    // Primary Account Number
    val track2Equivalent: String,       // Track 2 data
    val expiryDate: String,            // YYMM format
    val applicationCryptogram: String,  // AC (ARQC/TC)
    val cryptogramInfoData: String,     // Cryptogram type indicator
    val atc: String,                    // Application Transaction Counter
    val issuerApplicationData: String,  // IAD
    val terminalVerificationResults: String,  // TVR
    val cvmResults: String,            // CVM Results
    val amountAuthorized: String,      // Amount
    val transactionDate: String,       // YYMMDD
    val unpredictableNumber: String,   // UN
    val aip: String,                   // Application Interchange Profile
    val aid: String,                   // Application Identifier
)

./gradlew :softpos-sdk:test

override fun onResult(result: TransactionResult) {
    when (result) {
        is TransactionResult.OnlineRequired -> {
            // Send to Atlas API
            val response = atlasApi.processAuthorization(
                sessionId = currentSession.id,
                authRequest = result.authorizationRequest
            )

            // Complete transaction based on response
            softPos.completeTransaction(response.approved)
        }
    }
}