react-native-bkmexpress-sdk

BKM Express ödeme,kart eşleştirme ve kart değiştirme işlemlerini gerçekleştirilmek için kullanılır. BKM Express native SDK'ları baz alınarak geliştirme yapılmıştır. Kütüphane oluşturulurken bazı konularda benzer bir kütüphane olan react-native-bkmexpress kütüphanesinden yararlanılmıştır.

Android: https://github.com/BKMExpress/BEXAndroidSDK

IOS: https://github.com/BKMExpress/iOSBKMExpressSDK

Kurulum

npm

$ npm install macellan/react-native-bkmexpress-sdk --save

yarn

$ yarn add macellan/react-native-bkmexpress-sdk

IOS

Projenizin ios klasörü içindeki *.xcworkspace dosyasını XCode ile çalıştırın.

node_modules/react-native-bkmexpress-sdk/ios klasörü içindeki BEX.bundle ve libBKMExpressSDK.a dosyalarını sürükleyerek Frameworks klasörü altına ekleyin Copy items if needed seçili olduğundan emin olun ve Add to targets kısmından uygulamanızı seçin.

Son olarak pod yüklemesini gerçekleştirmeyi unutmayın.

$ cd ios && pod install && cd ..

Android

Projenizin içindeki local.properties dosyasına aşağıdaki keyleri Bkm Expiress'den aldığınız bilgiler ile tanımlayınız.

AndroidX desteği bulunmayan uygulamalarınız için versiyon bilgisini 1.1.23 olarak değiştiriniz.

bkm_username=user_name
bkm_password=password
bkm_maven_url=http://...
bkm_version=2.1.1

android/build.gradle altında aşağıdaki değişikliği yapınız

Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())

allprojects {
    repositories {
        //...        
        maven {
          url = properties.getProperty("bkm_maven_url")
          credentials {
            username = properties.getProperty("bkm_username")
            password = properties.getProperty("bkm_password")
         }
       }
    }
}

Notlar

• Eğer uygulamanızın release versiyonunu proguard ile koruyorsanız, lütfen aşağıdaki satırı proguard-rules dosyanıza ekleyiniz.

  -keep class com.bkm.** { *; }

• 2.1.1 versiyonunu kullanırken Attribute application@allowBackup value=(false) hatası alırsanız;
  android:allowBackup="false" true olarak değiştiriniz yada AndroidManifest.xml'de manifest'e xmlns:tools="http://schemas.android.com/tools" aplication'a tools:replace="allowBackup" kodlarını ekleyiniz.

    <manifest 
        //...
        xmlns:tools="http://schemas.android.com/tools">
        <application
          //...
          tools:replace="allowBackup">
          //...
        </application>
    </manifest>

Kullanım

import BkmExpressSdk from 'react-native-bkm-express-sdk';

SUBMIT CONSUMER (KART EŞLEME)

BkmExpressSdk.submitConsumer(token, environment , (callback, result) => {
        if (result === '0') {
            console.log('Successful. kart no: ', callback)
        }
        else if (result === '1') {
            console.log('Canceled')
        }
        else if (result === '2') {
            console.log('failed. error: ', callback)
        } 
    }
);

RESUBMIT CONSUMER (KART DEĞİŞTİRME)

• Diğer işlemlerden farklı olarak, ReSubmitConsumer operasyonu daha önceden kart eklemiş kullanıcının tekrardan sisteme giriş yapmadan kart değiştirmesine olanak sağlamaktadır. Bahsi geçen Ticket, BEX Core servisleri tarafından sağlanmaktadır.

BkmExpressSdk.resubmitConsumer(ticket, environment , (callback, result) => {
        if (result === '0') {
            console.log('Successful. kart no: ', callback)
        }
        else if (result === '1') {
            console.log('Canceled')
        }
        else if (result === '2') {
            console.log('failed. error: ', callback)
        } 
    }
);

PAYMENT (ÖDEME)

BkmExpressSdk.payment(token, environment , (callback, result) => {
        if (result === '0') {
            console.log('Successful. Pos Cevabı: ',result)
        }
        else if (result === '1') {
            console.log('Canceled')
        }
        else if (result === '2') {
            console.log('failed. error: ', callback)
        } 
    }
);

Parametreler

Değer Adı	Değer Tipi	Değerin Amacı
token	String	Yapılacak olan işlemin token bilgisi
environment	String	Çalıştırma ortamı - PREPORD ortamı için "PREPROD", PROD ortamı için "PROD" giriniz
ticket	String	Kartı yeniden eşleştirmede kullanılacak Bkm tarafından iletilen ticket numarası
callback	String	İşlem başarılı ise duruma göre obje veya string dönebilir. Başarısız işlemlerde hata mesajı
result	String	Dönen sonuç (0 Başarılı - 1 İptal - 2 Başarısız)