DANA Auth API

Halaman ini menjelaskan alur OTP khusus untuk DANA. Gunakan alur ini saat membuat akun DANA baru atau saat akun perlu relogin (biasanya karena sesi expired).

Autentikasi DANA membutuhkan dua langkah: kirim OTP ke nomor HP terdaftar, lalu verifikasi kode yang diterima. Simpan sessionId dari Step 1 karena dibutuhkan di Step 2.

Step 1 — Kirim OTP

POST /api/v1/accounts

Kirim OTP ke nomor HP yang terdaftar di DANA. Sistem akan mengirim kode verifikasi via WhatsApp atau SMS.

Request Body

Field	Type	Required	Keterangan
`action`	string	Ya	Harus `dana-send-otp`
`phoneNumber`	string	Ya	Nomor HP terdaftar di DANA
`pin`	string	Ya	PIN DANA (6 digit)
`providerCode`	string	Kondisional	`DANA` — wajib untuk akun baru
`accountName`	string	Kondisional	Label akun — wajib untuk akun baru
`intervalMinutes`	number	Kondisional	Interval sync (menit) — wajib untuk akun baru
`accountId`	string	Kondisional	UUID akun — wajib untuk relogin/update
`verificationMethod`	string	No	`WhatsApp` (default) atau `SMS`

Akun baru:

{
  "action": "dana-send-otp",
  "phoneNumber": "081234567890",
  "pin": "123456",
  "providerCode": "DANA",
  "accountName": "DANA Bisnis",
  "intervalMinutes": 5,
  "verificationMethod": "WhatsApp"
}

Relogin / update:

{
  "action": "dana-send-otp",
  "phoneNumber": "081234567890",
  "pin": "123456",
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "verificationMethod": "WhatsApp"
}

Response 200

{
  "success": true,
  "sessionId": "123e4567-e89b-12d3-a456-426614174000",
  "message": "OTP has been sent to your phone"
}

Simpan sessionId — nilai ini diperlukan di Step 2.

Errors

Status	Keterangan
`400`	Field wajib tidak lengkap
`400`	Provider tidak ditemukan atau tidak tersedia
`401`	API key tidak valid atau tidak ada
`500`	Internal server error

Contoh

# Akun baru
curl -X POST 'https://mutasiku.co.id/api/v1/accounts' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "dana-send-otp",
    "phoneNumber": "081234567890",
    "pin": "123456",
    "providerCode": "DANA",
    "accountName": "DANA Bisnis",
    "intervalMinutes": 5,
    "verificationMethod": "WhatsApp"
  }'

# Relogin / update
curl -X POST 'https://mutasiku.co.id/api/v1/accounts' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "dana-send-otp",
    "phoneNumber": "081234567890",
    "pin": "123456",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "verificationMethod": "WhatsApp"
  }'

Step 2 — Verifikasi OTP