| name | paygent-cc |
| description | Paygentクレジットカード決済スキル。通常カード決済（トークン決済）、EMV 3Dセキュア 2.0、 継続課金（WooCommerce Subscriptions連携）、多通貨決済、デビット・プリペイド判定、 カード情報保存（トークナイゼーション）をカバー。 「paygent_cc」「WC_Gateway_Paygent_CC」「tds2」「3Dセキュア」「継続課金」「トークン決済」 「クレジットカード」「paygent_mccc」「多通貨」「addon-cc」などのキーワードで発動。
|
| compatibility | WooCommerce 9.0+ / WordPress 6.7+ / PHP 8.2+（現行安定版: WC 10.9 / WP 7.0）。 継続課金はWooCommerce Subscriptions必須。 EMV 3DS2は2025年3月末以降、原則すべてのEC加盟店で必須（クレジットカード・セキュリティガイドライン6.0版）。
|
Paygent クレジットカード決済
このスキルを使う場面
- クレジットカード決済フローの実装・修正（
class-wc-gateway-paygent-cc.php）
- EMV 3Dセキュア 2.0 の実装（
tds2_check、paygent_3ds2_redirect_order()）
- カード情報保存・削除（WooCommerceトークナイゼーション）
- WooCommerce Subscriptions 連携（継続課金）
- 多通貨カード決済（
class-wc-gateway-paygent-mccc.php）
- デビット・プリペイド判定
- 支払い方法の設定（1回払い/分割/ボーナス/リボ）
ファイル構成
includes/gateways/paygent/
├── class-wc-gateway-paygent-cc.php ← メインクレジットカード
├── class-wc-gateway-paygent-mccc.php ← 多通貨クレジットカード
└── class-wc-gateway-paygent-addon-cc.php ← 継続課金アドオン
ゲートウェイID
| クラス | ID |
|---|
WC_Gateway_Paygent_CC | paygent_cc |
WC_Gateway_Paygent_MCCC | paygent_mccc |
主要 telegram_kind（仕様書 v2.8.21 準拠）
| コード | 内容 |
|---|
020 | CC オーソリ申込（メイン決済電文） |
022 | CC 売上（出荷売上、キャプチャ） |
023 | CC オーソリ取消 |
025 | カード情報登録 |
026 | カード情報変更 |
027 | カード情報削除 |
028 | CC 売上取消（返金） |
029 | CC 補正（金額変更） |
094 | 決済情報照会 |
020 オーソリ申込 — 主要パラメータ
| パラメータ名 | 必須 | 内容 |
|---|
card_token | △ | JSトークンライブラリで生成したカードトークン |
stock_card_mode | ▲ | 0=通常, 1=カード情報保存 |
customer_id | △ | 保存カード使用時の顧客ID（25byte） |
customer_card_id | △ | 保存カードID（18byte） |
3dsecure_use_type | ▲ | 1=3DS1, 2=EMV3DS2.0 |
3ds_auth_id | △ | EMV3DS認証ID（36byte） |
sales_mode | ▲ | 0=オーソリのみ, 1=即時売上 |
payment_class | ▲ | 10=1回払い, 23=ボーナス, 61=分割, 80=リボ |
payment_amount | ○ | 決済金額 |
重要: 2017年4月以降契約の加盟店はカード番号の直接送信不可。必ずトークン（card_token）または保存カード（customer_card_id）を使用。
020 オーソリ応答 — 主要フィールド
| フィールド | 内容 |
|---|
result | 0=正常, 1=異常, 7=3Dオーソリ必要 |
payment_id | 決済ID |
fingerprint | 継続課金用フィンガープリント |
masked_card_number | マスクされたカード番号 |
3dsecure_message_version | 3DSメッセージバージョン |
result=7 の場合は EMV 3DS2.0フローへ移行。
支払い方法コード（payment_class）
| コード | 支払い方法 |
|---|
10 | 1回払い |
61 | 分割払い |
23 | ボーナス一括 |
80 | リボルビング |
supports（クレジットカード）
$this->supports = array(
'subscriptions',
'products',
'subscription_cancellation',
'subscription_reactivation',
'subscription_suspension',
'subscription_amount_changes',
'subscription_payment_method_change_customer',
'subscription_payment_method_change_admin',
'subscription_date_changes',
'multiple_subscriptions',
'tokenization',
'refunds',
'default_credit_card_form',
);
詳細は各referencesファイルを参照：
