Biller Product

Get Phone Number Provider

Get Phone Number Provider is a service that allows you to obtain the group code and provider name based on the phone number you search. This service can be used to support prepaid mobile products.

Flow

Send the required parameters in your request, and Espay Biller Product will return a response in JSON format.

API URL

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

Authorization

Every request you send must include an Authorization header using Basic Auth. Learn more about Basic Auth.

Authorization: Basic {base64(username:password)}

Headers

Key Value
Method
HTTP Post
Connection
keep-alive
Content-Length
250
Content-Type
application/x-www-form-urlencoded
Accept
*/*

Request Parameters​

Parameter Type Mandatory Description
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

Response Parameters​

Parameter Type Mandatory Description
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









































Sample Request

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






















Sample Positive Response

{
   "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"
   }
}


Sample Negative Response

{
   "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