---
title: "Check GKash token availability"
method: GET
path: "/payment/gkash/token"
tags: ["payment"]
---

# Check GKash token availability

`GET /payment/gkash/token`

Check if a member has a valid GKash token (epkey) available for recurring payments. This endpoint:
    - Searches for the most recent successful GKash payment with an epkey for the member
    - Returns token availability status
    - Includes the epkey if available
    - Shows the last payment reference and date
    
    **Use Cases:**
    - Check if a member can make recurring payments
    - Verify token availability before initiating recurring payment
    - Display token status in member dashboard
    
    **Response:**
    - hasToken: true if epkey is available, false otherwise
    - epkey: The token value (only if hasToken is true)
    - lastPaymentRefNo: Reference number of the last successful payment with token
    - lastPaymentDate: Date of the last successful payment with token

## Query parameters

- `memberID` string
- `documentID` string

## Response `200`

Token status retrieved successfully

- GetTokenResponseDto
  - `success` boolean, required — Success status
  - `message` string, required — Response message
  - `data` object, required — Token availability data. memberID echoes the identifier that was sent; resolvedMemberID is the member_id stored on the matched payment, which differs when the caller sent an IC number or the record has member_id/document_id swapped.

## Other responses

- `400` — Bad request - memberID is required

---

[API](https://skmtc.dev/tonewow/apis/tonewow-database-api.md) · [All operations](https://skmtc.dev/tonewow/apis/tonewow-database-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tonewow/tonewow-database-api/revisions/f36472974ad4/schema)