paygent-carrier

name	paygent-carrier
description	Paygentキャリア決済スキル。auかんたん決済・d払い・ソフトバンクまとめて支払い(B)・ ワイモバイルまとめて支払い の都度課金と継続課金をカバー。 「paygent_mb」「WC_Gateway_Paygent_MB」「キャリア決済」「auかんたん決済」「d払い」 「ソフトバンク」「携帯決済」「career_type」「addon-mb」などのキーワードで発動。
compatibility	WooCommerce 9.0+ / WordPress 6.7+ / PHP 8.2+（現行安定版: WC 10.9 / WP 7.0）。 継続課金はWooCommerce Subscriptions必須。 各キャリアとPaygent経由で個別に契約が必要。

Paygent キャリア決済

このスキルを使う場面

• キャリア決済の実装・修正（class-wc-gateway-paygent-mb.php）
• career_typeによるキャリア判定とステータス管理
• キャリア別の取消・売上ロジック
• 継続課金（定期購入）実装

ファイル構成

includes/gateways/paygent/
└── class-wc-gateway-paygent-mb.php  ← キャリア決済（都度課金＋継続課金を1ファイルで管理）

ゲートウェイID

ID	説明
paygent_mb	キャリア決済（都度課金・継続課金共通）

career_type（キャリア種別）— PDF仕様書準拠

値	キャリア
4	auかんたん決済
5	d払い（ドコモ）
6	ソフトバンクまとめて支払い(B) / ワイモバイルまとめて支払い

コード内マッピング: 'docomo'→5, 'au'→4, 'sb'→6（set_career_type_num()）。
ユーザー選択: チェックアウトフォームの career_type POSTパラメータ（04/05/06の文字列で送信）。

主要 telegram_kind — 都度課金（PDF仕様書 v1.43 準拠）

コード	内容
100	携帯キャリア決済申込
101	携帯キャリア決済売上要求（消込）
102	携帯キャリア決済取消要求
103	携帯キャリア決済補正売上要求（減額）
104	携帯キャリア決済ユーザ認証要求（OpenID取得）
105	携帯キャリア決済OpenID解除要求
109	携帯キャリア決済dアカウント・ログアウト要求

主要 telegram_kind — 継続課金（PDF仕様書準拠）

コード	内容
120	携帯キャリア決済継続課金申込
121	携帯キャリア決済継続課金売上要求
122	携帯キャリア決済継続課金取消要求
124	携帯キャリア決済継続課金終了
125	携帯キャリア決済継続課金情報照会
126	携帯キャリア継続課金変更

100 申込 主要パラメータ

パラメータ名	必須	内容
career_type	○	キャリア種別（4/5/6）
amount	○	請求金額（payment_amountではない）
return_url	○	オーソリ通知URL（512byte）
cancel_url	○	キャンセルURL（512byte）
other_url	○(d払い)	d払い「購入画面へ戻る」URL
pc_mobile_type	○	端末区分（0=PC, 4=スマートフォン等）
open_id	△	OpenID（d払い/au必須条件あり）
outline	▲	商品摘要（包括契約では不要）

注意: キャリア決済申込の金額パラメータは amount（クレジット等の payment_amount ではない）。

100 申込 応答

• redirect_url: キャリア決済画面URL（au/d払い/SB(A)）
• redirect_html: キャリア決済POSTフォーム（d払い/SB等）

都度課金ステータス遷移

payment_status	内容
20	オーソリOK
21	オーソリ完了
32	オーソリ取消済
40	消込済
44	消込完了
60	売上取消済
62	取消完了

取消可能ステータス（キャリア別）

キャリア	取消可能なステータス
d払い	20（オーソリOK）, 21（オーソリ完了）, 40（消込済）
auかんたん決済	20（オーソリOK）, 40（消込済）
SB(B)/Y!mobile	20, 21（オーソリ系）, 40（消込済）

pc_mobile_type

値	端末
0	PC
1	フィーチャーフォン（docomo）
2	フィーチャーフォン（au）
3	フィーチャーフォン（softbank）
4	スマートフォン

詳細は carrier-payment.md と carrier-subscription.md を参照。