Biller Product

Check Phone Number Provider

Check Phone Number Provider merupakan layanan yang dapat Anda gunakan untuk mendapatkan kode grup dan nama provider berdasarkan nomor handphone yang Anda cari. Layanan ini bisa digunakan untuk menunjang produk prepaid pulsa.

Flow

Kirimkan parameter yang diperlukan dalam permintaan Anda, dan Espay Biller Product akan memberikan respons dalam format JSON.

API URL

Environment URL
Sandbox
https://sandbox-api.espay.id/rest/billertools/getmno
Production
https://api.espay.id/rest/billertools/getmno

Authorization

Setiap permintaan yang Anda kirim, harus menyertakan header Authorization menggunakan Basic Auth. Pelajari lebih lanjut Basic Auth.

Authorization: Basic {base64(username:password)}
Key Value
Method
HTTP Post
Connection
keep-alive
Content-Length
250
Content-Type
application/x-www-form-urlencoded
Accept
*/*

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
rq_uuid
String (255)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.

Format:
Sender_id + Unik ID

Contoh:
SENDERID123ABC-DEF456
rq_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server merchant.

Format:
YYYY-MM-DD HH:MM:SS

Contoh:
2024-12-17 12:30:45
sender_id
String (32)
Y
Kode identitas merchant yang diberikan oleh tim Espay.
password
String (32)
Y
Kata sandi yang diberikan oleh tim Espay.
phone_num
String (15)
Y
Nomor handphone customer.

Contoh:
+6281284620888, 6281284620888, 081284620888
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
rq_uuid
String (255)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.

Format:
Sender_id + Unik ID

Contoh:
SENDERID123ABC-DEF456
rq_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server merchant.

Format:
YYYY-MM-DD HH:MM:SS

Contoh:
2024-12-17 12:30:45
error_code
String (4)
Y
Kode respons.

Format:
  • Sukses: 0000
  • Gagal: xxxx
error_desc
String (128)
Y
Deskripsi respons.
operator
...
...
...
Y: Yes, O: Optional, C: Conditional









































Contoh Permintaan

POST /rest/billertools/getmno HTTP/1.1
Host: sandbox-api.espay.id
Content-Length: 176
Authorization: Basic RU5TRVZBTDprVXVYUjVNUkRtcHZrY1lk
Content-Type: application/x-www-form-urlencoded
  
rq_uuid=5326eaca-f715-f39f-36e1-432b1253cf49&
rq_datetime=2018-01-16 15:07:20&
sender_id=SENDERID&
password=p45w0rd&
phone_num=+6281284620888






















Contoh Respon Positif

{
   "rq_uuid":"5326eaca-f715-f39f-36e1-432b1253cf49",
   "rs_datetime":"2018-01-16 15:07:20",
   "error_code":"0000",
   "error_desc":"COMPLETED SUCCESFULLY",
   "operator":{
      "group_code":"GSVHTS",
      "provider_name":"TELKOMSEL"
   }
}


Contoh Respons Negatif

{
   "rq_uuid":"5326eaca-f715-f39f-36e1-432b1253cf49",
   "rs_datetime":"2025-10-14 16:19:41",
   "error_code":"EX",
   "error_desc":"Cannot map server service. Record not found"
}


HTTP

POST /rest/billertools/getmno HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 145

rq_uuid=5326eaca-f715-f39f-36e1-432b1253cf49&rq_datetime=2018-01-16%2015%3A07%3A20&sender_id=SENDERID&password=p45w0rd&phone_num=%2B6281284620888


CURL

curl --location 'https://sandbox-api.espay.id/rest/billertools/getmno' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic ZXNwYXktdGVzdDp0ZXN0' \
--data-urlencode 'rq_uuid=5326eaca-f715-f39f-36e1-432b1253cf49' \
--data-urlencode 'rq_datetime=2018-01-16 15:07:20' \
--data-urlencode 'sender_id=SENDERID' \
--data-urlencode 'password=p45w0rd' \
--data-urlencode 'phone_num=+6281284620888'
Scroll to Top