Toss Payments · Authentication Profile

Toss Payments Authentication

Authentication

Toss Payments secures its APIs with http across 1 declared security scheme, as derived from its OpenAPI definitions.

PaymentsPayment GatewaySouth KoreaCardsEasy PayVirtual AccountBillingCheckoutFintech
Methods: http Schemes: 1 OAuth flows: API key in:

Security Schemes

basicAuth http
scheme: basic

Source

Authentication Profile

Raw ↑ 
generated: '2026-07-12'
method: derived
source: openapi/toss-payments-openapi.yml
summary:
  types:
  - http
schemes:
- name: basicAuth
  type: http
  scheme: basic
  description: >-
    HTTP Basic authentication using a Toss Payments secret API key. The secret
    key is used as the username with an empty password, then Base64 encoded:
    `Authorization: Basic base64(secretKey:)` (note the trailing colon). Test
    secret keys are prefixed `test_sk_` / `test_gsk_`; live secret keys are
    prefixed `live_sk_` / `live_gsk_`. Browser-side client keys (`test_ck_` /
    `live_ck_`) are used by the JavaScript SDK / payment widget and do not
    authenticate Core API calls.
  sources:
  - openapi/toss-payments-openapi.yml
  - https://docs.tosspayments.com/en/api-guide