支払い後に支払い情報を保存する

将来の支払いに備えてカードを設定するには、カードを Customer (顧客) に関連付ける必要があります。顧客がビジネスでアカウントを作成する際に、Customer オブジェクトを作成します。Customer オブジェクトを使用すると、支払い方法を再利用したり、複数の支払いを追跡したりできます。

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Jenny Rosen" \
  --data-urlencode email="jennyrosen@example.com"

作成に成功すると、Customer オブジェクトが返されます。オブジェクトで顧客の id を調べて、その値を後で取得できるようにデータベースに保存できます。

これらの顧客は、ダッシュボードの顧客ページで見つけることができます。

setup_future_usage の値を指定して PaymentIntent を作成するときに、generated_card をリクエストします。顧客が決済フローで操作を行っているときにのみ決済手段の再利用を許可する場合は、on_session を指定します。それ以外の場合は、off_session を指定してください。

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "setup_future_usage"="off_session" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "amount"=1000 \
  -d "currency"="usd" \
  -d "payment_method_types[]"="card_present"

顧客が支払う準備ができ、決済手段の詳細の保存に同意したら、allow_redisplay を always または limited にして、process_payment_intent または collect_payment_methodプレビュー版 コールに渡します。値は、顧客の決済フローで決済手段が表示される頻度を示します。

curl https://api.stripe.com/v1/terminal/readers/{{READER_ID}}/process_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={{PAYMENT_INTENT_ID}} \
  -d "process_config[allow_redisplay]"=always

curl https://api.stripe.com/v1/terminal/readers/{{READER_ID}}/collect_payment_method \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={{PAYMENT_INTENT_ID}} \
  -d "collect_config[allow_redisplay]"=always

collect_payment_method フローを使用すると、PaymentMethod の確定前にカードブランドや資金供給手段などの有用なデータにアクセスできるようになりますが、別途 PaymentIntent の確定を求められます。

curl https://api.stripe.com/v1/terminal/readers/{{READER_ID}}/confirm_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={{PAYMENT_INTENT_ID}}

将来の使用に対応できる手段による支払いが成功すると、requires_capture または succeeded 状態の PaymentIntent が返されます。generated_card の決済手段を取得するには、PaymentIntent の latest_charge プロパティを展開して、payment_method_details.card_present を表示します。PaymentIntent 作成コールで顧客 ID を渡した場合、再利用可能な PaymentMethod が Customer (顧客) オブジェクトに自動的に関連付けられます。それ以外の場合は、別のコールで手動で関連付けることができます。

PaymentIntent.latest_charge に generated_card の値が含まれていることを必ず確認してください。デジタルウォレットによる決済、単独ブランドの Interac、eftpos、girocard によるカード決済などの一部の決済では、生成されたカードが作成されない場合があります。このような状況が発生し、再利用可能な決済手段が必要な場合、次の 2 つのオプションがあります。

• 支払いを受けずに決済手段を保存するフローを使用して、別の決済手段を保存するように顧客に求めます。
• 対面決済を返金し、取引が失敗したことを示し、顧客に別の決済手段を使用するように指示します。