Settlement

Settlement adalah proses menyapu dana dari alamat deposit pelanggan ke wallet settlement merchant Anda. Dana bisa disapu otomatis (terjadwal) atau dipicu manual.

Kapan dana disettle?

Otomatis: scheduler Hashpay menyapu order berstatus Success yang belum disettle, sesuai jadwal yang dikonfigurasi (mis. harian tengah malam).
Manual: Anda dapat memicu settlement kapan saja lewat endpoint di bawah (berguna saat testing atau kebutuhan operasional).

Jalankan settlement manual

POST/merchant/settlement

Header wajib: api-key.

bash

curl -X POST "$HASHPAY_BASE/merchant/settlement" \
  -H "api-key: $HASHPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "merchant_id": "10001" }'

Respons 200

{
  "status_code": 200,
  "message": "success",
  "data": {
    "scanned": 12,
    "swept": 10,
    "skipped": 2,
    "failed": 0,
    "messages": []
  }
}

Field	Arti
`scanned`	Jumlah order `Success` yang diperiksa
`swept`	Order yang dananya berhasil dipindahkan
`skipped`	Dilewati (saldo nol / jaringan belum didukung)
`failed`	Gagal (mis. gas tidak cukup) — lihat `messages`

Fee settlement

Biaya jaringan (gas) ditanggung operasional Hashpay. Fee platform sudah dipotong saat pembayaran (mode fee), sehingga final_amount pada order adalah jumlah bersih yang Anda terima.

Rekonsiliasi

Bandingkan order berstatus Success dengan isSettlement untuk melihat dana yang belum tersapu.
Gunakan tx_hash / link_explorer pada order untuk audit on-chain.
Webhook transaction.success adalah titik terbaik untuk mencatat penerimaan di sistem Anda (lihat Webhooks).