--- title: SMS API slug: nicepay-api-messaging-sms-api description: Informasi tentang API SMS yang terdapat pada sistem Messaging NICEPAY image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/2p19l0Dev0heKne6MFEcx_nicepay-docs-logo.png icon: {"faIcon":"fa-solid fa-comment-sms"} docTags: createdAt: 2022-08-15T07:29:16.000Z --- Untuk dapat menggunakan produk SMS NICEPAY, Merchant perlu mengintegrasikan API ini dengan sistem pada Merchant. **SMS API** merupakan koleksi API NICEPAY yang dapat Anda gunakan dalam proses pengiriman SMS kepada Pelanggan Anda atau penerima pesan lainnya. # Alur Proses *** ![](https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/LKe96W66EWXEIjA-OFZVt_nicepay-archbee-payment-sms.png "Alur SMS API") 1. Merchant melakukan pendaftaran data. 2. Merchant mengirim data menggunakan API Registration kepada NICEPAY. 3. NICEPAY mendaftarkan data. 4. NICEPAY mengirimkan info data SMS kepada *service* NICE SMS. 5. NICE SMS mengirimkan informasi *response *data kepada NICEPAY. 6. NICEPAY mengirimkan info data kepada Merchant. 7. NICE SMS akan mengirimkan status info kepada NICEPAY. 8. NICEPAY melakukan proses info status data dan menyimpannya ke dalam DB. 9. NICEPAY mengirim notifikasi data kepada Merchant. 10. Merchant mengirim pengajuan informasi status kepada NICEPAY. 11. NICEPAY mengirimkan *response *info 200 - OK kepada Merchant. # Spesifikasi Integrasi *** | **Istilah** | **Deskripsi** | **Spesifikasi** | | --------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `Merchant` | Perusahaan e-Commerce atau toko yang menggunakan Layanan SMS NICEPAY | | | `Merchant Key` | Kunci autentikasi yang disediakan oleh NICEPAY | Harus aman | | `MerchantToken` | Token dari sisi NICEPAY | Jangan membuat Token dari sisi Klien | | `iMid` | Merchant ID | | | `tXid` | ID transaksi | | | `smsMsg` | Isi pesan | **Panjang Pesan**
NICEPAY akan menyediakan pengiriman pesan transaksi dalam satu transaksi hingga 640 karakter atau 4 Message transaksi, dengan detail sebagai berikut:
* 160 karakter = 1 pesan * Jika lebih dari 160 karakter, akan dihitung sebagai berikut: - Semua Telecom Operator (Non XL). - 161 - 320 karakter = 2 pesan. - 321 - 459 karakter = 3 pesan. - 481 - 640 karakter = 4 pesan. - XL Telecom Operator. - 161 - 306 karakter = 2 pesan. - 307 - 459 karakter = 3 pesan. - 460 - 612 karakter = 4 pesan.

**Karakter yang Berlaku**
* *Alphabets* (*lowercase*, *uppercase*) * *Number* * *Special Characters* `! @ $ * ( ) - + & _ = . , : ; / \ ? { } " %` (*space*) (*enter*) | | `smsType` | Untuk mendefinisikan tipe SMS yang dikirimkan | `0` : Normal SMS
`1` : Alert SMS
`2` : OTP SMS

Untuk SMS OTP, NICEPAY menjamin waktu pengiriman dari perusahaan ke Telco di bawah 300 detik dan OTP akan diturunkan ketika waktu pengiriman lebih dari 300 detik. | :::hint{type="info"} Untuk *Special Character* % harus diikuti oleh spasi. ::: # Macam-macam SMS API *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/SoKMtx5pTVqRtyb3DMynw_header-messaging-sms-api-sms-transmit.jpg"} [SMS Transmit](docId:0GwdGdsFm3-FGBHjsK7PO) API digunakan untuk mengirimkan SMS. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/tZ8yq84MbbF95ZOeIA1Vl_header-messaging-sms-api-notification-sms.jpg"} [Notification SMS](docId\:hcRdbFh-9v_6do48MShRg) API digunakan untuk memeriksa status pengiriman SMS. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/l445nK6Kcm2z5EhFrmzWw_header-messaging-sms-api-inquiry-sms.jpg"} [Inquiry SMS](docId:0bfa4LFEowD2edz37yLWh) API digunakan untuk memeriksa status pengiriman SMS yang berhasil. ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/ZHvSjR5ZrsoxwKbJa3xmo/CaSCeI1QRijZSsMGp1H28_header-messaging-sms-api-nicepay-code.jpg"} [NICEPAY Code - SMS API](docId\:N2oxXgoG4B2X3YNWn7r7A) adalah daftar kode yang digunakan dalam sistem API NICEPAY. ::: :::: # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi bagian [API SNAP](docId\:Rz9KHBT6vz0PGg0jszAgn) untuk mengetahui informasi terkait API dengan standar SNAP. ::: :::VerticalSplitItem Kunjungi halaman [FAQ NICEPAY API](docId\:ySpUrGl213ZdsUebbLSaG) jika ingin mengetahui pertanyaan yang sering diajukan terkait NICEPAY API. ::: ::::