定期課金

定期課金は、定期的に顧客に課金を行うために使用されるコマンドです。定期課金のリクエストを行うためにトランザクショントークンを用いて作成されます。アカウントが審査済みでないと定期課金を作成することはできません。

定期課金は、作成時に指定された間隔で課金を行います。いつでもキャンセル可能です。課金に失敗すると、次の日に再度課金を行い、設定した回数連続で失敗した場合には、定期課金がキャンセルされます。

定期課金が作成されると、即時に課金が作成されます。

ウェブフックを用いて、定期課金イベントの通知を受け取ることを推奨します。支払いが成功した時はSUBSCRIPTION_PAYMENTイベント、支払いが失敗した時はSUBSCRIPTION_FAILEDイベント、定期課金がキャンセルされた時はSUBSCRIPTION_CANCELEDイベントで通知します。

新しいトランザクショントークンを用いて更新することで定期課金の支払い情報を更新することができます。unpaidの定期課金のトランザクショントークンを更新すると、即時に別の課金を作成します。

The subscription object

Fields
id	string (UUID) 定期課金のユニークID
store_id	string (UUID) 課金が行われたストアのユニークID
amount	number 課金金額
currency	string (ISO-4217) 課金通貨
amount_formatted	string 補助単位があれば、その小数の値を含む課金のリクエスト金額
initial_amount	number 初回の課金金額
initial_amount_formatted	string 補助単位があれば、その小数の値を含む初回の課金のリクエスト金額
schedule_settings.start_on	string (ISO-8601) 後続の支払いが開始される日付で、`YYYY-MM-DD` の形式で指定する。時刻は、`zone_id` で指定されたタイムゾーンの AM 9:00
schedule_settings.zone_id	string (IANA Timezone) 課金を実行する時刻が基準とするタイムゾーン
schedule_settings.preserve_end_of_month	boolean `period` が `monthly` で、`start_on` が月末だった場合、課金の実行日を月末に揃えます。例えば、`start_on` が `2018-06-30` の時、この値が `true` の場合は次の課金は `2018-07-31` になり、`false` の場合 `2018-07-30` になります
period	string 課金を行う頻度。 `daily`（毎日）, `weekly`（毎週）, `biweekly`（隔週）, `monthly`（毎月）, `annually`（毎年）のいずれか
installment_plan.plan_type	string 次のいずれかの値: `none`, `revolving`（リボ払い）, `fixed_cycles`（固定の回数の支払い）, `fixed_cycle_amount`（都度の課金額を固定にする）
installment_plan.fixed_cycles	number `plan_type` が `fixed_cycles` の場合、このフィールドは必須です。分割払いの回数を指定します。2以上を指定する必要があります。支払い回数：3回・5回・6回・10回・12回・15回・18回・20回・24回
installment_plan.fixed_cycle_amount	number `plan_type` が `fixed_cycle_amount` の場合、このフィールドは必須です。分割払いの1回毎の課金金額を指定します
next_payment.id	string (UUID) 支払いのID
next_payment.due_date	string (ISO-8601) 支払いが実行される日付。時刻は、`zone_id` で指定されたタイムゾーンの AM 9:00
next_payment.zone_id	string (IANA Timezone) 支払いを実行する時刻が基準とするタイムゾーン
next_payment.amount	number 課金金額
next_payment.currency	string (ISO-4217) 課金金額の通貨
next_payment.amount_formatted	string 補助単位があれば、小数の値を含む課金金額
next_payment.is_paid	boolean 支払いが完了したかどうか
next_payment.is_last_payment	boolean この支払が定期課金の最後の支払いかどうか。分割払いの場合のみ適用されます
next_payment.created_on	string (ISO-8601) この支払いの作成日時
payments_left	number 分割払の場合、残りの支払回数
amount_left	number 分割払いの場合、残りの支払金額
amount_left_formatted	string 分割払いの場合、補助単位があれば、その小数の値を含む、残りの支払い金額
status	string 定期課金の状態。 `unverified`（待機中：定期課金を作成し、初回課金の待機中） `unconfirmed`（作成失敗：定期課金作成のため初回課金を行うも決済失敗した状態。定期課金として稼働していない状態） `canceled`（永久停止：定期課金が完全停止（再開不可）の状態） `unpaid`（失敗停止：継続中の定期課金で課金を失敗した状態かつ次の日に再課金待ちの状態。リトライ待ち） `current`（継続中：現在稼働中の定期課金） `suspended`（一時停止：手動で「一時停止」ボタンを押した状態、または定期課金失敗回数を超えた状態） `completed`（完了：指定した課金回数分の決済が終わった状態）のいずれか
metadata	json 定期課金に紐づいているメタデータ。定期課金で作成されたメタデータがそれに関連する課金に渡されます。
mode	string `liveまたはtest`
created_on	string (ISO-8601) 定期課金が作成された日時