H2H

Autentikasi

Setiap request H2H membawa tiga kredensial akun merchant dan datang dari IP yang sudah di-whitelist.

Parameter wajib

ParameterKeterangan
merchant_idID Merchant dari akun H2H kamu, contoh ACN12345.
keyProduction Key. Tampil setelah verifikasi OTP 6 digit yang dikirim ke email akun, dan hanya terlihat 3 menit.
passwordPassword login akun. Kalau password login diganti, integrasi harus diperbarui.

Cara mengirim kredensial

Kirim lewat body (JSON atau form), atau lewat query string pada request GET:

GET https://aasardconnectid.biz.id/api/h2h/saldo?merchant_id=ACN12345&key=PRODUCTION_KEY&password=PASSWORD_LOGIN
Kredensial ikut terkirim di URL pada varian GET. Pakai HTTPS dan panggil hanya dari server kamu. Respons dikirim dengan Cache-Control: no-store dan query string tidak disimpan di log Permintaan.

Whitelist IP

  • Wajib. IP kosong atau tidak cocok = HTTP 403.
  • Maks. 50 IP publik per akun, diisi di Pengaturan > Whitelist IP.
  • Satu IP hanya boleh terdaftar di satu akun. Request dari IP milik akun lain ditolak.

Batas percobaan

  • 10 kali gagal login dari IP dan merchant yang sama dalam 10 menit = diblokir sementara.
  • Maks. 600 request per menit per IP.
  • Buat ulang Production Key atau Callback Secret dibatasi 3x per hari untuk masing-masing. Key lama langsung tidak berlaku.