Changelog

Version 2

• Penghapusan Callback account.registered untuk Akun OWNED

Version 1

• Versi pertama dari API Akun

v1

Callback Pembaruan Akun

Endpoint: Callback Pembaruan Akun

POST https://yourcompany.com/xenplatform_callback_url

Callback Pembaruan Akun dapat digunakan untuk memberi tahu sistem Anda kapan Akun Anda berhasil terdaftar dan pembayaran langsung diaktifkan.

Contoh ini digunakan ketika parameter body yang digunakan pada API Xendit dikirimkan ke callback URL anda.

Anda akan menerima callback dari Create Account API pada 2 titik ketika proses pembuatan Akun:

Untuk akun OWNED

1. account.registered - Saat sebuah akun telah teregistrasi Catatan: Optional untuk menghandle Callback ini ketika membuat Akun OWNED menggunakan endpoint ini. Transaksi hanya dapat dibuat untuk OWNED secara langsung ketika kami telah mengembalikan response

Untuk akun MANAGED

1. account.registered - Saat sebuah akun telah teregistrasi
2. account.activated - Saat Anda sudah dapat melakukan transaksi secara real untuk Akun Anda (yaitu activated)

Silahkan atur callback URL yang pada halaman setting pada Dasbor Xendit anda untuk menerima callback ini. Anda juga bisa melakukan tes callback pada halaman pengaturan yang sama"

Ketika pembuatan akun berhasil diproses, Xendit mengirimkan pesan ke URL menggunakan metode POST secara langsung melalui callback. Xendit turut melampirkan x-callback-token header yang dapat Anda validasi dengan Token Verifikasi di Setelan Callback untuk mengecek keaslian pesan tersebut.

Kami harap sistem Anda dapat merespon callback dengan status 200 secepatnya. Xendit mengganggap callback gagal ketika kami tidak menerima respon dari sistem Anda selama 30 detik. Ketika pengiriman pesan gagal, maka upaya pengiriman ulang akan dilakukan secara otomatis sampai 24 jam kedepan. Anda juga dapat mengirimkan ulang pesan secara mandiri melalui tab Callback bila diperlukan. Terakhir, Anda juga dapat menerima email callback setiap 6 jam untuk mengecek sistem callback Anda secara berkala.

Pelajari lebih lanjut mengenai Callback.

Data Callback

Example: Callback Pembaruan Akun Request

{
  "master_acc_business_id": "5olefb170a2b18519b1b4801",
  "event_type": "account.registered",
  "created": "2021-01-01T10:00:00Z",
  "data": {
    "user_id": "5cafeb170a2b18519b1b8761",
    "account_info": {
      "payments_enabled": true
    }
  }
}

curl https://yourcompany.com/xenplatform_callback_url -X POST \
   -u xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==: \
   -d master_acc_business_id="5olefb170a2b18519b1b4801" \
   -d created="2019-01-01T10:51:44.484Z" \
   -d event_type="account.registered" \
   -d data[user_id]="57fb4e076fb3fa296b7f5a17" \
   -d data[account_info][payments_enabled]=false \

  <?php
      $url = 'https://yourcompany.com/xenplatform_callback_url';
      $apiKey = 'xnd_development_O46JfOtygef9kMNsK+ZPGT+ZZ9b3ooF4w3Dn+R1k+2fT/7GlCAN3jg==:';
      $headers = [];
      $headers[] = 'Content-Type: application/json';
      $data = [
          'master_acc_business_id' => '5olefb170a2b18519b1b4801'
          'created' => '2019-01-01T10:51:44.484Z',
          'event_type' => 'account.registered',
          'data' => [
            'user_id' => '57fb4e076fb3fa296b7f5a17',
            'account_info' => [
              'payments_enabled' => false
            ]
          ]
      ];

      $curl = curl_init();

      $payload = json_encode($data);
      curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
      curl_setopt($curl, CURLOPT_USERPWD, $apiKey.":");
      curl_setopt($curl, CURLOPT_URL, $url);
      curl_setopt($curl, CURLOPT_POST, true);
      curl_setopt($curl, CURLOPT_POSTFIELDS, $payload);
      curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

      $result = curl_exec($curl);
      echo $result;

Header Parameter	Tipe	Description
x-callback-token required	string	Token unik akun Anda yang dapat digunakan untuk mengecek keaslian pesan

Body Parameter	Tipe	Deskripsi
master_acc_business_id required	string	ID akun Platform anda
event_type required	string	Jenis tindakan callback yang dikirimkan Nilai yang tersedia: account.registered, account.activated
created required	string	Waktu ketika callback dikirimkan
data required	object	Memiliiki metadada untuk jenis tindakan string user_id required User ID dari sub-account object account_info required Info metadata akun

Account Info Metadata Object Parameters

Parameter	Tipe	Deskripsi
payments_enabled required	boolean	Nilai boolean yang menandakan ketika transaksi telah diaktifkan untuk Akun