Skip to main content

Ringkasan Metode Integrasi

Alur Cashlez Link
integration flow

Host: https://api-link.cashlez.com/
Semua API request harus dibuat melalui HTTPS. Calls yang dilakukan atas HTTP dan API requests untuk men-Generate URL tanpa otentikasi, akan gagal.

No.EndpointDeskripsi
1./generate_url_vendorMenghasilkan URL
2./validate_urlMemeriksa Status Transaksi dan Get Payment methods
3./process_urlMenghasilkan Payment URL yang baru

Otentikasi​

Verifikasi pengintegritasan data yang dipertukarkan antar pihak dengan membuat digital signature menggunakan enkripsi RSA.

Detil lebih lanjut mengenai proses otentikasi dapat melalui Otentikasi Cashlez Link

Skema 1​

Skema 1 menjelaskan alur yang diambil merchant saat berintegrasi menggunakan halaman default dari Cashlez. Merchant perlu memanggil API Generate URL dan akan mendapatkan Payment Url yang dapat dibuka melalui browser, proses ini memperbolehkan pelanggan melakukan pembayaran sesuai dengan pilihan metode yang diinginkan.

Skema 1 Sequence Diagram
schema 1.1

    Generate Url​

    API Generate Url dimintai dari merchant kepada Cashlez untuk men-generate Payment Url, setelah mendapatkan response dari API Generate Url, Url tersebut dapat dibuka melalui browser.

    SettingValue
    MethodPOST
    Host{HOST}
    Path/generate_url_vendor

    Detil lebih lanjut mengenai Generate Url dapat melalui API Generate Url.

    Visualisasi Pembayaran​

    No.GambarDeskripsi
    1.payment urlPayment Url dibuka di browser
    2.card payment selectedCard Payment dipilih sebagai metode pembayaran
    3.qris payment selectedQRIS dipilih sebagai metode pembayaran
    4.va selectedVirtual Account dipilih sebagai metode pembayaran
    5.success paymentNotifikasi pembayaran sukses

Skema 2​

Skema 2 menjelaskan alur yang dilakukan oleh merchant selama integrasi menggunakan tampilan menu metode pembayaran tambahan, dengan melihat response dari Validate URL yang akan menampilkan metode pembayaran yang telah didaftarkan oleh merchant pada saat pertama kali mendaftar sebagai merchant Cashlez. Proses selanjutnya adalah sesuai dengan instruksi pada tampilan halaman.

Skema 2 Diagram Sequence
Schema 2 flow
note

Generate URL perlu di-hit sebelum meneruskannya dengan meng-hit Validate URL

    Validate Url (Check Status)​

    API Validate Url dimintai dari merchant kepada Cashlez untuk pengecekan semua kemungkinan metode pembayaran dan Status Transaksi melalui response dari Generate url.

    SettingValue
    MethodPOST
    Host{HOST}
    Path/validate_url

    Detil lebih lanjut mengenai Validate Url dapat melalui API Validate Url.

    Process Url​

    API Process Url diminta dari merchant kepada Cashlez untuk memperbarui halaman pembayaran dengan metode tertentu yang telah dipilih oleh pelanggan.

    SettingValue
    MethodPOST
    Host{HOST}
    Path/process_url

    Detil lebih terkait mengenai Process Url dapat melalui API Process Url.

Callback​

Callback Cashlez adalah notifikasi transaksi yang dikirim oleh Cashlez kepada merchant melalui APIs yang sudah teregistrasi di dalam sistem Cashlez. Terdapat 2 macam callback, yang pertama adalah API Callback Url dimana cashelz akan meng-hit API ke merchant sebagai sebuah notifikasi status transaksi, kemudian yang kedua terdapat Callback Screen yang akan menjadi web page tertuju ketika transaksi tersebut telah selesai.