> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.epaygames.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.epaygames.io/_mcp/server. # Get Transactions GET https://api-stg.epaygames.io/v1/biller/transactions ### Get Transactions The **Get Transactions** endpoint retrieves a list of all transactions generated via the **Generate Transaction** endpoint. You can use this to check the actual status of a specific transaction. **Possible Statuses:** - `completed` - `pending` - `cancelled` > A transaction is marked as `cancelled` if it was canceled by the payment gateway, failed, or expired. **Response Fields:** - `provider_reference_no` — the upstream provider reference number; may be `null` or a string. - `other_reference_no` — an additional reference number; may be `null` or a string. #### Usage Tips Always filter by `reference_no` to look up the one transaction you care about — unfiltered or broadly-filtered listing is discouraged and being phased out. Prefer webhooks (`callback_webhook_url`) over polling for routine status tracking. Reference: https://docs.epaygames.io/payments-api/get-transactions ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: payments version: 1.0.0 paths: /v1/biller/transactions: get: operationId: Get Transactions summary: Get Transactions description: >- ### Get Transactions The **Get Transactions** endpoint retrieves a list of all transactions generated via the **Generate Transaction** endpoint. You can use this to check the actual status of a specific transaction. **Possible Statuses:** - `completed` - `pending` - `cancelled` > A transaction is marked as `cancelled` if it was canceled by the payment gateway, failed, or expired. **Response Fields:** - `provider_reference_no` — the upstream provider reference number; may be `null` or a string. - `other_reference_no` — an additional reference number; may be `null` or a string. #### Usage Tips Always filter by `reference_no` to look up the one transaction you care about — unfiltered or broadly-filtered listing is discouraged and being phased out. Prefer webhooks (`callback_webhook_url`) over polling for routine status tracking. tags: - '' parameters: - name: reference_no in: query description: >- Recommended. Look up a single transaction by the `reference_no` you supplied when creating it. This is the intended way to check a transaction's status — avoid unfiltered listing. required: false schema: type: string - name: provider_reference_no in: query description: >- Filter by the upstream provider's reference number, when you have it. required: false schema: type: string - name: channel in: query description: Filter by channel code (see Get Channels). required: false schema: type: string - name: status in: query description: Filter by transaction status. required: false schema: $ref: '#/components/schemas/V1BillerTransactionsGetParametersStatus' - name: date_from in: query description: >- Start of a date-range filter. Use sparingly — avoid combining date ranges with unbounded pagination for routine polling. required: false schema: type: string - name: date_to in: query description: End of a date-range filter. Use sparingly — see `date_from`. required: false schema: type: string - name: page in: query description: >- Legacy pagination. Works today, but don't build new integration logic around browsing pages of results — look up by `reference_no` instead. required: false schema: type: integer - name: per_page in: query description: Legacy pagination page size (max 100). See `page`. required: false schema: type: integer - name: Authorization in: header description: >- Bearer token obtained from the Create Token endpoint. Tokens are valid for ~60 minutes — cache and reuse a token for its full lifetime instead of re-authenticating per request. required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Get Transactions_Response_200' '401': description: Unauthorized — missing, invalid, or expired bearer token. content: application/json: schema: $ref: >- #/components/schemas/GetV1BillerTransactionsRequestUnauthorizedError servers: - url: https://api.epaygames.io description: Production - url: https://api-stg.epaygames.io description: Staging/Sandbox components: schemas: V1BillerTransactionsGetParametersStatus: type: string enum: - pending - completed - cancelled title: V1BillerTransactionsGetParametersStatus V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsStatus: type: string enum: - pending - completed - cancelled title: >- V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsStatus V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsCurrency: type: object properties: name: type: string code: type: string symbol: type: string required: - name - code - symbol title: >- V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsCurrency V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsChannelCategory: type: object properties: name: type: string description: type: string slug: type: string required: - name - description - slug title: >- V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsChannelCategory V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsChannel: type: object properties: name: type: string desciption: description: Any type instruction: type: string slug: type: string code: type: string logo: type: string category: $ref: >- #/components/schemas/V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsChannelCategory required: - name - instruction - slug - code - logo - category title: >- V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsChannel V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItems: type: object properties: subtotal_amount: type: number format: double service_fee: type: integer total_amount: type: number format: double reference_no: type: string provider_reference_no: description: Any type other_reference_no: description: Any type status: $ref: >- #/components/schemas/V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsStatus barcode_url: description: Any type qrcode_url: description: Any type link_url: description: Any type is_web_payment: type: boolean web_payment_url: type: string qrcode: description: Any type is_expired: type: boolean expires_at: type: string date: type: string items: type: array items: description: Any type currency: $ref: >- #/components/schemas/V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsCurrency channel: $ref: >- #/components/schemas/V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItemsChannel required: - subtotal_amount - service_fee - total_amount - reference_no - status - is_web_payment - web_payment_url - is_expired - expires_at - date - items - currency - channel title: >- V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItems V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataMeta: type: object properties: current_page: type: integer from: type: integer last_page: type: integer per_page: type: integer to: type: integer total: type: integer required: - current_page - from - last_page - per_page - to - total title: V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataMeta V1BillerTransactionsGetResponsesContentApplicationJsonSchemaData: type: object properties: transactions: type: array items: $ref: >- #/components/schemas/V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataTransactionsItems meta: $ref: >- #/components/schemas/V1BillerTransactionsGetResponsesContentApplicationJsonSchemaDataMeta required: - transactions - meta title: V1BillerTransactionsGetResponsesContentApplicationJsonSchemaData Get Transactions_Response_200: type: object properties: message: type: string data: $ref: >- #/components/schemas/V1BillerTransactionsGetResponsesContentApplicationJsonSchemaData required: - message - data title: Get Transactions_Response_200 GetV1BillerTransactionsRequestUnauthorizedError: type: object properties: message: type: string required: - message title: GetV1BillerTransactionsRequestUnauthorizedError securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer token obtained from the Create Token endpoint. Tokens are valid for ~60 minutes — cache and reuse a token for its full lifetime instead of re-authenticating per request. ``` ## Examples **Response** ```json { "message": "", "data": { "transactions": [ { "subtotal_amount": 0.01, "service_fee": 0, "total_amount": 0.01, "reference_no": "TESTQRKXINX7RJHF", "status": "pending", "is_web_payment": true, "web_payment_url": "https://l-stg.epayg.link/arymk3krslbpy74", "is_expired": false, "expires_at": "2025-09-02T09:58:40+08:00", "date": "2025-09-01T09:58:40+08:00", "items": [], "currency": { "name": "Philippine Peso", "code": "PHP", "symbol": "₱" }, "channel": { "name": "Maya", "instruction": "To complete the transaction, kindly follow these steps:\n 1. Open [Maya Web Payment Link](https://l-stg.epayg.link/arymk3krslbpy74).\n 2. Complete the **Maya** web payment process.\n 3. Payments are processed once paid.\nNote: You do not need to follow those steps if you already complete the **Maya** web payment process.", "slug": "paymaya", "code": "PAYMAYA_QR", "logo": "https://cdn.eplayment.co/payment-channels/paymaya.jpg", "category": { "name": "E-Wallet", "description": "E-Wallet payment channels.", "slug": "e-wallet" } } }, { "subtotal_amount": 0.01, "service_fee": 0, "total_amount": 0.01, "reference_no": "TESTQRVHHDOZZO2X", "status": "pending", "is_web_payment": true, "web_payment_url": "https://l-stg.epayg.link/arptbrkdgdppx74", "is_expired": false, "expires_at": "2025-09-02T09:52:55+08:00", "date": "2025-09-01T09:52:55+08:00", "items": [], "currency": { "name": "Philippine Peso", "code": "PHP", "symbol": "₱" }, "channel": { "name": "Maya", "instruction": "To complete the transaction, kindly follow these steps:\n 1. Open [Maya Web Payment Link](https://l-stg.epayg.link/arptbrkdgdppx74).\n 2. Complete the **Maya** web payment process.\n 3. Payments are processed once paid.\nNote: You do not need to follow those steps if you already complete the **Maya** web payment process.", "slug": "paymaya", "code": "PAYMAYA_QR", "logo": "https://cdn.eplayment.co/payment-channels/paymaya.jpg", "category": { "name": "E-Wallet", "description": "E-Wallet payment channels.", "slug": "e-wallet" } } }, { "subtotal_amount": 0.01, "service_fee": 0, "total_amount": 0.01, "reference_no": "TESTQRW1IRBWEMA7", "status": "pending", "is_web_payment": true, "web_payment_url": "https://l-stg.epayg.link/aretrs4auccrw74", "is_expired": false, "expires_at": "2025-09-02T09:46:51+08:00", "date": "2025-09-01T09:46:51+08:00", "items": [], "currency": { "name": "Philippine Peso", "code": "PHP", "symbol": "₱" }, "channel": { "name": "Maya", "instruction": "To complete the transaction, kindly follow these steps:\n 1. Open [Maya Web Payment Link](https://l-stg.epayg.link/aretrs4auccrw74).\n 2. Complete the **Maya** web payment process.\n 3. Payments are processed once paid.\nNote: You do not need to follow those steps if you already complete the **Maya** web payment process.", "slug": "paymaya", "code": "PAYMAYA_QR", "logo": "https://cdn.eplayment.co/payment-channels/paymaya.jpg", "category": { "name": "E-Wallet", "description": "E-Wallet payment channels.", "slug": "e-wallet" } } } ], "meta": { "current_page": 1, "from": 1, "last_page": 992, "per_page": 3, "to": 3, "total": 2975 } } } ``` **SDK Code** ```python Get Transactions_example import requests url = "https://api-stg.epaygames.io/v1/biller/transactions" querystring = {"reference_no":"TESTQRKXINX7RJHF"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript Get Transactions_example const url = 'https://api-stg.epaygames.io/v1/biller/transactions?reference_no=TESTQRKXINX7RJHF'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Get Transactions_example package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api-stg.epaygames.io/v1/biller/transactions?reference_no=TESTQRKXINX7RJHF" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Get Transactions_example require 'uri' require 'net/http' url = URI("https://api-stg.epaygames.io/v1/biller/transactions?reference_no=TESTQRKXINX7RJHF") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Get Transactions_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api-stg.epaygames.io/v1/biller/transactions?reference_no=TESTQRKXINX7RJHF") .header("Authorization", "Bearer ") .asString(); ``` ```php Get Transactions_example request('GET', 'https://api-stg.epaygames.io/v1/biller/transactions?reference_no=TESTQRKXINX7RJHF', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Get Transactions_example using RestSharp; var client = new RestClient("https://api-stg.epaygames.io/v1/biller/transactions?reference_no=TESTQRKXINX7RJHF"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Get Transactions_example import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api-stg.epaygames.io/v1/biller/transactions?reference_no=TESTQRKXINX7RJHF")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```