지원 센터 · HyperClass TossPayments 지원 센터

한국 정식 연동 · 토스페이먼츠 KRW 결제

무엇이 궁금하신가요?
결제 연동, 여기서 해결됩니다.

HyperClass TossPayments는 하이퍼클래스 체크아웃·인보이스·구독에서 한국 원화(KRW)로 직접 결제를 받을 수 있게 해주는 커스텀 결제 연동 앱입니다. 설치, 설정, 결제·구독·환불에 대한 안내를 아래에서 확인하세요.

[email protected]

가장 빠른 문의 경로

Response

영업일 기준 24시간 이내

월~금 (KST)

Provider

주식회사 근하

Hyperclass AI 운영

시작하기

설치부터 첫 결제까지 5단계.

처음 연동하시는 분이라면 이 순서대로 진행하시면 됩니다.

STEP 01

앱 설치

하이퍼클래스 마켓플레이스에서 HyperClass TossPayments를 설치합니다. 에이전시 계정에서 설치하면 하위 서브계정에도 연동이 적용됩니다.

STEP 02

토스페이먼츠 키 입력

앱 상세 페이지의 설정(Settings) 화면에서 토스페이먼츠 클라이언트 키와 시크릿 키를 입력합니다. 처음에는 테스트(Test) 모드로 시작하시길 권장합니다.

STEP 03

연결(Connect)

저장하면 하이퍼클래스 체크아웃의 결제 옵션에 토스페이먼츠가 나타납니다. 결제 화면에서 Stripe 자리에 한국 결제창이 표시됩니다.

STEP 04

테스트 결제

소액(예: 1,000원) 테스트 결제로 결제 → 검증 → 주문 완료까지 흐름을 확인합니다. 테스트 모드에서는 실제 청구가 발생하지 않습니다.

STEP 05

운영 전환

토스페이먼츠 가맹점 심사가 완료되면 라이브(Live) 키로 전환하여 실제 결제를 받습니다.

지원 기능

이 앱이 처리하는 결제.

One-time

일회성 카드 결제

체크아웃·인보이스에서 토스페이먼츠 카드 결제를 원화로 즉시 처리합니다.

Recurring

정기 결제(빌링)

빌링키를 발급·저장해 매월/매년 자동으로 구독 요금을 청구합니다.

SaaS Mode

SaaS 구독 모드

하이퍼클래스 SaaS 모드의 무료 체험 → 자동 청구 흐름을 지원합니다.

Refund

환불 / 결제 취소

전체 환불을 토스페이먼츠 API로 처리하고 하이퍼클래스 주문 상태에 반영합니다.

자주 묻는 질문

먼저 여기를 확인하세요.

토스페이먼츠 가맹점 가입 후 개발자센터 → API 키에서 클라이언트 키와 시크릿 키를 확인할 수 있습니다. 테스트 키와 라이브 키가 별도로 발급되며, 라이브 키 사용에는 가맹점 심사 완료가 필요합니다. 가맹점 가입·서류 준비는 고객사가 직접 진행하셔야 합니다.

테스트 모드는 실제 청구 없이 결제 흐름을 검증하는 용도입니다. 라이브 모드는 실제 카드에서 청구가 발생합니다. 설정 화면에서 모드를 선택할 수 있으며, 각 모드에 맞는 키를 입력해야 합니다.

한국 원화(KRW) 결제를 지원합니다. 하이퍼클래스 서브계정의 통화 설정이 결제 금액과 일치하는지 확인하세요. USD로 설정된 일부 SaaS 지갑 충전 시나리오에서는 환율 변환이 적용되도록 구성되어 있습니다.

고객이 카드를 등록하면 토스페이먼츠 빌링키가 안전하게 발급·저장되고, 정해진 주기에 따라 자동으로 청구됩니다. SaaS 모드에서는 무료 체험 기간 동안 청구가 보류되며, 체험 종료 후 첫 청구가 자동 실행됩니다.

네, 정상입니다. 토스페이먼츠는 보안 정책상 빌링키 응답에 실제 카드 만료일을 포함하지 않습니다. 이 경우 12/99가 자리표시(placeholder)로 표시되며, 실제 결제에는 전혀 영향이 없습니다.

하이퍼클래스의 주문/결제 화면에서 환불을 요청하면 토스페이먼츠 환불 API로 전달되어 처리됩니다. 처리 결과는 하이퍼클래스 주문 상태에 자동 반영됩니다. 환불이 즉시 반영되지 않으면 잠시 후 새로고침하거나 지원팀에 문의하세요.

아래를 순서대로 확인하세요.

설정 화면에서 키를 저장하고 연결(Connect)이 완료됐는지
현재 모드(테스트/라이브)에 맞는 키를 입력했는지
해당 서브계정에 앱이 설치돼 있는지
브라우저의 팝업/iframe 차단이 활성화돼 있지 않은지

그래도 해결되지 않으면 서브계정 ID와 함께 지원팀에 문의해 주세요.

오류 메시지 해결

자주 보이는 메시지.

