Skip to content

Invoice Xendit

Perkenalan Invoice

Invoice Xendit adalah salah satu product kami yang berguna untuk meningkatkan pembayaran dan penjualan anda dengan menyediakan pengalaman membayar tanpa hambatan ke pelanggan Anda untuk pembayaran sekali, pembayaran berulang ataupun pembayaran lainnya. Invoice Xendit otomatis mendeteksi pembayaran secara instan dan dapat dibayar pelanggan Anda melalui bank manapun.

Kami menyediakan invoice Xendit secara gratis dan Anda bisa membuat invoice kapanpun menggunakan Xendit Dashboard maupun invoice API. Tampilan invoice Xendit dapat langsung digunakan, dapat digunakan sebagai halaman pembayaran bisnis e-commerce Anda, ataupun dapat dihubungkan dengan tampilan pembayaran milik Anda sendiri. Apabila Anda memilih untuk menggunakan tampilan kami, beginilah yang akan pelanggan anda lihat:

alt text

Invoice Xendit dapat dibuka lewat website maupun mobile-web, mendukung bahasa Indonesia dan Inggris serta menampilkan semua metode pembayaran yang Anda aktifkan lengkap dengan cara membayarnya. Hal ini akan memberikan pelanggan anda fleksibilitas dan dampak positif pun akan terasa ke hasil penjualan Anda.

Selamat! Anda telah mempelajari dasar-dasar invoice

Langkah selanjutnya: Apabila Anda terus membaca kebawah, Anda akan mempelajari tentang:


Cara Kerja

Saat pembayaran telah selesai, Xendit mendeteksi pembayaran yang masuk dan mengirimkan callback. Uang yang masuk akan masuk dan muncul kedalam Dashboard Xendit sebagai balance di Cash Account dan status invoice di dashboard invoice akan diperbaharui secara otomatis.

alt text


Fitur dan Batasan

Fitur

Fitur Penjelasan
Metode pembayaran yang beragam Metode dapat di atur. (Kartu Kredit, VA bank, outlet retail, e-wallet)
Notifikasi otomatis Callback URL untuk Anda, email untuk pelanggan Anda
Tampilan yang gratis dan bebas diatur Tanpa harus Anda buat, kami membuatkan untuk Anda dan Anda dapat mengaturnya sesuka Anda: Logo bisnis, nama bisnis, deskripsi, bahasa, warna, font dan metode pembayaran
Tanggal kadaluarsa yang dapat diatur Anda dapat mengatur tanggal kadaluarsa untuk invoice anda. Kendali penuh ada dalam genggaman Anda
Laporan secara langsung di dashboard Xendit Lakukan pengecekan data di dashboard
Cara pembayaran yang terus kami perbaharui Kami selalu menyediakan cara pembayaran yang terbaru untuk pelanggan Anda. Kami selalu membuat segalanya mudah untuk Anda menerima pembayaran
Dengan atau tanpa API integration Pembuatan invoice melalui dashboard ataupun membuat secara otomatis melalui API

Channel Pembayaran

Invoice Xendit dapat mendeteksi dan menerima pembayaran dari seluruh bank di Indonesia, kartu kredit di seluruh dunia, outlet retail dan e-wallet. Integrasi yang sangat sederhana dan mudah dengan invoice Xendit akan membuat bisnis Anda mampu menerima pembayaran dari seluruh metode diatas.

alt text

Batasan

Sebelum Anda membuat invoice, pastikan Anda tidak melebihi batasan dari invoice:

Kondisi Batasan
Tagihan maksimum per invoice IDR 1.000.000.000
Tagihan minimum per invoice IDR 10.000
Pembayaran maksimum untuk Outlet Retail IDR 5.000.000

Bila Anda membuat invoice dengan tagihan diatas IDR 5.000.000, metode pembayaran Outlet Retail akan otomatis dimatikan untuk invoice tersebut.


Mulai mengatur invoice Anda

Bila Anda telah mendapatkan akses ke transaksi live, dan Anda membutuhkan VA, maka Anda dapat mengaktifkan range nomor VA Anda pada Dashboard > Settings > Configuration > Invoice dengan mengklik tombol "activate". Apabila Anda belum mendapatkan akses live, jangan lupa untuk menghidupkan VA tersebut setelah Anda live.

