コンビニ決済 – 要注意なパラメータ

本ページは、コンビニ決済に対してパラメータを使用する場合に、注意すべき点の補足説明です。

事前に読むべきページ

このページでは、以下のページが読まれていることを前提として説明します。

課金作成時に以下記述をすることで、他の決済手段を含まず、コンビニ決済の手続きだけを消費者に行わせることができます。
また、役割の異なるパラメータが、意図せず適用されることを防げます。

実装方法	フィールド	値の例1（コンビニ決済のみ表示させたい場合）
ウィジェット（HTML / JavaScript）	`data-payment-methods` / `paymentMethods`	`konbini`
リンクフォーム	`paymentMethods[]`	`konbini`

実装方法	フィールド	値の例2（コンビニ決済かつ特定のコンビニエンスストアに限定したい場合）
ウィジェット（HTML / JavaScript）	`data-payment-methods` / `paymentMethods`	`seven_eleven,family_mart,lawson,mini_stop,seico_mart,pay_easy,circle_k,sunkus,daily_yamazaki,yamazaki_daily_store`
リンクフォーム	`paymentMethods[]`	`seven_eleven,family_mart,lawson,mini_stop,seico_mart,pay_easy,circle_k,sunkus,daily_yamazaki,yamazaki_daily_store`

この指定をしない場合は、利用可能なすべての決済手段が表示されます。
全てではなく、いくつか特定の決済手段を表示させたい場合は、それぞれの決済手段を指定してください。

コンビニ決済利用時に独自のはたらきをするパラメータを、抜粋して紹介します。

トランザクショントークン作成時および課金作成時に以下記述をすることで、任意の銀行振込の期限を指定できます。
トランザクショントークン作成時と課金作成時の両方で入金期限を指定した場合は、課金作成時の入金期限が優先されます。

課金作成時に以下記述をしてください。

実装方法	フィールド	値の例（2023/4/3 12:34:56までの場合）
ウィジェット（HTML / JavaScript）	`data-capture` / `capture` かつ `data-capture-at` / `captureAt`	`false` かつ `2023-04-03T12:34:56+09:00`
API	`capture_at`	`2023-04-03T03:34:56Z` ※国際規格（ISO 8601）で処理するため9時間の時差があります

トランザクショントークン作成時に以下記述をしてください。

実装方法	フィールド	値の例（2023/4/3 12:34:56までの場合）
API	`data.expiration_period` かつ `data.expiration_time_shift`	`P3D` かつ T12:34:56+09:00Z

課金作成時に以下記述をしてください。

実装方法	フィールド	値の指定例（3日後の12:34:56までの場合）
ウィジェット（HTML / JavaScript）	`data-expiration-period` / `expirationPeriod` かつ `data-expiration-time-shift` / `expirationTimeShift`	`P3D` かつ `12:34:56+09:00`
リンクフォーム	`expirationPeriod` かつ `expirationTimeShift`	`P3D` かつ `12:34:56+09:00` （または`12%3A34%3A56%2B09%3A00`）

課金作成時に以下記述をしてください。

実装方法	フィールド	値の指定例（3日後の12:34:56までの場合）
ウィジェット（HTML / JavaScript）	`data-convenience-store-expiration-period` / `convenienceStoreExpirationPeriod` かつ `data-convenience-store-expiration-time-shift` / `convenienceStoreExpirationTimeShift`	`P3D` かつ `12:34:56+09:00`
リンクフォーム	`convenienceStoreExpirationPeriod` かつ `convenienceStoreExpirationTimeShift`	`P3D` かつ `12:34:56+09:00` （または`12%3A34%3A56%2B09%3A00`）