KORAMP

Alur Transaksi

Alur Top Up dan Sell KORAMP: quote, pembayaran, konfirmasi, dan penyelesaian.

Gambaran Umum

KORAMP memiliki dua alur utama yang berbagi model quote yang sama:

  • Top Up (on-ramp): Rupiah masuk, crypto keluar.
  • Sell (off-ramp): crypto masuk, Rupiah keluar.

Keduanya melewati tahap quote, pembuatan order, verifikasi, dan penyelesaian.

Top Up (On-Ramp)Rupiah masuk → crypto keluar
Quote
Order
Bayar
Kirim Crypto
Selesai
Sell (Off-Ramp)Crypto masuk → Rupiah keluar
Quote
Order
Kirim Crypto
Konfirmasi
Payout

Alur Top Up

  1. Quote: pengguna meminta penawaran harga. Quote menyimpan harga pasar, spread, biaya layanan, biaya jaringan, dan pajak.
  2. Buat order: order Top Up dibuat dengan alamat dompet tujuan dan quote yang dipakai. Quote dikonsumsi secara atomik.
  3. Pembayaran fiat: sistem membuat order Xendit QRIS dan mengembalikan URL pembayaran.
  4. Webhook Xendit: Xendit mengirim notifikasi saat pembayaran berhasil.
  5. Pengiriman crypto: platform mengirim crypto ke dompet tujuan dan mencatat hash transaksi.
  6. Selesai: order berstatus selesai saat completedAt terisi.

Alur Sell

  1. Quote: pengguna meminta penawaran harga jual.
  2. Buat order: order Sell dibuat beserta alamat deposit platform dan detail bank payout per-transaksi.
  3. Deposit: pengguna mengirim crypto ke alamat deposit platform.
  4. Pemindaian dan konfirmasi: scheduler memindai deposit dan melacak confirmations hingga mencapai requiredConfirmations.
  5. Payout: setelah dikonfirmasi, fiat ditransfer ke rekening bank via Xendit Payout v3.
  6. Selesai: order berstatus selesai saat payout berhasil.

Status Order

  • Top Up: status bergerak dari CREATED menuju selesai; waktu selesai tercatat di completedAt.
  • Sell: status bergerak dari CREATED menuju selesai; jumlah konfirmasi on-chain dilacak lewat confirmations dan requiredConfirmations.

Gagal dan Kedaluwarsa

  • Quote memiliki waktu kedaluwarsa dan tidak dapat dipakai setelah itu.
  • Order yang tidak selesai dalam batas waktu dapat berakhir dengan alasan kegagalan (failureReason).
  • Webhook diproses secara idempoten untuk mencegah penanganan ganda.

Lihat Quote & Pricing untuk komponen harga.