Check Status

API to check status.

Path

Method	Path
POST	api/v1/bill/check

Request Body

Attributes	Type	Description	Mandatory
commands	String	Value: `checkstatus`	Yes
username	String	Your registered phone number	Yes
ref_id	String	Your order number / reference ID	Yes
sign	String	Signature. Value: `md5(username+api_key+'cs')`	Yes

{
  "commands" : "checkstatus",
  "username" : "123123123",
  "ref_id"   : "091283746520",
  "sign"     : "6bc194c0d23c18a12f5d6919aa72bc30"
}

Response

Attributes	Type	Description	Mandatory
tr_id	Integer	IAK inquiry ID	Yes
code	String	Product code	Yes
datetime	String	Transaction time (Format YmdHis)	Yes
hp	String	Customer number	Yes
tr_name	String	Bill account name	Yes
period	String	Bill period	Yes
nominal	Double	Bill nominal	Yes
admin	Double	Admin fee	Yes
status	Integer	Transaction status. List of status : `0:Payment request haven't been received` `1:Payment success` `2:Payment failed` `3:Payment is being process`	Yes
response_code	String	Response code. See response code list	Yes
message	String	Message	Yes
price	Double	Total price that must be paid (nominal + admin fee)	Yes
selling_price	Double	Deducted balance (price - commission)	Yes
balance	Double	Client remaining balance	Yes
noref	String	Biller reference number (if exist)	No
ref_id	String	Your order number / reference ID ( must unique )	Yes
desc	Object Notes: If empty return String	Product description (See in each product segment)	Yes

Payment Success Response

{
  "data": {
    "tr_id": 9732795,
    "code": "TELKOMPSTN",
    "datetime": "20180803171608",
    "hp": "6391601202",
    "tr_name": "JAORAH",
    "period": "201405,201407",
    "nominal": 129610,
    "admin": 7500,
    "status": 1,
    "response_code": "00",
    "message": "PAYMENT SUCCESS",
    "price": 137110,
    "selling_price": 133510,
    "balance": 996850749,
    "noref": "1609626",
    "ref_id": "091283746520",
    "desc": {
      "kode_area": "0751",
      "divre": "01",
      "datel": "0006",
      "jumlah_tagihan": 3,
      "tagihan": {
        "detail": [
          {
            "periode": "MEI 2014",
            "nilai_tagihan": "49870",
            "admin": "2500",
            "total": 52370
          },
          {
            "periode": "JUN 2014",
            "nilai_tagihan": "44870",
            "admin": "2500",
            "total": 47370
          },
          {
            "periode": "JUL 2014",
            "nilai_tagihan": "34870",
            "admin": "2500",
            "total": 37370
          }
        ]
      }
    }
  },
  "meta": []
}

Payment Request Haven't Been Received Response

{
  "data": {
    "tr_id": 9732795,
    "code": "TELKOMPSTN",
    "datetime": "20180803171608",
    "hp": "6391601202",
    "tr_name": "JAORAH",
    "period": "201405,201407",
    "nominal": 129610,
    "admin": 7500,
    "ref_id": "091283746520",
    "status": 0,
    "response_code": "42",
    "message": "REQUEST PEMBAYARAN BELUM DITERIMA",
    "price": 137110,
    "selling_price": 133510,
    "balance": 996850749,
    "desc": {
      "kode_area": "0751",
      "divre": "01",
      "datel": "0006",
      "jumlah_tagihan": 3,
      "tagihan": {
        "detail": [
          {
            "periode": "MEI 2014",
            "nilai_tagihan": "49870",
            "admin": "2500",
            "total": 52370
          },
          {
            "periode": "JUN 2014",
            "nilai_tagihan": "44870",
            "admin": "2500",
            "total": 47370
          },
          {
            "periode": "JUL 2014",
            "nilai_tagihan": "34870",
            "admin": "2500",
            "total": 37370
          }
        ]
      }
    }
  },
  "meta": []
}

Payment Is Being Process Response

{
  "data": {
    "tr_id": 47794331,
    "code": "TELKOMPSTN",
    "hp": "6391601207",
    "tr_name": "CATH",
    "period": "202103",
    "nominal": 49870,
    "admin": 2500,
    "ref_id": "091283746520",
    "status": 3,
    "response_code": "39",
    "message": "PENDING \/ TRANSAKSI SEDANG DIPROSES",
    "price": 52370,
    "selling_price": 51170,
    "balance": 99995833900,
    "desc": {
      "kode_area": "0751",
      "divre": "01",
      "datel": "0006",
      "jumlah_tagihan": 1,
      "tagihan": {
        "detail": [
          {
            "periode": "MAR 2021",
            "nilai_tagihan": "49870",
            "admin": "2500",
            "total": 52370
          }
        ]
      }
    }
  },
  "meta": []
}

Payment Failed Response

{
  "data": {
    "tr_id": 47794331,
    "code": "TELKOMPSTN",
    "datetime": "20210316174828",
    "hp": "6391601207",
    "tr_name": "CATH",
    "period": "202103",
    "nominal": 49870,
    "admin": 2500,
    "status": 2,
    "response_code": "37",
    "message": "PEMBAYARAN GAGAL",
    "price": 52370,
    "selling_price": 51170,
    "balance": 99995833900,
    "noref": "",
    "ref_id": "091283746520",
    "desc": {
      "kode_area": "0751",
      "divre": "01",
      "datel": "0006",
      "jumlah_tagihan": 1,
      "tagihan": {
        "detail": [
          {
            "periode": "MAR 2021",
            "nilai_tagihan": "49870",
            "admin": "2500",
            "total": 52370
          }
        ]
      }
    }
  },
  "meta": []
}

Live Testing

Request URL

https://testpostpaid.mobilepulsa.net/api/v1/bill/check

Request Method

Request Header

Content-Type: application/json

Body

Result

Tutorial Video

You can see this video for check status code explanation using Laravel.

Or you can see this video for check status code explanation using PHP.

Non TelkomvisionPayment

CoreDownload Receipt