OVO Auth API

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

Autentikasi OVO membutuhkan dua langkah: kirim OTP ke nomor HP terdaftar, lalu verifikasi kode beserta PIN OVO. 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 OVO.

Request Body

Field	Type	Required	Keterangan
`action`	string	Ya	Harus `ovo-send-otp`
`phoneNumber`	string	Ya	Nomor HP terdaftar di OVO
`providerCode`	string	Kondisional	`OVO` — 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": "ovo-send-otp",
  "phoneNumber": "081234567890",
  "providerCode": "OVO",
  "accountName": "OVO Utama",
  "intervalMinutes": 5,
  "verificationMethod": "WhatsApp"
}

Relogin / update:

{
  "action": "ovo-send-otp",
  "phoneNumber": "081234567890",
  "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": "ovo-send-otp",
    "phoneNumber": "081234567890",
    "providerCode": "OVO",
    "accountName": "OVO Utama",
    "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": "ovo-send-otp",
    "phoneNumber": "081234567890",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "verificationMethod": "WhatsApp"
  }'

Step 2 — Verifikasi OTP

POST /api/v1/accounts

Kirim kode OTP yang diterima bersama PIN OVO untuk menyelesaikan autentikasi.

OVO membutuhkan PIN di step verifikasi, berbeda dengan DANA yang meminta PIN di Step 1.