コンビニ決済 導入ガイド

コンビニ決済について

電算システムを利用した決済サービスです。決済フォームでの情報入力が完了すると、指定したコンビニエンスストアで支払いを行うための情報が発行されます。支払いに必要な情報は、通知メールもしくはメタデータから確認可能です。
こちらの情報をもとに支払いを行うと、入金確認を自動で行い、結果を反映いたします。
また、管理画面の「ウェブフック」でURLを登録することによって、入金結果のシステム通知を受けることも可能です。

課金ステータス

管理画面の[決済]から申込や入金の履歴を確認することができます。

  • 処理待ち
    決済フォームから申込が完了しているが消費者からの入金がされていない、もしくは入金確認中の状態です。
  • 成功
    消費者が各コンビニエンスストアで入金を完了した状態です。
  • キャンセル
    加盟店さま側で申込を取り消した状態です。
  • 失敗
    決済フォームでの申込時に何かしらのエラーが発生した、もしくは入金期限を過ぎた状態です。

入金期限について

入金期限を超えた課金申込は失敗となり、決済失敗メールが送信されます。
後述するように様々な方法で入金期限を指定できますが、それぞれの日数ごとの入金期限日時について下記を参考にして下さい。

期限パターン例

一週間:
1/1 に申込を行った場合、1/8 23時59分までに振込

二週間:
1/1 に申込を行った場合、1/15 23時59分までに振込

30日:
1/1 に申込を行った場合、1/31 23時59分までに振込

入金期限の指定方法

管理画面、ウィジェット・インラインフォームのパラメータ、APIで入金期限を設定できます。

管理画面で指定
一般設定>決済サービス>決済方法 から、支払期限期間と入金期限時間を設定できます。
パラメータ、APIで指定しない限り、ここでの設定が適用されます。
デフォルトは30日、期限時間は23:59:59です。



ウィジェット・インラインフォームのパラメータで指定
HTMLとJavaScriptのパラメータで期間を指定可能です。

時間は”時刻+タイムゾーン”の形式で表します。

(タイムゾーンの例:日本であれば+09:00)


・HTML
 ※詳細はこちら
 入金可能期間:data-expiration-period=”P7D” (決済申込を行ってから何日間入金が可能か)

 入金期限時間:data-expiration-time-shift=”12:00:00+09:00″ (expiration-periodで入金期限日を決定し、期限日の何時まで入金を行えるか)

 入金期限日時:data-capture=”false”、data-capture-at=”2023-04-01 21:00″(申込日時に関わらず入金期限日時を指定)

・JavaScript
 ※詳細はこちら
 入金可能期間:expirationPeriod=”P7D” (決済申込を行ってから何日間入金が可能か)

 入金期限時間:expirationTimeShift=”12:00:00+09:00″ (expirationPeriodで入金期限日を決定し、期限日の何時まで入金を行えるか)

 入金期限日時:capture=”false”、captureAt=”2023-04-01 21:00″(申込日時に関わらず入金期限日時を指定)


APIで指定
APIのリクエストを送る際にパラメータで支払期限を指定できます。

・トランザクショントークンを作成時に指定
 data.expiration_period で支払いの有効期限を指定できます。最短30分、最大は60日(0:00に決済、59日後の23:59までで実質60日間)です。
 ※詳細はこちら

・課金を作成時に指定
 capture_at で支払い期限日時を指定できます。
 ここで期日を指定した場合、トランザクショントークンで指定した期間より優先されます。
 ※詳細はこちら

※日付および時間の指定は、両方/日付のみ/両方なし(パラメータを送信しない)のいずれかのパターンでリクエストしてください。

※下記支払先は、時刻指定がご利用いただけません。
・セブンイレブン
・セイコーマート/他支払(サークルK/サンクス/ペイジー)
この場合、時刻は無視されその日までという扱いになります。

テストについて

テストモードで決済を行った場合、申込が完了した後は処理待ちのステータスになります。
そして約10分後に自動的に成功のステータスへ変化します。

通知メールテンプレートについて

管理画面の[通知メールテンプレート]から、コンビニ決済に関する通知メールの内容を編集することができます。

  • コンビニ決済のご案内
    決済申し込みを行った際に送信されます。${konbini_payment_details}に各コンビニエンスストアでの支払い番号などが記載されます。
    ${date}では入金期日が表示されます。
  • コンビニ決済の取り消し
    ユーザーが入金を行う前に加盟店側で注文を取り消した際に送信されます。
  • コンビニ決済(各種コンビニ名)の詳細
    このテンプレートでは${konbini_payment_details}の内容をそれぞれ編集可能です。

    ※入金が完了した際には[決済完了通知]、支払い期限切れの場合は[決済失敗]の場合はメールをそれぞれ送信します。

「コンビニ決済のご案内」のテンプレート(デフォルト)

${store} コンビニ決済のお申し込みを受け付けました

=========================================================
このメールは決済されたメールアドレス宛に自動的に送信しております。
決済情報をご確認のうえ、大切に保管してください。
=========================================================

この度は、${store}をご利用いただき誠にありがとうございます。
内容をご確認の上、期日までにご入金をお願いいたします。
——————————————————————————————-
[支払方法 ] コンビニ決済
[コンビニ名] ${payment_brand}
[課金ID  ] ${charge_id}
[金額   ] ${amount}
[入金期限 ]${date}

${konbini_payment_details}

——————————————————————————————-
${store} お問い合わせ先情報
[電話番号   ] ${contact_phone}
[メールアドレス] ${contact_email}

※このメールは送信専用のため、このアドレスへご連絡いただいても返信できかねます。
 ご連絡はご利用の商品/サービス提供者様へお願いいたします。