開発者ツール ドキュメントAPI リファレンスPAY.JP Search⌘K ドキュメント PAY.JP v2 ドキュメント API リファレンスpayments.js リファレンスPAY.JPPAY.JP v2 ドキュメントAI 連携（llms.txt）API v1 からの移行について決済を受け付ける外部リンク型決済を使う埋め込み型決済を使う顧客に支払い方法を登録する顧客で決済する商品と価格 支払い方法カード決済 PayPay 決済 Apple Pay 決済 支払い状態の管理 売上と入金管理 開発者ツールpayjp-cliテストモードとライブモードテストカードイベントと Webhookエラーハンドリング冪等リクエストエラーレスポンス仕様メタデータpayments.js リファレンス SDKとコード 開発者ツール 開発者ツール PAY.JP の開発を支援するツールやリソース Copy MarkdownOpen 開発者ツール PAY.JP の開発を効率化するツール、テスト環境、イベント通知、エラー処理などのリソースを提供します。 CLI ツールとテスト ローカル開発環境での動作確認に使用します。payjp-cli を使えば、ローカル環境で Webhook を受信してイベント通知の処理をテストできます。テストカードを使えば、実際の決済なしに様々な決済結果やエラーケース、3D セキュア認証フローを再現できます。 payjp-cli PAY.JP連携開発のためのCLIツール テストモードとライブモード テスト環境と本番環境の違いと使い分け テストカード テスト環境で使用できるカード番号 イベントと Webhook 決済完了や返金処理など、PAY.JP 上でリソースの状態が変化したときにシステムへ通知を受け取る仕組みです。Webhook を設定することで、決済完了時の注文確定処理や、返金時の在庫復元処理などを自動化できます。 イベントと Webhook イベント通知と Webhook の検証方法 エラー処理 API リクエストが失敗した場合の対処方法を説明します。ネットワークエラーやタイムアウト時のリトライ戦略、二重決済を防ぐための冪等キーの使い方、エラーレスポンスの読み方などを学べます。 エラーハンドリング エラー処理、リトライ戦略、冪等性の活用 エラーレスポンス仕様 RFC 9457準拠のエラーレスポンス仕様 データ管理 PAY.JP のリソースに自社システムのデータを紐づける方法です。メタデータを使えば、支払いや顧客などのリソースに注文 ID や会員番号などの任意のデータをキーバリュー形式で保存できます。 メタデータ リソースに任意のデータを保存する機能 AI 連携 LLM（大規模言語モデル）や AI エージェントがドキュメントを効率的に読み取れる形式で提供しています。 AI 連携（llms.txt） LLM や AI エージェント向けのドキュメント取得機能 決済トランザクション 決済・返金・チャージバックなどの取引記録を管理する Payment Transaction について payjp-cli PAY.JP連携開発のためのCLIツール On this page 開発者ツールCLI ツールとテストイベントと Webhookエラー処理データ管理AI 連携