Xendit logo

xendit docs

Fixed Virtual Accounts

Deskripsi

Akun virtual tetap memungkinkan Anda membuat nomor rekening virtual 'tetap' yang unik untuk semua pengguna Anda. Ini sangat berguna bagi pengguna yang perlu mengirim dana secara sering, seperti pengguna dengan langganan berulang, karena mereka dapat mengirim dana ke nomor akun yang sama dan masih unik diidentifikasi oleh Xendit.

Jika Anda memilih untuk memiliki akun virtual yang ditugaskan kepada pengguna, maka pengguna tertentu akan diberikan virtual account yang dikhususkan untuk perusahaan anda dan dapat digunakan seterusnya. Misalnya, Bob akan selalu memiliki akun virtual BCA 02938-1234-567890 dan akan selalu menampilkan nama Bob ketika ia mencoba membayar akun virtual tersebut. Anda memiliki kontrol penuh atas nama yang muncul di akun saat pengguna mentransfer uang.

Nomor akun virtual adalah nomor akun 15 digit yang dihasilkan dari rentang yang ditentukan (mis. 02938-1001-111111). Xendit mendukung akun virtual untuk BCA, Mandiri, BRI, dan BNI. Kami menawarkan pelanggan baru 999,999 nomor rekening virtual untuk memulai. Jika Anda membutuhkan lebih banyak, silakan hubungi kami!

Pelanggan Anda dapat membayar akun virtual melalui ATM, mobile banking , dan internet banking . Xendit mengirim callback setiap kali akun virtual tetap ini dibayar, sehingga sistem Anda dapat diperingatkan secara otomatis.

Coba Sekarang

Cobalah Xendit API dalam hitungan detik di bawah ini. Buat invoice pertama Anda dan lihat bagaimana Anda dapat dengan mudah mendapatkan bayaran.

todoFIXED VIRTUAL ACCOUNT
todoPAYMENT
todoSUCCESS

Buat fixed virtual accounts (Create fixed virtual account)

Kami akan memulai dengan membuat fixed virtual account di BCA untuk Rika Sutanto.

Mari mulai dengan menjalankan permintaan curl di terminal Anda.


curl https://api.xendit.co/callback_virtual_accounts -X POST \
  -u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==: \
  -d external_id=demo_virtual_account_1475459775872 \
  -d bank_code=BCA \
  -d name='Rika Sutanto'

Proses fixed virtual account

todo

Penerapan fixed virtual account

Ikuti langkah-langkah di bawah ini untuk menerapkan API invoice kami.

todo

Go to Dashboard -> Settings -> Configurations -> Fixed Virtual Account, klik Tombol Aktifkan yang tersedia untuk setiap Bank. Setelah Anda mengkliknya, Anda akan mendapatkan Rangkaian Fixed Virtual Account

todo

Anda harus melakukanPOST request untuk tahap ini. Ini akan membuat fixed virtual accounts yang dapat didanai pengguna kapan saja. Pelajari lebih lanjut tentang parameter dalam dokumen referensi API kami.

  • Curl
  • PHP

curl https://api.xendit.co/callback_virtual_accounts -X POST \
  -u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==: \
  -d external_id=demo_virtual_account_1475459775872 \
  -d bank_code=BCA \
  -d name='Rika Sutanto'

<?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_1475459775872';
    $bank_code = 'BCA';
    $name = 'Rika Sutanto';

    $response = $xenditPHPClient->createCallbackVirtualAccount($external_id, $bank_code, $name);
    print_r($response); 
?>

Kami telah memenuhi contoh di atas dengan contoh kunci API. Jika Anda telah login , Anda akan melihat kunci tes khusus Anda. Hanya Anda yang dapat melihat kunci ini.

todo

Fixed virtual account API mengembalikan response , di bawah ini kami akan menjelaskan isi response nya

Response: 200


{
  "updated":"2016-10-07T01:35:46.658Z",
  "created":"2016-10-07T01:35:46.658Z",
  "owner_id":"57b4e5181473eeb61c11f9b9",
  "external_id":"demo-1475804036622",
  "bank_code":"BCA",
  "merchant_code":"02938",
  "name":"Rika Sutanto",
  "account_number":"029382548",
  "id":"57f6fbf26b9f064272622aa6"
}
PARAMETERDESKRIPSI
id

ID unik kami untuk fixed virtual account

owner_id

ID pengguna Anda

external_id

ID pilihan Anda yang kami tambahkan ke semua transaksi. Seringkali ID unik Anda seperti nomor telepon, email, atau ID transaksi.

merchant_code

Merchant Code akan menjadi awalan untuk nomor virtual account , misalnya 01234 nama_Anda

account_number

Ini adalah nomor virtual account lengkap (termasuk awalannya). Ini berfungsi seperti rekening bank dan apa yang pengguna perlu masukkan di internet banking / ATM untuk mengirim dana.

bank_code

Kode bank untuk bank yang relevan, mis. BCA

todo

Setelah pembayaran terpenuhi, kami mengirimkan callback untuk memberitahu Anda tentang keberhasilan pembayaran. Anda harus memberi kami URL callback . Di bawah ini kami mencantumkan contoh tentang bagaimana callback client mungkin terlihat dari sisi Anda.

  • PHP

<?php
    if ($_SERVER["REQUEST_METHOD"] === "POST") {
        $data = file_get_contents("php://input");

        print_r("\n\n $data contains the payment data\n\n");
        print_r($data);
        print_r("\n\nUpdate your database with the payment information \n\n");
    } else {
        print_r("Cannot ".$_SERVER["REQUEST_METHOD"]." ".$_SERVER["SCRIPT_NAME"]);
    }
?>

Verifikasi callback virtual account

Untuk memverifikasi apakah callback yang Anda terima berasal dari kami, Anda bisaGET request ini.

  • Curl

curl https://api.xendit.co/callback_virtual_account_payments/payment_id={payment_id} \
  -X GET \
  -u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==:

Anda bisa mendapatkanpayment_id Anda dari callback yang dikirim oleh Xendit. Xendit kemudian akan mengembalikan response di bawah ini.

Response: 200


{
  "id": "598d91b1191029596846047f",
  "payment_id": "1502450097080",
  "callback_virtual_account_id": "598d5f71bf64853820c49a18",
  "external_id": "demo-1502437214715",
  "merchant_code": "77517",
  "account_number": "1000016980",
  "bank_code": "BCA",
  "amount": 5000,
  "transaction_timestamp": "2017-08-11T11:14:57.080Z"
}
PARAMETERDESCRIPTION
id

ID callback pembayaran virtual account

payment_id

ID pembayaran sistem internal kami

callback_virtual_account_id

ID callback pembayaran virtual account yang sudah di bayar

external_id

External ID callback pembayaran virtual account

merchant_code

5 digit awal kode merchant virtual account lengkap

account_number

Nomor akun virtual account

bank_code

Kode Bank untuk nomer virtual account

amount

Jumlah yang dibayarkan ke pembayaran virtual account ini

transaction_timestamp

Tanggal waktu bahwa virtual account callback dibayar

Selamat! Itu saja - Anda sekarang siap menggunakan akun virtual tetap dengan Xendit.

Langkah selanjutnya

Pertanyaan?

Masih ada lebih banyak pertanyaan? Kami selalu senang membantu sebisa kami. Kirimkan kami email atau chat dengan kami di live chat .