Hızlı Başlangıç

X30TR Android Yazarkasa POS cihazında "Satış Uygulamaları"na tıklandığında uygulamanızın açılması ve cihaz altyapısı üzerinden ödeme alabilmek için bu adımları takip edebilirsiniz.

Uygulamanızın Satış Uygulaması Olarak Tanımlanması

Uygulamanızın AndroidManifest.xml dosyasına aşağıdaki bilgilerin eklenmesi gerekmektedir.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.example">

    <application>
        <!-- Gerekli meta-data bilgileri -->
        <!--
          Uygulamanızın ID olarak kullanılacak ismi.
          LYL_330TR_ ile başlamalıdır. Örnek: LYL_330TR_MYAPP
          Bu ismi kullanıcı görmez.
          -->
        <meta-data
            android:name="app_name"
            android:value="LYL_330TR_MYAPP" />
            
        <!-- X30TR için zorunlu değerdir. Değiştirmeyiniz. -->
        <meta-data
            android:name="app_model_type"
            android:value="330TR" />
            
        <!--
          Uygulamanızın versiyon numarası.
          build.gradle'ınızdaki versionCode değerine bağlayabilirsiniz.
          Geliştirmeniz sırasında 1 kullanabilirsiniz.
          -->
        <meta-data
            android:name="app_version"
            android:value="1" />
            
        <!-- Açılmasını istediğiniz activity -->
        <meta-data
            android:name="sale_activity_name"
            android:value="MainActivity">
        </meta-data>

    </application>
</manifest>

Manifest dosyanıza bu eklemeleri yaptıktan ve uygulamanızı cihaza yükledikten sonra bir defalığına mahsus aşağıdaki komutu çalıştırırsanız "Satış uygulamaları" listesinde görünecektir.

adb shell pm clear com.tokeninc.sardis.paymentgateway

Satış Sepeti JSON Formatı

Basit bir satış için aşağıdaki gibi bir sepet JSON'ı kullanabilirsiniz. JSON formatıyla ilgili ayrıntılı bilgi için tıklayın.

Ürünün hangi kısıma ait olduğu bilgisini sectionNo ile ve KDV oranını taxPercent ile göndermeniz gereklidir. KDV değerleri cihazdaki tanımlı kısımlara ait olmalıdır.

Bu örnek sepette 1. kısmın %10 KDV'li olduğu varsayılmıştır.

{
  "basketID": "c0a9138b-9193-4380-a4c6-3ab04523a02c",
  "createInvoice": false,
  "documentType": 0,
  "isVoid": false,
  "items": [
    {
      "name": "Yiyecek",
      "limit": 10000,
      "price": 1000,
      "quantity": 1000,
      "sectionNo": 1,
      "taxPercent": 1000,
      "type": 0
    }
  ]
}

Ödeme Ekranına Geçilmesi

Bu kod aracılığıyla sepetinizi ödeme uygulamasını açabilirsiniz.

private fun startPGW(jsonObj : JSONObject){
    val PAYMENT_PROCESSOR_PACKAGE_NAME = "com.tokeninc.sardis.paymentgateway"
    val PAYMENT_PROCESSOR_APP_NAME = ".MainActivity"
    
    val appName = PAYMENT_PROCESSOR_PACKAGE_NAME + PAYMENT_PROCESSOR_APP_NAME
    val intent = Intent()
    val bundle = Bundle()
    
    bundle.putString("orderBody", jsonObj.toString())
    intent.putExtras(bundle)
    intent.component = ComponentName(PAYMENT_PROCESSOR_PACKAGE_NAME, appName)
    
    startActivityForResult(intent, 0x1003)
}

Ödeme Sonucunun Alınması

Ödeme tamamlandıktan sonra ödeme sonucunu aşağıdaki şekilde alabilirsiniz. Ödeme sonucunda dönen JSON'ın formatıyla ilgili ayrıntılı bilgi için tıklayın.

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)

    if(requestCode == 0x1003) {
        try {
            var responseJson = data!!.getStringExtra("paymentBody")
        } catch (e : Exception){
            e.printStackTrace()
        }
    }
}

Cihazda Tanımlı Kısımların Çekilmesi

Aşağıdaki AIDL'i projenize ekleyin.

// IFiscalService.aidl
package com.tokeninc.fiscalservice;

interface IFiscalService {
 int getSection(out List<String> data);
}

Android Manifestinize bu satırları ekleyin.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">
    
      <!-- Bu izni eklemeniz gerekir -->
    <uses-permission
        android:name="android.permission.QUERY_ALL_PACKAGES"
        tools:ignore="QueryAllPackagesPermission" />

    <application>
    
     <!-- AIDL'in burada tanımlanması gerekir -->
    <queries>
        <intent>
            <action android:name="com.tokeninc.fiscalservice.AIDL" />
        </intent>
    </queries>

</manifest>

Uygulamanız içinde kısımları çekmek için bu kodu kullanabilirsiniz. Kısımlarla beraber diğer dönen bilgilerin JSON formatı için tıklayın.

private fun bindToFiscalService() {
    try {
        val intent = Intent("com.tokeninc.fiscalservice.AIDL")
        val explicitIntent = convertImplicitIntentToExplicitIntent(this,intent)
        if (explicitIntent != null) {
            Log.i("$TAG-bindToFiscalService", "explicitIntent = VAR")
            bindService(explicitIntent, fiscalServiceConnection, BIND_AUTO_CREATE)
        } else {
            Log.i("$TAG-bindToFiscalService", "explicitIntent = null")
        }
    } catch (e: java.lang.Exception) {
        Log.i("$TAG-bindToFiscalService", "e: $e")
    }
}

