Lewati ke konten utama

Phone Verification & Update

Dokumentasi ini menjelaskan endpoint yang digunakan Frontend untuk memverifikasi atau mengganti nomor telepon utama pengguna (Customer). Proses penggantian nomor telepon dilakukan dalam Dashboard dan membutuhkan pengiriman OTP atau validasi tertentu di kemudian hari jika diperlukan.

Catatan Autentikasi: Endpoint ini bersifat internal dan wajib membawa Cookies otentikasi sesi JWT aktif.


1. Memperbarui Nomor Telepon

Ketika pengguna berada di halaman profil dan ingin memperbarui nomor ponsel mereka, Frontend dapat memanggil API verifikasi nomor telepon ini.

Request
POST /api/auth/profile/phone/verify
Content-Type: application/json
Request Body
{
"action": "change",
"new_phone": "08123456789"
}

Penjelasan Parameter:

  • action: Menandakan jenis tindakan yang sedang dilakukan. Saat ini nilai yang diterima adalah change untuk perubahan nomor ponsel.
  • new_phone: Nomor ponsel baru yang ingin digunakan oleh pelanggan. Anda bisa memformatnya sesuai dengan standar yang didukung (misalnya kode negara +62 atau 0).

Kondisi & Tindakan:

  • Sukses (200 OK): Backend berhasil memproses permintaan perubahan nomor telepon. Anda dapat menampilkan notifikasi statis "Nomor telepon berhasil diperbarui" kepada pengguna.
  • Error (400 Bad Request): Validasi nomor telepon gagal atau terdapat parameter action yang salah. Tampilkan pesan kesalahan kepada pelanggan di bawah form input terkait.