xendit docs

Instruksi Postman (Postman Instruction)

Postman adalah alat dengan HTTP client yang mempermudah untuk pengujian API dari web services yang ada. Postman menyediakan tampilan sederhana untuk membuat dan melihat API requests & responses . Untuk mempermudah integrasi dan pengujian dengan API kami, kami telah membuat koleksi Postman dari API kami.

Untuk menggunakan API kami, Anda akan membutuhkan akun Dasbor Xendit . Untuk mengikuti panduan ini, pastikan untuk sudah memiliki Postman sebelumnya.

Impor Koleksi

  1. Unduh API-Xendit.postman_collection.json dan simpan di komputer anda.
  2. Di Postman, tekan tombol Import di pojok kiri atas.
  3. Pilih koleksi API-Xendit.postman_collection.json yang sudah disimpan sebelumnya.
  4. Tab koleksi saat ini akan muncul koleksi Xendit!

Membuat Header Otorisasi

Koleksi Xendit dibuat dengan memanfaatkan keuntungan fitur Environment dari Postman, yaitu menukar isi antara Development dan Live key dengan mudah. Untuk menggunakan Environments , pertama-tama Anda perlu mengonversi Xendit Secret Key ke dalam Base64-encoded Authorization header. Postman menyediakan cara mudah untuk melakukan ini:

  1. Di dasbor Xendit, arahkan ke Settings > API Keys
  2. Di bawah Development Keys > Secret Key , klik 'Copy Key'
  3. Di Postman, buat tab baru dan pilih koleksi apa pun yang ingin Anda coba (pilih Create Invoice misalnya)
  4. Klik tab Authorization
  5. Pilih Basic Auth dari Type dropdown
  6. Salin Secret Key anda ke dalam Username
  7. Klik Preview Request
  8. Kunci otorisasi ini akan secara otomatis berada di tab header Anda

Membuat Environment

  1. Di Postman di kanan atas, klik ikon roda gigi > Manage Environments .
  2. Klik tombol Add untuk membuat environment baru.
  3. Beri nama seperti Xendit Testing
  4. Tambahkan header Authorization dan api-xendit (lihat tabel di bawah)
  5. Klik tombol Add untuk menyimpan
  6. Di kanan atas, pilih Xendit Testing Environment .
kunci nilai
Authorization

Authorization header Anda

api-xendit

https://api.xendit.co

Pengujian

Jika Anda dapat melakukan query dengan berhasil untuk saldo Anda, Anda telah berhasil menyiapkan semuanya! Lihat dokumen implementasi kami untuk pengujian lebih lanjut tentang:

Untuk Membuat Fixed Virtual Account

  1. Pilih environment yang diinginkan ( staging / development )
  2. Pilih Create Fixed Virtual Account di tab koleksi di bawah folder Bank Transfers
  3. Klik Send

Untuk Membuat Invoice

  1. Pilih environment yang diinginkan ( staging / development )
  2. Pilih Create Invoice di tab koleksi di bawah folder Bank Transfers
  3. Klik Send

Pertanyaan?

Masih memiliki pertanyaan? Dengan senang hati kami akan membantu anda. Hubungi kami di email atau live chat .

Postman is a HTTP client for testing web services which makes it easy to test APIs by providing a simple interface for making API requests & viewing responses. To make integrating with our API's easier, we've created a Postman collection of our APIs for easy testing.

To use our APIs, you'll need a free Xendit Dashboard account. To follow this guide, be sure to have Postman installed.

Import Collection

  1. Download API-Xendit.postman_collection.json and save it to your computer.
  2. In postman, click the Import button in the upper left.
  3. Select the API-Xendit.postman_collection.json collection that was just saved.
  4. The Collections tab should now show the Xendit collection!

Create Authorization Header

The Xendit Collection is built to take advantage of Postman Environments, which allows for easy switching between Development and Live keys. To use Environments, you'll first need to convert your Xendit Secret Key to a Base64-encoded Authorization header. Postman provides an easy way to do this:

  1. In Xendit Dashboard, navigate to Settings > API Keys
  2. Under Development Keys > Secret Key, click 'Copy Key'
  3. In Postman, make a new tab and choose any collection you would like to try (choose Create Invoice for example)
  4. Click the Authorization tab
  5. Choose Basic Auth from the Type dropdown
  6. Paste your Secret Key into the Username
  7. Click Preview Request
  8. This authorization key will be automatically be on your header tab

Creating Environment

  1. In Postman on the upper right, click the gear icon > Manage Environments.
  2. Click the Add button to create a new environment.
  3. Give it a name like Xendit Testing
  4. Add Authorization and api-xendit headers (see table below)
  5. Click the Add button to save
  6. In the upper right, select your new Xendit Testing environment.
key value
Authorization

Your Authorization header

api-xendit

https://api.xendit.co

Testing

If you can query your balance successfully, you've got it all set up! See our implementation docs for more testing on:

To create Fixed Virtual Account

  1. Select desired environment (staging / development)
  2. Select Create Fixed Virtual Account in the collections tab under Bank Transfer folders
  3. Click Send

To create invoice

  1. Select desired environment (staging / development)
  2. Select Create Invoice in the collections tab under Bank Transfer folders
  3. Click Send

Questions?

Still have more questions? We're always happy to help however we can. Shoot us an email or chat to us in live chat.