Sebelum Anda membuat invoice untuk pertama kalinya, Anda mungkin ingin melakukan beberapa penyetelan dan pengaturan pada invoice Anda. Anda dapat mengunjungi Dashboard > Invoice > Custom Invoice dan membuat perubahan awal pada invoice Anda.

Deskripsi Apa yang akan berubah
Warna Mengatur warna pada invoice Anda
Font Mengatur font pada invoice Anda
Bahasa Utama Bahasa utama yang akan pelanggan Anda lihat (Pelanggan Anda dapat mengubahnya ketika mereka membayar)
Durasi standar invoice durasi standar invoice. (Anda juga dapat mengatur durasi per invoice saat membuat invoice)
Metode Pembayaran standar Pilih metode pembayaran dan metode pembayaran utama Anda (Anda juga dapat mengatur metode pembayaran per invoice saat membuat invoice melalui API)

Untuk meningkatkan kepercayaan pelanggan Anda, ada juga perlu untuk memperbaharui logo bisnis dan nama bisnis Anda di Dashboard > Settings > General

alt text


Notifikasi dan Callback

Notifikasi Email

Bila Anda memilih "send invoice to this email" saat membuat invoice, pelanggan Anda akan menerima email saat:

  • Invoice dibuat
  • Invoice dibayar atau kadaluarsa

alt text

Sebagai penjual, Anda juga dapat menerima notifikasi email untuk invoice yang terbayar maupun kadaluarsa. Bila Anda memilih untuk mendapatkan notifikasi email tersebut, Anda dapat menghubungi kami dan kami akan mengaktifkannya untuk Anda.

Callback URL

Saat ini, Xendit dapat memberikan callback saat invoice terbayar dan kadaluarsa, pastikan callback URL untuk invoice sudah diaktifkan. Anda dapat mengatur callback URL di dashboard Anda Dashboard > Settings > Configuration > Invoice. Dibawah adalah contoh dimana Anda dapat mengatur callback URL untuk invoice Anda:

alt text

Callback URL butuh koneksi HTTPS dengan SSL (Standard Socket Layer), dimana hal tersebut adalah protokol keamanan standar Xendit dan callback hanya akan bekerja bila dihubungkan dengan situasi yang tepat. Berikut adalah contoh bagaimana mengimplementasikan callback dari sisi Anda:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
<?php
    if ($_SERVER["REQUEST_METHOD"] === "POST") {
        $data = file_get_contents("php://input");
        print_r("\n\$data contains the updated invoice data \n\n");
        print_r($data);
        print_r("\n\nUpdate your database with the invoice status \n\n");
    } else {
        print_r("Cannot ".$_SERVER["REQUEST_METHOD"]." ".$_SERVER["SCRIPT_NAME"]);
    }
?>

Membuat Invoice dari dashboard

Membuat invoice menggunakan dashboard Xendit sangatlah sederhana. Setiap invoice Xendit yang dibuat akan berada dalam dashboard dengan status dan detailnya. Pertama, pergi ke dashboard invoice tab dimana Anda dapat menemukan tombol “+ Create invoice”. Ketika Anda menekan tombol tersebut, pop-up akan muncul dan Anda dapat membuat invoice dengan mengisi:

Parameter Apa yang harus diisi
External ID Kode unik untuk Anda kenali. contohnya:
  • HOUSE.AP/INV/XXV/34
  • 1293
  • TPR0004
  • XJEDBDIEFDJIAGDY
