Perjalanan sebuah pesan
Setelah Anda mengirim, setiap penerima masuk antrean dan dikenai biaya (queued), lalu diserahkan ke rute operator (sent). Operator kemudian melaporkan apakah ponsel menerimanya (delivered) atau tidak (failed).
Kapan laporan tiba
Sebagian besar laporan tiba dalam hitungan detik hingga beberapa menit. Beberapa operator melapor terlambat atau tidak melapor sama sekali; pesan tanpa laporan tetap berstatus sent.
Pengembalian dana
Pesan yang gagal dikembalikan dananya ke saldo Anda secara otomatis. Anda dapat melihat setiap pengembalian dana di riwayat saldo, beserta id pesannya.
Menerima webhook
Tambahkan alamat https di halaman Kunci API. Saat pesan terkirim ke ponsel atau gagal, kami mengirim body JSON dengan POST berisi id pesan, nomor, status, harga, dan ref Anda. Jawab dengan status 2xx apa pun; jika tidak, kami mencoba ulang hingga 8 kali selama sekitar dua jam.
Memeriksa tanda tangan
Setiap webhook membawa X-PortSMS-Signature: t=<time>,v1=<hex>. Hitung HMAC-SHA256 dari teks t.body dengan signing secret Anda dan bandingkan dengan v1. Tolak permintaan yang lebih lama dari lima menit agar permintaan lama tidak dapat diputar ulang.
