Toss Payments
加盟店契約 & 連携
アプリ・ウェブで決済を受けるにはPG加盟店契約が必要です。 Toss Paymentsの申請から審査、テストキー → 本番キーへの切り替えまでご案内します。
加盟店契約
無料
審査期間
2–5営業日
必要書類
事業者登録証・通帳
Overview
始める前にご確認ください
PG加盟店契約は事業者登録が前提です。個人事業主も可能ですが、業種によっては追加書類(通信販売業申告証・医療・金融関連許認可)が必要になることがあります。まずテストキーで連携を完成させ、本番キーは加盟店審査完了後に発行されます。
事業者登録が必須
個人・法人いずれも可。
通信販売業申告
一般販売業は必須(区役所)。
精算口座
事業者名と一致した口座を準備。
サービスURL/アプリ
審査対象が実在している必要あり。
Step by Step
ステップ別ガイド
DEV FIRST
まずテストキーで連携
契約前にテストキーで決済フローを完成させると公開スケジュールを前倒しできます。
- docs.tosspayments.comに公開されているテストキーを利用
- 決済ウィジェット / 決済ウィンドウ / BrandPayなどから方式を選択
- 成功/失敗/キャンセルのコールバックURLを実装
- 国内カード・海外カード・口座振替・簡単決済をテスト可能
APPLY
加盟店申請書の作成
tosspayments.comで加盟店契約を申請します。
- 商号・代表者名・事業者登録番号・業種
- 販売品目と想定月間取引額
- サービスURL(公開前なら「準備中」+ スクリーンショットで可)
- 精算口座情報(事業者名と一致)
DOCS
必要書類のアップロード
基本+業種別の追加書類。
- 基本: 事業者登録証・代表者身分証・通帳の写し
- 一般販売: 通信販売業申告証
- 医療・医薬品: 関連許可証 / 免許証
- 飲食店: 営業申告証
- サービスのスクリーンショット2–3枚(決済フロー確認用)
FEE
手数料の協議
カード・簡単決済別の手数料率を契約書で確認します。
- 一般カード: 2.5–3.5%前後(取引額・業種で異なる)
- 簡単決済(Kakao Pay・Naver Payなど): 追加手数料
- 精算サイクル: D+1(翌営業日) / D+3 / D+7から選択
- 月間取引額が大きい場合は手数料の引き下げ交渉が可能
REVIEW
審査 & 承認
営業日で2〜5日ほどかかります。
- 書類補足依頼はメールで送信
- 一部業種(保険・投資・ゲーム・酒類)は追加審査
- 承認時に加盟店管理者アカウントが発行される
- 契約書は電子署名(Kakao認証など)で締結
LIVE KEYS
本番キーの発行
承認後に実決済が可能なキーを受け取ります。
- 加盟店管理ページ > APIキー
- クライアントキー: フロントの決済ウィンドウ呼び出し用(公開OK)
- シークレットキー: サーバーの承認・取消呼び出し用(絶対に公開しない)
- .envに分離してサーバーのみで使用
- テストキーと本番キーはprefixで区別される(test_* / live_*)
WEBHOOK
Webhookの登録
決済ステータスの変化をサーバーで即座に受信します。
- 加盟店管理 > 開発者センター > Webhook
- イベント: PAYMENT_STATUS_CHANGED, CANCEL_STATUS_CHANGEDなど
- エンドポイントURLを登録(HTTPS必須)
- 署名検証(Signature)ロジックを実装 — 偽造防止
SETTLEMENT
精算・税金計算書の自動化
精算明細と税金計算書を確認・ダウンロードします。
- 精算明細: 加盟店管理ページで日/月別に確認
- 税金計算書はToss Paymentsで自動発行
- 現金領収証は決済承認時に自動処理が可能
- Excelダウンロードまたは APIで精算を自動化
Pitfalls
詰まりやすいポイント
サービス未完成で審査依頼
最低でも決済フローのスクリーンショットかテストURLがないと通りません。「準備中」だけでは差し戻されやすいです。
精算口座名義の不一致
事業者登録証の商号・代表者名と通帳名義が違い差し戻されるケースが多いです。
シークレットキーのフロント露出
決済の承認・取消APIは必ずサーバーから呼び出してください。フロントから直接呼ぶと全取引が改ざん可能です。
Webhook署名検証の欠落
Webhookエンドポイントには誰でもPOSTできます。署名検証なしで状態を信じると決済回避の脆弱性になります。
アプリ内課金ポリシー
iOS・Androidアプリのデジタル商品は各ストアの IAP のみ許可。外部PGを使うとアプリがリジェクトされる可能性があります。