Email Email dari pelanggan Anda. Anda dapat memilih apakah Xendit akan mengirimkan email ke pelanggan atau tidak
Invoice due time Click on calendar icon to choose the date and then inside calendar, click clock icon to set the time
Amount Nominal tagihan dalam Rupiah
Description Deskripsi singkat untuk dibaca pelanggan Anda. (contohnya: pembayaran listrik apartemen unit #0521G)

Setelah Anda mengisi informasi diatas dan membuat invoice, Anda akan mendapatkan tautan untuk invoice Anda. Bila Anda memilih “Send invoice to this email”, Xendit akan secara otomatis mengirimkan email ke pelanggan Anda. Anda juga dapat menyalin tautan dan mengirimkan langsung ke pelanggan. Pelanggan Anda dapat membayar invoice dengan memilih metode pembayaran dan mengikuti instruksi yang ditampilkan pada invoice.


Membuat invoice melalui API

Bila Anda tidak mengerti teknikal, Anda dapat [lewati tahapan ini]](#simulasi-pembayaran-di-test-mode). Namun, bila Anda mengerti bagaimana API bekerja dan Anda ingin membuat invoice menggunakan API, Anda dapat mengunjungi dokumentasi API invoice. Untuk mempelajari tentang integrasi, Anda juga dapat mengunjungi Integration. Untuk mengetes, Anda dapat menggunakan Postman.

Bila Anda memilih untuk menggunakan tampilan Invoice Xendit, Anda hanya perlu mengambil respon tautan yang Xendit berikan dan teruskan tautan tersebut kepada pelanggan Anda. Anda dapat menempatkannya dalam tombol website Anda, email Anda ke pelanggan, via chatting ataupun lewat jalur apapun yang Anda inginkan. Dengan menggunakan API, Anda juga dapat membuat tampilan maupun halaman pembayaran Anda sendiri. Respon API Xendit akan mengembalikan data yang dapat Anda gunakan dalam tampilan Anda sendiri. Ketika Anda menggunakan tampilan Anda sendiri, abaikan tautan invoice yang Xendit berikan dan gunakan hanya data yang sesuai dengan kebutuhan Anda.

Mari mencoba membuat invoice yang dapat Anda coba bayar sehingga Anda mengerti bagaimana cara kerja invoice. Anda dapat mengikuti tahapan berikut untuk mengimplementasikan API invoice Xendit. Anda perlu untuk POST request dibawah. Ini akan membuat sebuah invoice yang dapat bayar oleh pelanggan Anda menggunakan metode yang telah dikonfigurasi melalui dashboard.

1
2
3
4
5
6
curl https://api.xendit.co/v2/invoices -X POST \
    -u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==: \> 
    -d external_id=demo-1531960366017 \
    -d payer_email=sample_email@xendit.co \
    -d description='Trip to Bali' \
    -d amount=52000
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<?php 
    require 'vendor/autoload.php'; 
    $options['secret_api_key'] = 'xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg=='; 
    $xenditPHPClient = new XenditClient\XenditPHPClient($options); 
    $external_id = 'demo_1475801962607';
    $payer_email = 'sample_email@xendit.co';
    $description = 'Trip to Bali';
    $amount = 13000;
    $response = $xenditPHPClient->createInvoice($external_id, $amount, $payer_email, $description);
    print_r($response); 
?>

Xendit telah mengisi beberapa konten diatas dengan contoh API key dan parameter lainnya. Anda perlu untuk mengganti konten dari parameter diatas dengan API key dan parameter yang Anda inginkan. Anda juga dapat menambahkan beberapa hal yang sifatnya tidak wajib seperti melakukan redirect ataupun mengatur durasi dan metode pembayaran. Deskripsi lengkap dari parameter tersebut juga dapat ditemukan di invoice API docs.


Simulasi pembayaran di test mode

Tes integrasi Xendit dengan mensimulasikan pembayaran ke invoice Anda! Simulasi ini akan berujung dengan status invoice yang menunjukan Paid/Settled di dashboard. Xendit juga akan mengirimkan callback ke URL callback Anda

Simulasi melalui nominal

  1. Buat invoice dengan nominal tagihan IDR 3,000,000
  2. Pergi ke dashboard untuk melihat detil transaksi
  3. Invoice sudah sukses dibayar

Simulasi via kartu

  1. Buatlah invoice apapun (pastikan pembayaran melalui kartu diaktifkan)
  2. Buka invoice
  3. Pilih pembayaran kartu
  4. Isi nomor kartu dengan 4000 0000 0000 0002, CVV apapun dan tanggal kadaluarsa di masa depan
  5. Invoice sudah sukses dibayar

Pertanyaan yang sering ditanyakan (FAQ)

  1. Bagaimana saya mengetahui bahwa Invoice saya sudah terbayar?

    • Status Invoice akan muncul sebagai PAID/SETTLED di Dashboard Anda
    • Xendit akan mengirimkan callback untuk pembayaran tersebut.
  2. Bagaimana saya mengetahui jika Invoice saya kadaluarsa?

    Ketika Invoice kadaluarsa, Anda dapat melihat status pembayaran di Dashboard Anda pada bagian invoice Jika Anda memilih untuk mengirimkan Invoice ke customer Anda, notifikasi email akan dikirimkan ke customer ketika Invoice kadaluarsa dan customer akan diinfokan agar tidak membuat pembayaran Kirimkan Get Invoice Request ke Xendit menggunakan API untuk melihat status Invoice Anda.

  3. Apa yang bisa saya lakukan terhadap Invoice yang sudah kadaluarsa? Bagaimana saya tau jika seseorang melakukan pembayaran ke Invoice tersebut?

    Ketika Invoice kadaluarsa, Anda dapat mengabaikan Invoice tersebut dan membuat Invoice baru. Invoice yang sudah kadaluarsa tidak dapat dibayar.

  4. Apa yang harus saya lakukan jika customer saya membayar nominal yang salah pada Invoice?

    Virtual Account pada Invoice merupakan Closed Amount, maka dari itu customer tidak akan dapat membayar nominal yang salah untuk Invoice.

  5. Apakah saya bisa merubah waktu kadaluarsa Invoice saya?

    Bisa, dengan maksimum durasi 1 tahun. Anda dapat mengubah durasi saat membuat invoice, baik melalui API maupun melalui dashboard. Ini adalah pengaturan yang bersifat tidak wajib. Ketika Anda mengosongkan hal tersebut, standar durasi yang berada pada custom invoice yang akan diterapkan. Mohon untuk dicatat bahwa invoice yang sudah dibuat tidak dapat diubah, meskipun Anda dapat membuat invoice kadaluarsa sehingga customer tidak dapat melakukan pembayaran.

  6. Tipe akun apa yang dapat membuat Invoice dari Dashboard?

    Akun yang dapat membuat Invoice adalah akun yang memiliki akes untuk Edit / merubah

  7. Bagaimana cara menentukan Bank dan metode pembayaran pada Invoice Saya?

    Anda dapat mengubah hal ini langsung melalui dashboard. Beberapa metode pembayaran membutuhkan aktivasi terlebih dahulu. Anda dapat menghubungi kami untuk proses aktivasi.

  8. Bagaimana Saya merubah tipe Virtual Account untuk Invoice Saya?

    Saat ini Anda hanya bisa melakukan perubahan ini melalui API. Anda juga dapat menghubungi kami untuk melakukan perubahan ini.

  9. Bagaimana Saya menempatkan nama dan gambar bisnis saya di Invoice?

    Jika Anda menggunakan tampilan Invoice Xendit, Anda dapat meletakkan nama dan logo bisnis melalui Dashboard Anda. Pergi ke Settings, unggah logo perusahaan Anda dan sesuaikan informasi Bisnisnya. Detail Invoice akan disesuaikan dengan konfigurasi Anda.

  10. Apakah saya bisa menggunakan tampilan saya sendiri untuk invoice Xendit?

    Ya, Anda dapat menggunakan tampilan Anda sendiri dengan mengintegrasikan dengan API Xendit.

  11. Apakah pembayaran kartu kredit merupakan metode pembayaran standar atau harus dikonfigurasi terlebih dahulu?

    Metode pembayaran kartu adalah metode standar dan akan secara otomatis muncul di Invoice sebagai salah satu metode pembayaran untuk pelanggan Anda.


Pemasangan Cepat

TLDR, Hal diatas terlalu panjang dan Anda malas membaca: Bila Anda memutuskan untuk melewati seluruh informasi diatas dan Anda menginginkan sesuatu yang lebih cepat dan sederhana, Anda dapat melakukan pengaturan cepat:

  1. Masukkan logo dan nama bisnis Anda di Dashboard > Settings > General
  2. Putuskan apakah Anda akan menggunakan API atau dashboard
    1. Bila Anda menggunakan API
      1. Menggunakan dokumentasi Dokumen API invoice
      2. Atur callback invoice Anda Dashboard > Settings > Configuration > Invoice
    2. Bila Anda menggunakan dashboard Dashboard > Invoice
  3. Saat Anda sudah bisa live mode, aktifkan VA yang Anda inginkan Dashboard > Settings > Configuration > Invoice
  4. Atur pengaturan standar invoice Anda di Dashboard > Invoice > Custom Invoice
  5. Invoice yang terbayar dan kadaluarsa akan langsung diperbaharui pada halaman invoice dashboard Anda