継続課金を行う

manecoではクレジットカード情報を登録した顧客に対して、継続的に自動で課金を行う継続課金を提供しています。

継続課金を作成する

指定した顧客に対して継続課金を作成することができます。継続課金は1人の顧客に対して複数作成することができます。

加盟店様サーバで

$ curl "https://maneco.paygent.co.jp/maneco-api/recursions" \
  -u "test_secret_2dKpG9t5D2ol8f2ZRlzLIi2p:" \
  -d "customer_id=cus_Pdvv3MXQ31uq" \
  -d "amount=500" \
  -d "currency=JPY" \
  -d "cycle=1" \
  -d "timing=15" \
  -d "end_scheduled=20160115" \
  -d "description=メモ"
require "vendor/autoload.php";
use Maneco\Maneco;
$maneco = new Maneco("test_secret_2dKpG9t5D2ol8f2ZRlzLIi2p");
$maneco->recursions->create(array(
                "customer_id" => "cus_Pdvv3MXQ31uq",
                "amount" => 500,
                "currency" => "JPY",
                "cycle" => "1",
                "timing" => "15",
                "end_scheduled" => "20160115",
                "description" => "メモ"
            ));
import jp.co.paygent.maneco.Maneco;
Maneco maneco = new Maneco("test_secret_2dKpG9t5D2ol8f2ZRlzLIi2p");
maneco.recursions.createRequest()
            .customerId("cus_Pdvv3MXQ31uq")
            .amount(500)
            .cycle(1)
            .timing(15)
            .endScheduled("20160115")
            .description("メモ")
            .execute();

を実行することにより、下記条件の継続課金を作成することができます。

顧客ID
cus_Pdvv3MXQ31uq
金額
1,000円
課金の周期
毎月
課金日
20日

課金を行うタイミング

課金の周期

毎月、3か月、半年、毎年から選択することができます。

初回の課金

継続課金が作成されたタイミングで課金が実行されます。
初回課金日を指定することにより、任意のタイミングで課金を開始することもできます。

2回目以降の課金

課金日で指定した日に課金が実行されます。
課金の周期が「毎月」で課金日が「20日」の場合は、翌月の20日に2回目の課金が実行されます。

継続課金を再開する

何らかの理由により自動課金に失敗した場合は、継続課金が一時停止状態となります。
失敗の原因を解消後、継続課金を再開する必要があります。

加盟店様サーバで

$ curl "https://maneco.paygent.co.jp/maneco-api/recursions/rec_CvE1D34UkaBc/resume" \
  -u "test_secret_2dKpG9t5D2ol8f2ZRlzLIi2p:" \
  -X POST -H 'Content-Length: 0'
require "vendor/autoload.php";
use Maneco\Maneco;
$maneco = new Maneco("test_secret_2dKpG9t5D2ol8f2ZRlzLIi2p");
$maneco->recursions->resume(array(
                "id" => "rec_CvE1D34UkaBc"
            ));
import jp.co.paygent.maneco.Maneco;
Maneco maneco = new Maneco("test_secret_2dKpG9t5D2ol8f2ZRlzLIi2p");
maneco.recursions.resumeRequest()
            .id("rec_CvE1D34UkaBc")
            .execute();

を実行することにより、継続課金を再開することができます。

継続課金が再開されたタイミングで、自動課金に失敗した課金が実行されます。
retry=falseを指定することにより、自動課金に失敗した課金を実行しないこともできます。

継続課金を再開できるのは、次回の課金日の前日までです。期日を過ぎた継続課金は無効状態となります。