planオブジェクトが設定されている場合、次回サイクル更新時に指定のプランへと自動的に切り替えし、課金を試みます。プランの切り替えは必ず行われますが、課金の有無は切り替わるプランの設定に依ります。切り替えが実施されたタイミングでこの値はnullとなります。場合のみ支払い処理が行われます。Integer現在の購読期間開始時のタイムスタンプ原則として、定期課金は前払い式であり、課金が行われた時点から周期が開始します。}}顧客IDとプランIDを指定して、定期課金を開始します。前払い式のため、定期課金作成時に最初の課金が実行されます。以下の場合には作成時の課金はされません。顧客ID定期課金はデフォルトカードに請求が行われますので、デフォルトカードが存在しない顧客を指定した場合はエラーとなります。これにより、プラン情報を上書きするトライアル設定が可能です。未来のタイムスタンプを指定した場合、トライアル状態(status=trial)で定期課金が作成されます。そこを基準としてプランに沿ったサイクルで定期課金が更新されます。トライアル状態を利用することで、以下のことが可能です。定期課金の開始日を任意の日にずらすプランの課金日(billing_day)が指定され、定期課金の日割り設定(prorate)が設定されていない場合、作成時の即時課金が行わないが、本引数を数分後などに設定することで実質的な即時の全額課金を行える課金日(billing_day)が指定されているプランでも、トライアル終了時に支払い処理が行われますのでご注意ください。指定した場合、トライアル期間を終了し課金を即時実行できます。Booleanデフォルトはfalsetrueの場合、日割り課金を設定します定期課金を削除した際に、プランの金額を日割り計算して顧客へ返金処理を行います。プランに課金日(billing_day)が指定されている場合、trueであれば作成日から課金日までの日割り分が課金されますが、falseであれば最初の支払いは作成時ではなく課金日に行われます。}}指定されたIDの定期課金情報を取得します。引数なしレスポンス指定されたidのsubscriptionオブジェクト。}}トライアル期間を新たに設定したり、プランの変更を行うことができます。これにより、プラン情報を上書きするトライアル設定が可能です。そこを基準としてプランに沿った周期で定期課金が作成されます。トライアル期間を利用することで、定期課金の開始日を任意の日にずらせます。課金日(billing_day)が指定されているプランでも、トライアル終了時に支払い処理が行われますのでご注意ください。課金日(billing_day)が指定されていて、かつ日割り課金(prorate)が無効の場合、トライアル期間は次の課金日の日本時間午前9:00に自動調整されます。指定した場合、トライアル期間を終了し課金を即時実行できます。String新しいプランのIDプランを変更するとその時点で新しいプランでの課金が実行されます。プランに設定されているトライアル期間は無視されるのでご注意ください。即時課金を実行したくない場合はtrial_endに未来のタイムスタンプを設定ください。合わせて更新する場合のみ設定可能です。プランに課金日(billing_day)が指定されている場合、更新日から課金日までの日割り分を課金処理します。StringプランIDを指定することで、次回サイクル更新時に指定のプランへと自動的に切り替えを行い課金を試みます。値を指定せず(空文字列)更新した場合、設定は解除されます。課金に失敗した場合、定期課金はプランの切り替えは行われた状態で停止します。指定したプランの課金日(billing_day)と定期課金の日割り設定(prorate)の値によっては、課金が試行されない場合もあります。無し指定するプランについては、以下に注意ください。過ぎてから実際にサイクル更新が行われる前に本パラメータを設定されますと、その更新時に反映される恐れがございます(更新タイミングとサービス運用中の状態の扱いについて)。以前に設定することをお勧めします。}}引き落としの失敗やカードが不正である、また定期課金を停止したい場合はこのリクエストで定期購入を停止させます。定期課金を停止させると、再開されるまで引き落とし処理は一切行われません。引数なしレスポンス停止(status=paused)されたsubscriptionオブジェクト。paused)の定期課金を再開させます。過去の日時の場合、トライアル期間内でなければ支払いが行われ、その時点が周期の開始として設定されます。支払い失敗時の値になるため、必ず過去の日時がセットされます。再開時の支払いに失敗すると、定期課金は再開されません。この場合は、有効なカードを顧客のデフォルトカードにセットしてから、再度定期課金の再開を行ってください。指定した場合、トライアル期間を終了し課金を即時実行できます。これはプランのトライアル情報よりも優先されます。未来のタイムスタンプを指定した場合、トライアル状態で定期課金が再開されます。再開時がトライアル状態の場合、トライアル状態で定期課金が再開されます。課金日(billing_day)が指定されているプランでも、トライアル終了時に支払い処理が行われますのでご注意ください。課金日(billing_day)が指定されていて、かつ日割り課金(prorate)が無効の場合、トライアル期間は次の課金日の日本時間午前9:00に自動調整されます。Booleantrueの場合、日割り課金を設定しますレスポンス再開されたsubscriptionオブジェクト。}}定期課金をキャンセルし、現在の周期の終了日をもって定期課金を終了させます。終了日以前であれば、定期課金の再開リクエスト(/resume)を行うことで、キャンセルを取り消すことができます。終了日をむかえた定期課金は自動的に削除されますのでご注意ください。引数なしレスポンスキャンセル(status=canceled)されたsubscriptionオブジェクト。}}定期課金をすぐに削除します。次回以降の課金は行われず、一度削除した定期課金は再び戻すことができません。Boolean日割り設定trueの場合、削除時から現在の周期の終了日までの日割り分を算出し、返金処理を行います。}}生成した定期課金のリストを取得します。Integer取得するデータ数の最大値(1~100まで)。Integer基準点からのデータ取得を行う開始位置。String定期課金ステータス。レスポンスsubscriptionオブジェクトのlistオブジェクトリストは、直近で生成された順番に取得されます。(トークン)カード情報を代替するトークンオブジェクトです。トークンは、カード番号やCVCなどのセキュアなデータを隠しつつも、カードと同じように扱うことができます。顧客にカードを登録するときや、支払い処理を行うときにカード代わりとして使用します。顧客にカードを登録すれば、顧客IDを支払い手段として用いることで、何度でも同じカードで支払い処理ができるようになります。}}カード情報を指定して、トークンを生成します。生成したトークンは二度以上使用することができません。本APIはシークレットキーを使ってサーバーサイドからカード情報をリクエストすることでトークンを取得するものです。利用して、ブラウザ経由でパブリックキーを使ってカード情報を指定して生成する必要があります。2018年6月1日以降に作成したアカウントでは後述するテスト目的のトークン以外は取得できません。2018年7月中に全てのアカウントに対して同様の制限が適用される予定です。