---
title: "Get A Hosted Page Token"
method: POST
path: "/token"
---

# Get A Hosted Page Token

`POST /token`

Generate a hosted page token to embed in your hosted page. These tokens are limited scope tokens that allow the hosted page to be authenticated with our systems. Guide to use Ezypay Hosted Payment Page can be found [here](https://developer.ezypay.com/docs/payment-method-collection)

## Request body

- object
  - `grant_type` string, required — The OAuth 2 grant type you're requesting for. In this case, it should be `password`.
  - `client_id` string, required — Your `client_id` that you were provided with when you signed up.
  - `client_secret` string, required — Your `client_secret` that you were provided with when you signed up.
  - `username` string, required — The username of the merchant that you'll be requesting this token for.
  - `password` string, required — The password of the merchant that you'll be requesting this token for.
  - `scope` string, required — The scopes of the token that you're requesting for. In this case, it would be `integrator hosted_payment`.

## Response `200`

200

- object
  - `access_token` string
  - `token_type` string
  - `expires_in` integer
  - `scope` string

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/ezypay/apis/vault.md) · [All operations](https://skmtc.dev/ezypay/apis/vault/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ezypay/vault/revisions/2ca692551cdf/schema)