Sources and Customers ／ Sourceオブジェクト と Customerオブジェクト

doc

Payments > SOURCES > Sources & Customers
・Sources and Customers
・ソースと顧客

・Customerオブジェクトを使用してソースを関連付けおよび管理する方法を学ぶ

Sourceオブジェクト

そのusageパラメーターで示されているように、 使い捨てまたは再使用可能にすることができる
・ソースは直接chargedできるが、 再利用可能なソースは、後で再利用できるように常にCustomerオブジェクトに関連付けする必要がある
・再利用可能なソースをCustomerオブジェクトに添付すると、以前にアプリやWebサイトで使用したことのある再利用可能な支払い方法のリストを顧客に提示できる

再利用可能なソース

特定の支払い方法（例： SEPA口座引き落とし）は再利用可能なソースをサポートしているので、あなたは顧客が再度支払いプロセスを完了する必要なしに追加の支払いを作成することができる
・reusableソースは、そのusageパラメータがreusableに設定されている

chargeリクエストを行う前に、再利用可能なソースをCustomerオブジェクトに関連付けする必要がある
・最初に関連付けせずに再利用可能なソースをchargeすると、そのchargeは消費される（そのステータスはchargeable から consumedへ変わる ）
・消費されたソースは更なる支払いには使用できない

新しいCustomerオブジェクトへのソースの添付

Customerオブジェクトを作成して、1つのAPI呼び出しでソースを関連付けすることができる
・あなたがこの顧客に会うのが初めての場合、これは役に立つ

// Set your secret key: remember to change this to your live secret key in production

// See your keys here: https://dashboard.stripe.com/account/apikeys

\Stripe\Stripe::setApiKey("sk_test_xxxx");



$customer = \Stripe\Customer::create([

  "email" => "paying.user@example.com",

  "source" => "src_18eYalAHEMiOZZp1l9ZTjSU0",

]);

・これは顧客の最初で唯一の支払い方法であるため、 ソースはCustomerオブジェクトの default sourceプロパティの値になる
・ソースを指定せずにcustomerパラメータを使用して請求を行うと、デフォルトのソースが自動的に選択される

既存のCustomerオブジェクトへのソースの関連付け

Customerオブジェクトの default sourceプロパティの値を更新
・デフォルトのソースを持つCustomerオブジェクトを更新すると、これによって既存のソースが自動的に切り離され、指定されたソースが新しいデフォルトとして追加される

Customerオブジェクトの default sourceプロパティの値を追加
・既存のデフォルトを置き換えずにソースを追加するには、以下に示すようにattachメソッドを使用する

// Set your secret key: remember to change this to your live secret key in production

// See your keys here: https://dashboard.stripe.com/account/apikeys

\Stripe\Stripe::setApiKey("sk_test_xxxx");



$customer = \Stripe\Customer::retrieve("cus_AFGbOSiITuJVDs");

$customer->sources->create(["source" => "src_18eYalAHEMiOZZp1l9ZTjSU0"]);

・ここでは、 Customerオブジェクトにデフォルトのソースがすでに存在している可能性があるため、新しく追加されたソースはデフォルトのソースにはならない
・但し、 Customerオブジェクトを更新してdefault_source値としてソースを指定することで、default sourceを変更できる

// Set your secret key: remember to change this to your live secret key in production

// See your keys here: https://dashboard.stripe.com/account/apikeys

\Stripe\Stripe::setApiKey("sk_test_xxxx");



\Stripe\Customer::update(

  "cus_AFGbOSiITuJVDs",

  [

    'default_source' => 'src_18eYalAHEMiOZZp1l9ZTjSU0',

  ]

);

・Stripe Q24。After attaching the source to the customer object, how do I check from the customer object?

関連付けソースをCharging

chargeリクエストを行うとき
・Customerオブジェクトとソースの両方を指定する必要がある

// Set your secret key: remember to change this to your live secret key in production

// See your keys here: https://dashboard.stripe.com/account/apikeys

\Stripe\Stripe::setApiKey("sk_test_xxxx");



$charge = \Stripe\Charge::create([

  "amount" => 1099,

  "currency" => "eur",

  "customer" => "cus_AFGbOSiITuJVDs",

  "source" => "src_18eYalAHEMiOZZp1l9ZTjSU0",

]);

ソースを指定せずにCustomerオブジェクトをchargeしようとすると
・Stripeは顧客のデフォルトのソースを使用する

CustomerからSourceオブジェクトを切り離す

特定のCustomerオブジェクトからソースを削除する必要がある場合は、そのソースを切り離すことができる
・detachされるとソースのステータスがconsumedに変わるので、一度detachすると使用することはできない
・chargeの作成には使用できなくなる

\Stripe\Stripe::setApiKey("sk_test_xxxx");



$customer = \Stripe\Customer::retrieve("cus_EiDcmm669r4cwb");

$customer->sources->retrieve("src_1EEnBAJiXAQvfxv3m86YDQVk")->detach();

デフォルトのソースID（src_xxxx）をdetachするとどうなるの？
・他のソースIDが自動的にデフォルトとなる
・この時の選定方法は不明

使い捨てのソース

使い捨てのソースは、顧客が支払いをするたびに作成する必要があり、再利用することはできない
・そのため、それらを顧客に永久に関連付けすることはお勧めできない

支払いを特定のCustomerオブジェクトに関連付ける場合
・ソースが関連付けされていなくても、ソースでchargeリクエストを行うときにcustomerパラメータを含めることができる
・ここで言う支払いと「ch_xxxx」なので注意が必要。カード情報の意味ではない
・例えば、(Customerオブジェクトに関連付けされていない)4111111111111111のソースID（src_xxxx）を指定した場合、4111111111111111のソースID（src_xxxx）で支払いが行われるが、4111111111111111カード情報はCustomerオブジェクトに関連付けされない
・つまり、トークンIDみたいな使い方もできる

// Set your secret key: remember to change this to your live secret key in production

// See your keys here: https://dashboard.stripe.com/account/apikeys

\Stripe\Stripe::setApiKey("sk_test_xxxx");



$charge = \Stripe\Charge::create([

  "amount" => 1099,

  "currency" => "eur",

  "customer" => "cus_AFGbOSiITuJVDs",

  "source" => "src_18eYalAHEMiOZZp1l9ZTjSU0",

]);

・逆に、Charge::createする際、customereパラメータ指定する場合は、"source"パラメータとして、トークンID（tok_xxxx）を指定不可。これは恐らく、CustomerオブジェクトにTokenオブジェクトを関連付けられないため。Chargeオブジェクトをcreateする際、下記パラメータの組み合わせは不可だから
Customer Token デモ3 参照

結果のChargeオブジェクト
・CustomerオブジェクトとSourceオブジェクトの両方を直接参照していなくても、それらを参照する