Singapay Home Page
Logo Icon
  1. General
  2. List Bill Transaction

API Information

Title API List Bill Transaction
Version v1.0
URL Sandbox https://stg-pg.singapay.id
URL Production -

Version Control

Doc Version API Version Date Document Link Description
v1.0 v1.0 17 June 2025 - -

URL

HTTP method POST
Path /api/v1/list-bill-transaction
Type Format JSON

Endpoint

Request Description

Key Value Format M/O/C Length
command String M -
data.transaction_id String O -
data.customer_id String O -
data.status String O -
data.start_date String C -
data.end_date String C -
data.page String O -

Header Structure

Key Value Format M/O/C Length Description
X-PARTNER-ID <api_key> String M - -
Authorization Bearer <access_token> String M - -
Accept Application/json String M - -

Request & Response Payload Sample

Request

{
    "command": "list-bill-transaction",
    // "data": {  // nullable
    //     "transaction_id" : "01JWWX6AYA0MC4Y0EJTK3Y2Y6V",
    //     "customer_id" : "8888802379205901",
    //     "status" : "pending", // pending, success, refunded, failed
    //     "start_date" : "2025-06-01", // Y-m-d, required with end_date
    //     "end_date" : "2025-06-01" // Y-m-d, required with start_date
    //     "page" : "1"
    // }
}

Response

Success: Here’s an example of a successful response.

{
    "command": "list-bill-transaction",
    "response_code": "00",
    "response_text": "Operation completed successfully",
    "data": {
        "bill_transactions": [
            {
                "transaction_id": "01JXCQMCF879HYR72P4PJFBVRZ",
                "reference_number": "SPTKMSF2G30RJBL0096284584861749552869",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:54:29",
                "net_price": "32500",
                "display_price": {
                    "amount": "32500",
                    "price": "32500"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:54:29",
                "product": {
                    "code": "SPTKMSF2G30",
                    "name": "Telkomsel Data Flash 2GB 30hr"
                }
            },
            {
                "transaction_id": "01JXCQM034SPPZJXXGCYDFDYNT",
                "reference_number": "SPTLKMAS10RJBL0037010348781749552857",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:54:17",
                "net_price": "11000",
                "display_price": {
                    "amount": "11000",
                    "price": "11000"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:54:17",
                "product": {
                    "code": "SPTLKMAS10",
                    "name": "Telkomsel/As Pulsa 10.000"
                }
            },
            {
                "transaction_id": "01JXCQD87X3FMDG7DQBP5FXGG6",
                "reference_number": "SPTKMSF2G30RJBL0047125627661749552636",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:50:36",
                "net_price": "32500",
                "display_price": {
                    "amount": "32500",
                    "price": "32500"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:50:36",
                "product": {
                    "code": "SPTKMSF2G30",
                    "name": "Telkomsel Data Flash 2GB 30hr"
                }
            },
            {
                "transaction_id": "01JXCQAZ8Z8AT5YRAP3V66GR70",
                "reference_number": "SPTKMSF2G30RJBL0089842383881749552561",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:49:20",
                "net_price": "32500",
                "display_price": {
                    "amount": "32500",
                    "price": "32500"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:49:21",
                "product": {
                    "code": "SPTKMSF2G30",
                    "name": "Telkomsel Data Flash 2GB 30hr"
                }
            },
            {
                "transaction_id": "01JXCQAR5HST24K68JNK580RF0",
                "reference_number": "SPTLKMAS10RJBL0015111328211749552554",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:49:12",
                "net_price": "11000",
                "display_price": {
                    "amount": "11000",
                    "price": "11000"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:49:14",
                "product": {
                    "code": "SPTLKMAS10",
                    "name": "Telkomsel/As Pulsa 10.000"
                }
            },
            {
                "transaction_id": "01JXCQ95HM87HYYATZ2RG2E934",
                "reference_number": "SPTKMSF2G30RJBL0015892516121749552502",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:48:22",
                "net_price": "32500",
                "display_price": {
                    "amount": "32500",
                    "price": "32500"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:48:22",
                "product": {
                    "code": "SPTKMSF2G30",
                    "name": "Telkomsel Data Flash 2GB 30hr"
                }
            },
            {
                "transaction_id": "01JXCPZ6GQPCRP41D7KR8KH1J0",
                "reference_number": "SPTLKMAS10RJBL0045259561881749552175",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:42:55",
                "net_price": "11000",
                "display_price": {
                    "amount": "11000",
                    "price": "11000"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:42:55",
                "product": {
                    "code": "SPTLKMAS10",
                    "name": "Telkomsel/As Pulsa 10.000"
                }
            },
            {
                "transaction_id": "01JXCPSEFBHBMD7AVQ7M5RYXPX",
                "reference_number": "SPTLKMAS10RJBL0031673711171749551987",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:39:47",
                "net_price": "11000",
                "display_price": {
                    "amount": "11000",
                    "price": "11000"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:39:47",
                "product": {
                    "code": "SPTLKMAS10",
                    "name": "Telkomsel/As Pulsa 10.000"
                }
            },
            {
                "transaction_id": "01JXCPS1469Q8TEFEVPXNH6AM7",
                "reference_number": "SPTLKMAS10RJBL0032768589521749551973",
                "customer_id": "082291501085",
                "transaction_type": "prepaid",
                "status": "pending",
                "inquired_at": null,
                "paid_at": "2025-06-10 17:39:33",
                "net_price": "11000",
                "display_price": {
                    "amount": "11000",
                    "price": "11000"
                },
                "other_info": [],
                "created_at": "2025-06-10 10:39:33",
                "product": {
                    "code": "SPTLKMAS10",
                    "name": "Telkomsel/As Pulsa 10.000"
                }
            },
            {
                "transaction_id": "01JXCKJGK708T70DA0XDCBFF1M",
                "reference_number": "SPBPJSKSPOSRJBL0051066291251749548602",
                "customer_id": "8888802379205901",
                "transaction_type": "postpaid",
                "status": "pending",
                "inquired_at": "2025-06-10 16:43:22",
                "paid_at": "2025-06-10 16:43:32",
                "net_price": "72500",
                "display_price": {
                    "amount": "70000",
                    "price": "72500"
                },
                "other_info": [],
                "created_at": "2025-06-10 09:43:34",
                "product": {
                    "code": "SPBPJSKSPOS",
                    "name": "BPJS Kesehatan"
                }
            }
        ],
        "pagination": {
            "current_page": 1,
            "last_page": 2,
            "per_page": 10,
            "total": 19
        }
    }
}

Success: Here’s an example of when there is no transaction bill history

{
    "command": "list-bill-transaction",
    "response_code": "00",
    "response_text": "Operation completed successfully.",
    "data": {
        "bill_transactions": [],
        "pagination": {
            "current_page": 1,
            "last_page": 1,
            "per_page": 10,
            "total": 0
        }
    }
}

Failed: Here’s an example of an error auth response.

{
    "status": 401,
    "success": false,
    "error": {
        "code": 401,
        "message": "Unauthorized merchant, please sign in"
    }
}