API Docs

Base URL dan pola integrasi production

Seluruh trafik publik diarahkan ke gateway di https://api.bibanu.cloud/v1. Portal client, admin, teller, dan merchant mengakses API ini melalui subdomain `*.bibanu.cloud` sehingga origin produksi tetap konsisten.

Base URL

https://api.bibanu.cloud/v1

Gunakan prefix ini untuk seluruh endpoint publik production.

Health

GET /health

Endpoint probe standar untuk smoke test dan reverse proxy check.

Autentikasi

POST /auth/login
POST /auth/refresh
POST /auth/logout

Flow produksi menggunakan access token dan refresh cookie HttpOnly.

Quick Start

Contoh request paling dasar

Health Check

curl https://api.bibanu.cloud/v1/health

Login

curl -X POST https://api.bibanu.cloud/v1/auth/login \
  -H 'content-type: application/json' \
  -d '{
    "method": "PASSWORD",
    "identifier": "user@example.com",
    "password": "your-password",
    "device": { "fingerprint": "browser-or-device-id" }
  }'
Payment Gateway

Callback dan redirect production

Midtrans

notification_url=https://api.bibanu.cloud/v1/webhooks/midtrans
finish_redirect_url=https://app.bibanu.cloud/payment/finish
unfinish_redirect_url=https://app.bibanu.cloud/payment/unfinish
error_redirect_url=https://app.bibanu.cloud/payment/error

iPayMu

notify_url=https://api.bibanu.cloud/v1/webhooks/ipaymu
return_url=https://app.bibanu.cloud/payment/return
cancel_url=https://app.bibanu.cloud/payment/cancel
Portal Origins

Origin publik yang diizinkan

Environment production disiapkan untuk origin berikut agar CORS dan cookie refresh tetap berada dalam satu registrable domain cloud.