Verifikasi ulang merek pengiriman pesan

Periksa kembali identitas bisnis yang telah diperbaiki

Gunakan operasi ini ketika informasi identitas yang telah diperbaiki pada merek organisasi yang sudah ada perlu diperiksa kembali. Pertama, perbarui merek yang sudah ada, lalu baca status identitasnya saat ini. Pembaruan profil biasa tidak mengajukan upaya berbayar terpisah ini. Verifikasi ulang tidak membuat merek lain atau mendaftarkan kampanye.

Gunakan akun API aktif milik Anda sendiri melalui HTTPS dari IP sumber yang diizinkan. Merek harus dimiliki oleh akun tersebut. Jaga kerahasiaan catatan merek: catatan tersebut memuat informasi bisnis dan kontak.

Tinjau merek sebelum mengajukan permintaan

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
  --output current-brand.json

Pastikan merek yang dikembalikan adalah bisnis yang dimaksud dan perbaikannya sudah tercantum. Pendaftaran awal yang masih tertunda belum dapat diverifikasi ulang. Registri dapat menolak permintaan jika informasi bisnis tidak berubah. Atribut khusus yang belum tersedia mungkin memerlukan banding, bukan pemeriksaan identitas lagi. Merek usaha perseorangan menggunakan alur identitas/PIN yang sesuai; jangan menganggap endpoint ini sebagai penggantinya.

Konfirmasikan biaya terpisah

Biaya verifikasi ulang di lingkungan produksi yang saat ini dikonfigurasi adalah US$5.00 per upaya yang diterima, diperiksa pada 24 Oktober 2026. Biaya ini menggunakan tarif merek standar, termasuk ketika entitas awal memiliki harga pendaftaran yang berbeda. Pembelian harus diaktifkan; akun prabayar memerlukan saldo yang cukup sebelum pengajuan.

Respons 202 berarti permintaan diterima untuk diproses lebih lanjut, dan pemrosesan biaya dipicu saat permintaan diterima. Ini tidak berarti bisnis sudah terverifikasi. Upaya baru di kemudian hari dapat dikenai biaya lagi. Jangan membuat upaya baru hanya karena verifikasi masih tertunda.

Ajukan satu upaya yang dimaksud

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"

Isi permintaan berupa profil tidak diperlukan: operasi ini memeriksa detail merek yang sudah tersimpan. Gunakan kunci idempotensi unik untuk upaya yang dimaksud, dan pertahankan metode, jalur, kueri, serta isi permintaan yang persis sama saat mencoba ulang. Kunci mendukung 1–128 karakter ASCII yang dapat dicetak tanpa spasi. Duplikat dari upaya yang masih diproses dapat mengembalikan 409 dengan Retry-After; upaya yang sudah selesai dapat mengembalikan kembali hasil tersimpannya, termasuk kesalahan.

API publik juga menerima autentikasi Bearer untuk akun token yang aktif. Pemeriksaan kepemilikan akun dan IP sumber yang diizinkan tetap berlaku. Merek tiruan yang tersimpan melewati alur biaya produksi ini, tetapi hasil lingkungan uji bukanlah verifikasi identitas di lingkungan produksi.

Baca hasil dan pantau statusnya

Respons verifikasi ulang
Respons	Arti dan tindakan selanjutnya
200	Permintaan berhasil. Periksa merek yang dikembalikan dan baca kembali catatan merek terkini untuk memastikan status identitasnya.
202	Diterima, menunggu verifikasi lebih lanjut. Simpan ID merek dan periksa status terkininya nanti tanpa mengajukan upaya berbayar lagi.
400	Tinjau kesalahan registri yang dikembalikan. Pendaftaran awal mungkin masih tertunda, profil mungkin tidak berubah, atau aturan validasi lain mungkin berlaku.
401 / 404	Periksa kredensial dan IP yang diizinkan, atau ID merek milik akun tersebut.
402 / 503	Tinjau kesalahan lokal terkait pembelian/pendanaan atau penetapan harga/layanan. Jangan menganggap setiap 503 membuktikan bahwa tidak ada permintaan yang dikirim ke layanan hulu.
429	Patuhi Retry-After dan pertahankan detail upaya yang sama.

Proksi memperbarui catatan merek lokalnya setelah suatu perubahan diterima; pembaruan itu sendiri tidak membuktikan hasil verifikasi akhir. Bisnis dapat tetap belum terverifikasi atau tertunda. Gunakan status merek terkini, bukan hanya penerimaan HTTP, sebelum melanjutkan penyiapan kampanye.

Pastikan hasil yang belum jelas

Kegagalan transportasi data dapat menghasilkan 502 yang disimpan dalam cache. Permintaan yang diterima di layanan hulu lalu diikuti kegagalan penyimpanan permanen lokal atau penagihan dapat menghasilkan 500 yang disimpan dalam cache beserta requestId. Simpan pengenal tersebut dan cocokkan keadaan merek serta penagihan terkini bersama tim dukungan. Membuat kunci lain dapat menghasilkan upaya yang ditagih secara terpisah; jangan sembarang mencoba ulang dengan kunci baru.

Menggunakan portal pelanggan

Portal menyediakan verifikasi ulang untuk organisasi produksi berstatus UNVERIFIED setelah profil dan biaya terkini ditinjau. Portal memeriksa bahwa profil dan harga tidak berubah serta menolak pengajuan tambahan yang akan diterima untuk detail terkini yang sama. Merek lingkungan uji dan usaha perseorangan tidak disertakan dalam tindakan portal ini.

Pengamanan portal tersebut merupakan pemeriksaan alur kerja tambahan. Klien API langsung harus melakukan peninjauan sendiri dan tidak boleh menganggap API mewajibkan kolom versi atau konfirmasi harga milik portal. Menyimpan perbaikan merek biasa merupakan tindakan terpisah dan tidak otomatis mengajukan verifikasi ulang.