Testnet & faucet

Sandbox Hashpay memakai jaringan testnet sungguhan dengan token uji. Format API identik dengan produksi, jadi integrasi bisa dipindah hanya dengan mengganti base URL dan API key.

Base URL sandbox

https://api.hashpay.id/api/v2/testnet/

Token testnet

Alamat kontrak berikut adalah token uji (mock) yang bisa dimintai lewat faucet. Untuk daftar terbaru yang aktif di akun Anda, panggil GET /listToken.

Faucet

Faucet mengirim token uji dan sedikit gas native agar Anda bisa langsung mencoba alur pembayaran penuh di testnet.

curl -X POST https://api.hashpay.id/api/v2/testnet/faucet \
  -H "Content-Type: application/json" \
  -d '{
    "address": "0xYourTestWalletAddress",
    "network": "ETHEREUM",
    "tokens": ["USDT", "USDC"]
  }'

{
  "status_code": 200,
  "message": "success",
  "data": {
    "address": "0xYourTestWalletAddress",
    "network": "ETHEREUM",
    "transfers": [
      { "token": "USDT", "amount": "1000", "tx_hash": "0x..." },
      { "token": "USDC", "amount": "1000", "tx_hash": "0x..." }
    ],
    "warnings": []
  }
}

Batas faucet

Checklist sebelum produksi

• Ganti base URL ke /api/v2/mainnet/ dan pakai API key produksi.
• Pastikan webhook diverifikasi tanda tangannya dan idempoten.
• Uji skenario Underpaid, Expired, dan retry webhook.
• Pastikan notification_url memakai HTTPS dan dapat diakses publik.
• Jangan menyimpan API key di kode klien.