증상 / 메시지	원인 및 조치
결제는 됐는데 주문이 미완료(Pending)	결제 검증(verify) 단계가 지연됐을 수 있습니다. 잠시 후 새로고침하고, 반복되면 결제번호와 함께 문의하세요.
"키가 올바르지 않습니다" / 인증 오류	현재 모드(테스트/라이브)와 입력한 키의 종류가 일치하는지 확인하세요. 키 앞부분(test_ / live_)으로 구분됩니다.
정기 결제가 청구되지 않음	카드(빌링키) 등록이 완료됐는지, 구독이 체험 기간 중인지 확인하세요. 체험 종료 후 첫 청구가 자동 실행됩니다.
환불이 반영되지 않음	토스페이먼츠 쪽 처리 시간이 필요할 수 있습니다. 일정 시간 후에도 미반영이면 결제번호와 함께 문의하세요.

직접 문의

해결되지 않았다면
바로 연락 주세요.

위에서 답을 찾지 못하셨다면 이메일로 문의해 주세요. 서브계정 ID, 결제번호(있다면), 발생 화면을 함께 보내주시면 더 빠르게 도와드릴 수 있습니다.

헬프센터 바로가기 →

[email protected] 영업일 24시간 내 응답 한국어 · English

Native Korea integration · TossPayments KRW

How can we help?
Payments, sorted out here.

HyperClass TossPayments is a custom payment integration that lets you accept Korean Won (KRW) payments directly inside HyperClass checkout, invoices, and subscriptions. Find setup, configuration, payment, subscription, and refund guidance below.

[email protected]

Fastest way to reach us

Response

Within 24 business hours

Mon-Fri (KST)

Provider

Geunha Co., Ltd.

Operated by Hyperclass AI

Getting started

From install to first charge in 5 steps.

New to the integration? Follow this order.

STEP 01

Install the app

Install HyperClass TossPayments from the HyperClass Marketplace. Installing on an agency account cascades the integration to its sub-accounts.

STEP 02

Enter TossPayments keys

On the app's Settings page, enter your TossPayments client key and secret key. We recommend starting in Test mode.

STEP 03

Connect

After saving, TossPayments appears as a payment option in HyperClass checkout, taking the place where Stripe would normally be.

STEP 04

Run a test payment

Make a small test charge (e.g. ₩1,000) to confirm the pay → verify → order-complete flow. Test mode never charges real cards.

STEP 05

Go live

Once your TossPayments merchant review is complete, switch to Live keys to accept real payments.

Capabilities

What this app handles.

One-time

One-time card payments

Process TossPayments card charges in KRW directly from checkout and invoices.

Recurring

Recurring billing

Issue and store a billing key to charge monthly or yearly subscriptions automatically.

SaaS Mode

SaaS subscriptions

Supports HyperClass SaaS Mode free-trial to auto-billing flows.

Refund

Refunds / cancellations

Full refunds are processed via the TossPayments API and reflected in HyperClass order status.

FAQ

Check here first.

After signing up as a TossPayments merchant, find your client and secret keys under Developer Center → API Keys. Test and live keys are issued separately; live keys require merchant review approval. Merchant onboarding and documents are handled by you (the merchant).

Test mode validates the payment flow without real charges. Live mode charges real cards. Select the mode on the Settings page and enter the matching keys for that mode.

Korean Won (KRW) is supported. Make sure your HyperClass sub-account currency matches the charge amount. For certain USD-denominated SaaS wallet top-ups, a conversion is applied so the charged amount is correct.

When a customer registers a card, a TossPayments billing key is securely issued and stored, then charged automatically on schedule. In SaaS Mode, billing is held during the free trial and the first charge runs automatically when the trial ends.

No, this is expected. For security reasons, TossPayments does not return the real card expiry date in billing-key responses. In that case 12/99 is shown as a placeholder and has no effect on actual charges.

Request a refund from the HyperClass order/payment screen; it is routed to the TossPayments refund API and the result is reflected in the HyperClass order status. If a refund does not appear immediately, refresh after a moment or contact support.

Check the following in order:

Keys are saved and Connect completed on the Settings page
The keys match the current mode (Test / Live)
The app is installed on that specific sub-account
Browser popup / iframe blocking is not enabled

If it still fails, contact support with your sub-account ID.

Error messages

Messages you might run into.

Symptom / message	Cause & fix
Payment went through but order is Pending	The verify step may be delayed. Refresh after a moment; if it persists, contact us with the payment ID.
"Invalid key" / authentication error	Confirm the current mode (Test/Live) matches the entered key. Keys are prefixed with test_ / live_.
Recurring charge not billed	Check that a card (billing key) is registered and whether the subscription is still in trial. The first charge runs automatically when the trial ends.
Refund not reflected	TossPayments may need processing time. If it still doesn't show after a while, contact us with the payment ID.

Still stuck?
Reach out directly.

If you didn't find your answer above, email us. Include your sub-account ID, payment ID (if any), and where the issue occurred so we can help faster.

Go to Help Center →

[email protected] Reply within 24 business hours 한국어 · English