name: paygent-core description: > Paygent決済ゲートウェイの共通コア処理スキル。PaygentB2BModule経由のAPI通信、 認証情報管理、ハッシュチェック、エラーハンドリング、注文IDマッピング、Webhook受信、 デバッグログ、テスト環境設定など全決済手段で共有される基盤処理をカバー。 「paygent API」「telegram_kind」「PaygentB2BModule」「send_paygent_request」 「wc-paygent-mid」「ハッシュチェック」「WC_Gateway_Paygent_Request」などのキーワードで発動。 compatibility: > WooCommerce 9.0+ / WordPress 6.7+ / PHP 8.2+。 PaygentB2BModuleはvendor-wc/paygent/connect/に内包。 JP4WCフレームワーク v2.0.13を使用。

Paygent Core — 共通処理

このスキルを使う場面

• WC_Gateway_Paygent_Request クラスの実装・修正
• PaygentB2BModule を使ったAPI送受信処理
• ハッシュチェック（hcパラメータ）の実装
• 認証情報（merchant_id / connect_id / connect_password）管理
• 注文IDマッピング（trading_id / _paygent_order_id）
• Webhook受信エンドポイント（/wp-json/paygent/v1/check）
• テスト環境 / 本番環境の切り替え
• エラーコード処理・デバッグログ
• 全決済手段に共通するリファンド処理

ファイル構成（コア関連）

includes/gateways/paygent/
├── includes/class-wc-gateway-paygent-request.php  ← コアAPIクライアント
├── class-wc-paygent-endpoint.php                  ← WP REST API Webhook
vendor-wc/paygent/connect/src/paygent_module/
├── System/PaygentB2BModule.php                    ← Paygent公式モジュール
├── modenv_properties.php                          ← 本番環境設定
└── sandbox_modenv_properties.php                  ← テスト環境設定

共通ヘッダパラメータ（全電文 No.1〜7）

trading_id制約: 半角英数字とアンダーバーのみ（その他記号不可）、最大25byte、Paygent側では重複チェックなし。

文字コード

全Paygent API通信はShift_JIS (SJIS-win / Windows-31J)。

// リクエスト: UTF-8 → SJIS
$data = mb_convert_encoding( $data, 'SJIS', 'UTF-8' );

// レスポンス: SJIS → UTF-8
$value = mb_convert_encoding( $val, 'UTF-8', 'SJIS' );

認証情報（WordPress options）

クイックリファレンス

// API送信
$response = $this->paygent_request->send_paygent_request(
    $this->test_mode, $order, $telegram_kind, $send_data, $this->debug
);

// 結果判定
if ( '0' === $response['result'] ) {
    $payment_id = $response['result_array'][0]['payment_id'];
} else {
    // エラー: response_code / response_detail
    $this->paygent_request->error_response( $response, $order );
}

応答 result コード

決済情報照会 (094)

全決済手段共通の照会電文。payment_id または trading_id を指定して決済ステータスを取得。

詳細は api-communication.md と authentication.md を参照。