---
title: "Request OAuth token"
method: POST
path: "/oauth/token"
---

# Request OAuth token

`POST /oauth/token`

Request an OAuth token from the Ratepay authorization server.

## Request body

- Request
  - `client_id` string, required — Client ID provided by Ratepay.
  - `client_secret` string, required — Client secret provided by Ratepay.
  - `audience` string, required — Specific resources and scope (environment). To access the API, use the URLs defined below. | STAGE | API | URL | | ----------- | -------------------------------------------- | ----------------------------------------------------------------------- | | Integration | Payment API | https://api-integration.ratepay.com/transaction/management | | Integration | Dispute API | https://api-integration.ratepay.com/dispute/management | | Integration | Webhook Subscriptions | https://api-integration.ratepay.com/webhook/management | | Integration | Bank Account Management API | https://api-integration.ratepay.com/shop/consumer/v1 | | Integration | Pay Later API | https://api-integration.ratepay.com/paylater | | Integration | Transaction Status API (For Payment API 1.8) | https://api-integration.ratepay.com/order/status/v2/transactions | | Integration | Transaction Status API (For Payment API 2.0) | https://api-integration.ratepay.com/transaction/status/v2/transactions | | Integration | Hosted Payment Page API | https://payment-integration.ratepay.com | | STAGE | API | URL | | ----------- | -------------------------------------------- | ----------------------------------------------------------------------- | | Production | Payment API | https://api.ratepay.com/transaction/management | | Production | Dispute API | https://api.ratepay.com/dispute/management | | Production | Webhook Subscriptions | https://api.ratepay.com/webhook/management | | Production | Bank Account Management API | https://api.ratepay.com/shop/consumer/v1 | | Production | Pay Later API | https://api.ratepay.com/paylater | | Production | Transaction Status API (For Payment API 1.8) | https://api.ratepay.com/order/status/v2/transactions | | Production | Transaction Status API (For Payment API 2.0) | https://api.ratepay.com/transaction/status/v2/transactions | | Production | Hosted Payment Page API | https://payment.ratepay.com |
  - `grant_type` string, required — The type of grant presented in the exchange. Use `client_credentials`.

## Response `200`

Successfully created an access token.

- ResponseGranted
  - `access_token` string
  - `expires_in` number
  - `token_type` string

## Other responses

- `401` — Invalid credentials.

---

[API](https://skmtc.dev/ratepay/apis/authentication-openapi-specification.md) · [All operations](https://skmtc.dev/ratepay/apis/authentication-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ratepay/authentication-openapi-specification/revisions/7c6b2aec150d/schema)