private fun convertImplicitIntentToExplicitIntent(ct: Context, implicitIntent: Intent): Intent? {
    val pm = ct.packageManager
    val resolveInfoList = pm.queryIntentServices(implicitIntent, 0)
    if (resolveInfoList == null || resolveInfoList.size != 1) {
        return null
    }
    val serviceInfo = resolveInfoList[0]
    val component = ComponentName(serviceInfo.serviceInfo.packageName, serviceInfo.serviceInfo.name)
    val explicitIntent = Intent(implicitIntent)
    explicitIntent.component = component
    return explicitIntent
}

private fun fetchSections() {
    fiscalService!!.getSection(sectionList)
    
    // Array's first element is section info
    val sectionFiscalInfo = sectionList[0]
    Log.i("fetchSections", "Section Info: $sectionFiscalInfo")
}

var sectionList : MutableList<String> = mutableListOf()
var fiscalService: IFiscalService? = null
private var fiscalServiceConnection = object : ServiceConnection {
    override fun onServiceConnected(name: ComponentName?, service: IBinder?) {
        try {
            fiscalService = IFiscalService.Stub.asInterface(service)
            fetchSections()
            fiscalService = null
        } catch (e: java.lang.Exception) {
            e.printStackTrace()
        }
    }
    override fun onServiceDisconnected(name: ComponentName?) {
        fiscalService = null
    }
}

Cihazın Terminal ID'sinin Çekilmesi

TDeviceInfo_1.3.aar

34KB

Open

Bu aar dosyasını indirin ve projenize ekleyin ve app build.gradle içinde aşağıdaki şekilde ekleyin.

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])
}

Uygulamanız içinde terminal id'yi almak için:

private fun getTerminalID() {
    val deviceInfo = DeviceInfo(this)
    deviceInfo.getFiscalId(object : DeviceInfo.DeviceInfoResponseHandler{
        override fun onSuccess(result: String) {
            terminalId = result
        }

        override fun onFail(errMessage: String?) {
            Log.i("DeviceInfo-onFail", errMessage!!)
        }
    })
}

Elektrik Kesintisi Durumunda Ödeme Bilgisinin Alınması

Ödeme sırasında cihazın elektriği kesilirse cihaz tekrar açıldığında otomatik olarak ödeme ekranına geçer. Bu ekrandan ödeme tamamlandıktan sonra uygulamanıza broadcast gönderilir.

Broadcasti alması için bu şekilde bir BroadcastReceiver kullanabilirsiniz. Burada dönen JSON ödeme sonucu JSON'ı ile aynıdır.

/**
 * Receives action token.intent.ACTION_POWERCUT_RESULT
 */
class SaleReceiptReceiver: BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        try {
            val paymentJson = intent.getStringExtra("paymentBody")!!
        } catch (e: Exception) {
            Log.i("SaleReceiptReceiver", "onReceive: Error occurred while saving power cut data!")
        }
    }
}

Android Manifest'inizde bu receiverı tanımlayın.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <application>
        <!-- Elektrik kesintisi BroadcastReceiver tanımı -->
        <receiver android:name=".receivers.SaleReceiptReceiver" android:exported="true" android:enabled="true">
            <intent-filter>
                <action android:name="token.intent.ACTION_POWERCUT_RESULT"/>
                <category android:name="android.intent.category.DEFAULT"/>
            </intent-filter>
        </receiver>
        
    </application>

</manifest>

Tam Entegre Android Manifest

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

     <!-- Bu izni eklemeniz gerekir -->
    <uses-permission
        android:name="android.permission.QUERY_ALL_PACKAGES"
        tools:ignore="QueryAllPackagesPermission" />

    <application>

         <!-- Gerekli meta-data bilgileri -->
        <!--
          Uygulamanızın ID olarak kullanılacak ismi.
          LYL_330TR_ ile başlamalıdır. Örnek: LYL_330TR_MYAPP
          Bu ismi kullanıcı görmez.
          -->
        <meta-data
            android:name="app_name"
            android:value="LYL_330TR_MYAPP" />
            
        <!-- X30TR için zorunlu değerdir. Değiştirmeyiniz. -->
        <meta-data
            android:name="app_model_type"
            android:value="330TR" />
            
        <!--
          Uygulamanızın versiyon numarası.
          build.gradle'ınızdaki versionCode değerine bağlayabilirsiniz.
          Geliştirmeniz sırasında 1 kullanabilirsiniz.
          -->
        <meta-data
            android:name="app_version"
            android:value="1" />
            
        <!-- Açılmasını istediğiniz activity -->
        <meta-data
            android:name="sale_activity_name"
            android:value="MainActivity">
        </meta-data>

        <!-- Elektrik kesintisi BroadcastReceiver tanımı -->
        <receiver android:name=".receivers.SaleReceiptReceiver" android:exported="true" android:enabled="true">
            <intent-filter>
                <action android:name="token.intent.ACTION_POWERCUT_RESULT"/>
                <category android:name="android.intent.category.DEFAULT"/>
            </intent-filter>
        </receiver>

    </application>

    <!-- AIDL'in burada tanımlanması gerekir -->
    <queries>
        <intent>
            <action android:name="com.tokeninc.fiscalservice.AIDL" />
        </intent>
    </queries>

</manifest>