Biller Products
Mobile Prepaid
Espay provides an API for purchasing prepaid mobile online. For integration, you send a request to the Bill Inquiry service with the customer number and the selected product. Then, to complete the payment, you send a request to the Bill Payment service using the data returned from the Bill Inquiry. Learn more about Biller Product | Bill Inquiry and Biller Product | Bill Payment.
Download the Postman collection – Mobile Prepaid here.
Product Codes
XL
Smartfren
Three
Telkomsel
Bolt
Gopay
XL
| Product Code | Product Name | Transaction Type |
|---|---|---|
| SVHXR5 | XL 5.000 | PURCHASE |
| SVHXR10 | XL 10.000 | PURCHASE |
| SVHXR25 | XL 25.000 | PURCHASE |
| SVHXR50 | XL 50.000 | PURCHASE |
| SVHXR100 | XL 100.000 | PURCHASE |
| SVHXR200 | XL 200.000 | PURCHASE |
Smartfren
| Product Code | Product Name | Transaction Type |
|---|---|---|
| SVHFR5 | Smartfren 5.000 | PURCHASE |
| SVHFR10 | Smartfren 10.000 | PURCHASE |
| SVHFR20 | Smartfren 20.000 | PURCHASE |
| SVHFR25 | Smartfren 25.000 | PURCHASE |
| SVHFR30 | Smartfren 30.000 | PURCHASE |
| SVHFR50 | Smartfren 50.000 | PURCHASE |
| SVHFR75 | Smartfren 75.000 | PURCHASE |
| SVHFR100 | Smartfren 100.000 | PURCHASE |
| SVHFR150 | Smartfren 150.000 | PURCHASE |
| SVHFR200 | Smartfren 200.000 | PURCHASE |
| SVHFR225 | Smartfren 225.000 | PURCHASE |
| SVHFR300 | Smartfren 300.000 | PURCHASE |
| SVHFR500 | Smartfren 500.000 | PURCHASE |
Three
| Product Code | Product Name | Transaction Type |
|---|---|---|
| SVHTR1 | Three 1.000 | PURCHASE |
| SVHTR5 | Three 5.000 | PURCHASE |
| SVHTR10 | Three 10.000 | PURCHASE |
| SVHFR25 | Three 10.000 | PURCHASE |
| SVHTR20 | Three 20.000 | PURCHASE |
| SVHTR25 | Three 25.000 | PURCHASE |
| SVHTR30 | Three 30.000 | PURCHASE |
| SVHTR100 | Three 100.000 | PURCHASE |
| SVHTI5M | Three Internet 500 MB | PURCHASE |
| SVHTI1G | Three Internet 1 GB | PURCHASE |
| SVHTI2G | Three Internet 2 GB | PURCHASE |
| SVHTI5G | Three Internet 5 GB | PURCHASE |
Telkomsel
| Product Code | Product Name | Transaction Type |
|---|---|---|
| SVHTS5 | Telkomsel 5.000 | PURCHASE |
| SVHTS10 | Telkomsel 10.000 | PURCHASE |
| SVHTS20 | Telkomsel 20.000 | PURCHASE |
| SVHTS25 | Telkomsel 25.000 | PURCHASE |
| SVHTS50 | Telkomsel 50.000 | PURCHASE |
| SVHTS100 | Telkomsel 100.000 | PURCHASE |
Bolt
| Product Code | Product Name | Transaction Type |
|---|---|---|
| SVHBT25 | BOLT 25.000 | PURCHASE |
| SVHBT50 | BOLT 50.000 | PURCHASE |
| SVHBT100 | BOLT 100.000 | PURCHASE |
| SVHBT150 | BOLT 150.000 | PURCHASE |
| SVHBT200 | BOLT 200.000 | PURCHASE |
Gopay
| Product Code | Product Name | Transaction Type |
|---|---|---|
| SVHGJ20 | GO-PAY 20.000 | PURCHASE |
| SVHGJ25 | GO-PAY 25.000 | PURCHASE |
| SVHGJ30 | GO-PAY 30.000 | PURCHASE |
| SVHGJ40 | GO-PAY 40.000 | PURCHASE |
| SVHGJ50 | GO-PAY 50.000 | PURCHASE |
| SVHGJ75 | GO-PAY 75.000 | PURCHASE |
| SVHGJ100 | GO-PAY 100.000 | PURCHASE |
Bill Inquiry - Telkomsel 50.000
Sample Request
POST /rest/biller/inquirytransaction HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: ••••••
Content-Length: 222
rq_uuid=SANDBOXINQUIRYBILLER010102&
rq_datetime=2019-10-10%2011%3A01%3A30&
sender_id=SANDBOX&
password=test&
order_id=081218816222&
product_code=SVHTS50&
signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c
Sample Positive Response
{
"rq_uuid":"SANDBOXINQUIRYBILLER010102",
"rs_datetime":"2025-02-20 09:56:48",
"error_code":"0000",
"error_desc":"Success",
"order_id":"081218816222",
"amount":"5300000",
"bill_amount":"4950000",
"admin_fee":"350000",
"data":{
"denomination":"50",
"price":49500
},
"barcode_fee":""
}
Sample Negative Response
{
"rq_uuid":"SANDBOXINQUIRYBILLER010102",
"rs_datetime":"2025-02-14 13:58:45",
"error_code":405,
"error_desc":"product denied"
}
Bill Payment - Telkomsel 50.000
Sample Request
POST /rest/biller/paymentreport HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: ••••••
Content-Length: 240
rq_uuid=SANDBOXPAYMENTBILLERPULSA010102&
rq_datetime=2019-10-10%2011%3A02%3A30&
sender_id=SANDBOX&
password=test&
order_id=081218816222&
product_code=SVHTS50&
amount=50000&
signature=f46a2c34884c3d9194140f5ab595cae393749a0c5c25f23d2ebcfec3865196d1
Sample Positive Response
{
"rq_uuid":"SANDBOXPAYMENTBILLERPULSA010102",
"rs_datetime":"2025-02-20 10:25:31",
"error_code":"0000",
"error_desc":"Inproses",
"order_id":"081218816222",
"ref_id":"TX20250220102531589",
"data":{
"price":"50000",
"refnum":"TX20250220102531589",
"message":"Inproses"
},
"recon_ref":"TX20250220102531589",
"barcode_fee":"",
"receipt":{
"field":"SN",
"value":"TX20250220102531589"
}
}
Sample Negative Response
{
"rq_uuid":"SANDBOXPAYMENTBILLERPULSA010102",
"rs_datetime":"2025-02-14 14:00:27",
"error_code":405,
"error_desc":"product denied"
}
HTTP Bill Inquiry - Telkomsel 50.000
POST /rest/biller/inquirytransaction HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 222
rq_uuid=SANDBOXINQUIRYBILLER010102&rq_datetime=2019-10-10%2011%3A01%3A30&sender_id=SANDBOX&password=test&order_id=081218816222&product_code=SVHTS50&signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c
HTTP Bill Payment - Telkomsel 50.000
POST /rest/biller/paymentreport HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/x-www-form-urlencoded
Authorization: Basic ZXNwYXktdGVzdDp0ZXN0
Content-Length: 240
rq_uuid=SANDBOXPAYMENTBILLERPULSA010102&rq_datetime=2019-10-10%2011%3A02%3A30&sender_id=SANDBOX&password=test&order_id=081218816222&product_code=SVHTS50&amount=50000&signature=f46a2c34884c3d9194140f5ab595cae393749a0c5c25f23d2ebcfec3865196d1
CURL Bill Inquiry - Telkomsel 50.000
curl --location 'https://sandbox-api.espay.id/rest/biller/inquirytransaction' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic ZXNwYXktdGVzdDp0ZXN0' \
--data-urlencode 'rq_uuid=SANDBOXINQUIRYBILLER010102' \
--data-urlencode 'rq_datetime=2019-10-10 11:01:30' \
--data-urlencode 'sender_id=SANDBOX' \
--data-urlencode 'password=test' \
--data-urlencode 'order_id=081218816222' \
--data-urlencode 'product_code=SVHTS50' \
--data-urlencode 'signature=9d6eede295d8865adc9eefa3fc48c059d22773338b01284eb42ab688671a7c9c'
CURL Bill Payment - PLN Postpaid
curl --location 'https://sandbox-api.espay.id/rest/biller/paymentreport' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic ZXNwYXktdGVzdDp0ZXN0' \
--data-urlencode 'rq_uuid=SANDBOXPAYMENTBILLERPULSA010102' \
--data-urlencode 'rq_datetime=2019-10-10 11:02:30' \
--data-urlencode 'sender_id=SANDBOX' \
--data-urlencode 'password=test' \
--data-urlencode 'order_id=081218816222' \
--data-urlencode 'product_code=SVHTS50' \
--data-urlencode 'amount=50000' \
--data-urlencode 'signature=f46a2c34884c3d9194140f5ab595cae393749a0c5c25f23d2ebcfec3865196d1'