Skip to main content

Sampel App/Code

2.1 Ringkasan

Dokumentasi SDK ini mencakup Sampel App tentang cara penggunaannya and praktik terbaik dalam menggunakan SDK. Sampel App dikirimkan dengan Java Source Code.

Pengetahuan sebelumnya tentang pemrograman Android Java, Gradle build and Android Studio IDE dibutuhkan dalam memahami Sampel App ini. Memiliki pengetahuan dalam pola desain Model-View-Presenter (MVP) juga merupakan sebuah rekomendasi untuk memahami Arsitektur dari Sampel App. code snippets dari Sampel App are digunakan diseluruh dokumen untuk mendeskripsikan bagaimana penggunaan SDK seharusnya.

2.2 Ketersediaan

Tautan untuk mengunduh Sampel App harus tersedia dan diberikan dengan dokumentasi. Jika tidak, hubungi Cashlez atau personal yang berperan untuk dimintai dokumentasinya terkait hal tersebut. Untuk sekarang, Cashlez mempunyai SDK untuk Android dan iOS.

2.3 Implementasi Sampel App/Code

Ekstrak sample rar code yang sudah disediakan oleh Tim Produk Cashlez. Kemudian buka sebuah project baru di dalam Andorid Studio atau idx, pilih project yang diekstrak.

figure 2.1

Saat impor berhasil dan dependensi di-deploy, Modul tersebut bisa di-deploy ke dalam Android Mobile. example app, Layar Login Untuk berinteraksi dengan card reader dongle Sampel Aplikasi harus di-deploy di dalam sebuah perangkat asli, sekarang ini dalam menggunakan Android emulator belum didukung.

2.4 Implementasi Cashlez Lib atau SDK

  1. Unduh Cashlez Lib yang disediakan oleh tim produk Cashlez.
  2. Unduh file github.properties yang disediakan oleh tim produk Cashlez.
  3. Buka Gradle Project anda, kemudian implementasikan github.properties ke dalam Gradle Project.
  4. Buka Gradle Project anda, kemudian implementasikan Library SDK Cashlez
    com.cashlez.android:cashlez:x.x.x.x

2.5 Antarmuka Aplikasi

Pada versi ini, UI sudah dirubah menjadi tampilan baru yang lebih menyegarkan. Pada landing page-nya memiliki tampilan yang baru dan desain yang kokoh. Didesainnya ulang hal ini karena bertujuan mensederhanakan penggunaan Sampel App untukmerchant Cashlez.

figure 2.2

Berikut adalah komponen - komponen di dalam landing page yang berdasarkan pada Gambar Cashlez Lib Sunmi (setelah gambar di bawah ini):

Halaman Home
No.NameDescription
1.Amount text boxHal ini akan menambah jumlah yang harus dibayar pada pembayaran
2.Description text areaHal ini akan menambah deskripsi pada detail pembayaran
3.UploadHal ini akan mengunggah gambar dari penyimpanan lokal dan ditaruh di dalam penyimpanan cloud
4.Reader and printer statusHal ini akan mengembalikan status reader dan printer, kapanpun reader dan printer tersebut terkoneksi:
  • jika printer-nya terkoneksi, status printer-nya akan mengembalikan nilai true.
  • Jika tidak terkoneksi, akan mengembalikan nilai false.
5.Pay buttonTombol ini akan mengalihkan pengguna ke halaman payment
6.Check reader buttonMengembalikan status reader toast alert
7.Check printer buttonMengembalikan halaman 12 status printer toast alert

figure 2.3
figure 2.4

Ketika dialihkan ke halaman pembayaran, hal ini akan menunjukkan opsi untuk pembayaran, dan juga jumlah serta deskripsi pembayaran. Based on secondary figure from below. Several mandatory fields taken from the home page will appear on the payment page such as amount text, description text, printer, dan status reader.

Untuk setiap pembayaran kami memiliki UI yang berbeda - beda, berikut adalah daftar setiap pembayaran:

Daftar Pembayaran
Payment OptionsPayment Name
International Car0dDebit/Credit Card
CashCash Money
Debit Transfer New ActivityMini ATM bersama (Bank Transfer)
LinkAja New ActivityPayment QRIS LinkAja
Go-Pay QR New ActivityPayment QRIS Go-Pay
OVO New ActivityPush to Pay OVO
Artajasa New ActivityVA (ATM Bersama)
Kredivo New ActivityPayment Paylater Kredivo QR
Shopee QR New ActivityPayment QRIS ShopeePay
Permata VA New ActivityPermata (ATM Bersama)
BCA VA New ActivityBCA VA
Vospay New ActivityPush to Pay (paylater)

Pada fitur Card Mock, Pengguna akan memiliki kemampuan untuk menguji card reader menggunakan segala kartu yang memiliki chip atau garis magnetik. Ada beberapa default amount untuk menggunakan card mock:

Amount for card mock
AmountsDescription
100Success
50Decline or Rejected
105PIN Error
Other value than aboveBatch not ready

figure 2.5
figure 2.6
Detail Riwayat Pembayaran
NoNameDescription
1.Void PaymentUntuk membatalkan pembayaran
2.PrintUntuk mencetak tanda terima/bukti pembayaran
3.Send ReceiptUntuk mengirimkan tanda terima/bukti pembayaran