Buat Payout via API

Membuat Payout

Gunakan Create Payouts API untuk mengirim dana dari saldo akun Anda ke bank penerima atau akun e-wallet yang Anda tentukan.

Kami telah mengisi permintaan di bawah ini dengan contoh kunci API. Anda harus menggunakan kunci rahasia Anda yang dapat dibuat di Dasbor Anda. Setelah panggilan Anda mengenai server kami, kami membalasnya. Dengan asumsi semua input valid, kami akan mengembalikan pembayaran dengan status "ACCEPTED". Ini berarti bahwa kami telah menerima pembayaran. Jika Anda mendapatkan kesalahan, silakan lihat bagian Kesalahan kami untuk memahami alasannya.

{
  "reference_id". "test-transaction-010121",
  "channel_code": "ID_MANDIRI",
  "channelproperties": {
    "account_holder name: "Testing",
    "account-number": "1231231231231
  },
  "amount": 10000,
  "description": "Test Txn 001",
  "currency": "IDR"
}

Status pembayaran bisa dilacak menggunakan callback. Ketika pembayaran berhasil atau gagal, Anda akan menerima callback.

{
  "id": "disb-b4de62fb-e6b4-4260-8346-96a162e18e15",
  "amount": 10000,
  "channel_code": "ID_MANDIRI",
  "currency": "IDR",
  "description": "Test Txn 001",
  "reference_id": "test-transaction-010121",
  "status": "ACCEPTED",
  "created": "2022-01-20T03:45:23.637Z",
  "updated": "2022-01-20T03:45:23.637Z",
  "estimatedarrival_time": "2022-01-20T04:00:23.635Z",
  "business_id": "61075d264db00a40a9680753",
  "channelProperties": {
    "accountnumber": "1231231231231",
    "accountholder_name": "Testing"
  }
}

Jika pembayaran gagal karena alasan apa pun, bank akan mengembalikan uang tersebut dan kami akan mengembalikannya ke rekening Anda. Jika pembayaran tidak dapat diselesaikan, status pencairan akan "FAILED". Properti "failure_code" menunjukkan alasannya.

Batalkan Payout

Gunakan Cancel Payouts API untuk membatalkan transaksi yang belum diproses oleh partner Xendit.

Kami telah mengisi permintaan di bawah ini dengan contoh kunci API. Mirip dengan membuat pembayaran, Anda harus menggunakan kunci rahasia yang dibuat dari Dasbor untuk memulai permintaan pembatalan. Pembayaran ke bank dan e-wallet hanya dapat dibatalkan jika statusnya ACCEPTED. Direkomendasikan untuk merujuk ke Get Payout API untuk mengetahui apakah pembayaran masih dapat dibatalkan atau tidak. Atas permintaan pembatalan, kami akan mengembalikan respons dengan status “CANCELLED”. Ini berarti bahwa kami telah menerima permintaan pembatalan dan dana akan diharapkan kembali ke saldo Anda yang tersedia dalam waktu 5 menit.

{
  "id": "disb-faaOd8c5-b4fc-4fc4-8809-5981cae2c4cf",
  "amount": 50000,
  "channel_code": "ID_CHANNEL",
  "currency": "IDR",
  "description": "E2E OTC",
  "reference_id": "E2E-OTC",
  "status": "CANCELLED",
  "created": "2022-01-16T12:11:22.233Z",
  "updated": "2022-01-16T12:21:31.373Z",
  "estimated_arrival_time": "2022-01-16T12:26:22.155Z",
  "business_id": "61075d264db00a40a9680753",
  "channel_properties": {
    "payout_code": "9687530162381009082189137",
    "recipient_given_names": "Park Jimin",
    "recipient_surname": "Park Jimin",
    "expires_at": "2022-01-23T12:11:22.156Z"
  }
}

Jika pembatalan gagal karena alasan apa pun, kami akan mengirimkan kembali alasan kegagalan yang sesuai dan dana serta biaya akan tetap berada di saldo tertunda Anda hingga mencapai status akhir dari mitra (Berhasil atau Gagal). Alasan umum mungkin karena permintaan pembayaran yang tidak valid yang tidak ada, atau pembayaran sudah diproses oleh mitra.

Last Updated on 2023-06-30