請求せずに直接保存

顧客を作成または取得する

Stripe で保存したカードに請求するには、カードを Customer に関連付ける必要があります。

確定前に、SetupIntent に顧客を含めると、入力した Customer オブジェクトに、生成されたカードの決済手段が自動的に関連付けられます。

以下のコードをサーバーに含めて、新しい Customer を作成します。

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

SetupIntent を作成する

SetupIntent は、将来の支払いに備えて顧客の決済手段を設定する意図を示すオブジェクトです。SetupIntent は、この設定プロセスの各ステップを追跡します。Terminal の場合、このプロセスにはカード保有者の同意の収集と記録が含まれます。

SetupIntent を作成して、customer、onBehalfOf (Connect の場合のみ)、usage の各パラメーターを指定できます。

val params = SetupIntentParameters.Builder()
    .setCustomer(
"{{CUSTOMER_ID}}")
    .build()

Terminal.getInstance().createSetupIntent(
    params, object : SetupIntentCallback {
        override fun onSuccess(setupIntent: SetupIntent) {
            // Placeholder for handling successful operation
        }

        override fun onFailure(e: TerminalException) {
            // Placeholder for handling exception
        }
    }
)

決済の開始に必要な情報をアプリですぐに利用できない場合は、サーバーで SetupIntent を作成できます。クライアントシークレットを使用して retrieveSetupIntent を呼び出し、取得した SetupIntent を使用して processSetupIntent を呼び出します。

保存するために決済手段を収集する

SetupIntent を作成したら、SDK を使用して決済手段を収集し、顧客の同意を得ます。allowRedisplay を always または limited にして、顧客の決済フローで決済手段が表示される頻度を指定します。

SetupIntent を処理 するには、リーダーに接続されていることを確認してください。アプリが processSetupIntent を呼び出した後、接続されたリーダーはカードを待機します。

val config = CollectSetupIntentConfiguration.Builder()
    .build()

val cancelable = Terminal.getInstance().processSetupIntent(
    setupIntent,
    AllowRedisplay.ALWAYS,
    config,
    object : SetupIntentCallback {
        override fun onSuccess(setupIntent: SetupIntent) {
            // Placeholder for handling successful operation
        }

        override fun onFailure(e: TerminalException) {
            // Placeholder for handling exception
        }
    }
)

この方法では、接続されたカードリーダーを使用して支払い方法の暗号化データを収集し、その暗号化データを SetupIntent に関連付けます。

収集をキャンセルする

プログラムによるキャンセル

SDK から返される Cancelable オブジェクトを使用して、決済手段の収集をキャンセルできます。

顧客によるキャンセル

CustomerCancellation はデフォルトで有効になっているため、スマートリーダーユーザーにはキャンセルボタンが表示されます。キャンセルボタンをタップすると、アクティブな取引がキャンセルされます。取引でこの動作を切り替えるには、setCustomerCancellation を使用します。

Terminal.getInstance().collectSetupIntentPaymentMethod(
    setupIntent,
    AllowRedisplay.ALWAYS,
    SetupIntentConfiguration.Builder()
        .build(),
    object : SetupIntentCallback {
        override fun onSuccess(setupIntent: SetupIntent) {
            // Placeholder for handling successful operation
        }

        override fun onFailure(e: TerminalException) {
            // Placeholder for handling exception
        }
    }
)

Stripe に決済手段の詳細を送信する

前回の processSetupIntent の呼び出しは、 確定 を処理するため、それ以上のアクションは必要ありません。

設定が成功すると、SetupIntent の status プロパティの succeeded 値が SetupAttempt.payment_method_details.card_present.generated_card とともに返されます。これは、オンライン決済に利用できる再利用可能な card の決済手段です。

generated_card の決済手段が、SetupIntent の作成時に指定した顧客に自動的に関連付けられます。SetupIntent の latest_attempt プロパティを展開することで、generated_card の決済手段を取得できます。必ず generated_card の値を確認してください。生成されたカードを使用できない決済手段では、この値が空になるためです。

curl -G https://api.stripe.com/v1/setup_intents/
{{SETUP_INTENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=latest_attempt

別の方法として、顧客に関連付けられている支払い方法のリストを取得することで、関連付けられた支払い方法を入手することもできます。

curl -G https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}}
/payment_methods \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=card

SetupIntent の作成時に顧客を指定しなかった場合は、別個のコールで generated_card を Customer オブジェクトに関連付けることができます。

curl https://api.stripe.com/v1/payment_methods/
{{PAYMENT_METHOD_ID}}
/attach \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"

設定に失敗したら、返されたエラーを調べて原因を特定します。たとえば、顧客から同意を収集できなかったり、Stripe に顧客の同意を通知できなったりした場合、エラーが発生します。

モバイルウォレットに関する考慮事項

保存されたモバイルウォレットは、将来のサブスクリプションや、顧客の代理として開始するその他の支払いなど、off_session の支払いにのみ使用できます。デジタルウォレットによる決済手段を保存する際、generated_card には使用上の特定の考慮事項を示す allow_redisplay=limited が設定されます。

モバイルウォレットに請求する際は、PaymentIntent の確定時に必ず off_session=true を渡します。顧客が決済フローを実施している場合は、代わりに Apple Pay と Google Pay の連携を使用して、決済手段の提示を再度求めます。

法令遵守

You’re responsible for your compliance with all applicable laws, regulations, and network rules when saving a customer’s payment details. For example, the European Data Protection Board has issued guidance regarding saving payment details. These requirements generally apply if you want to save your customer’s payment method for future use. This applies in situations such as presenting a customer’s payment method to them in the checkout flow for a future purchase, or charging them when they’re not actively using your website or app, placing a MOTO order, or in your store.

Add terms to your checkout flow that state how you plan to save payment method details and allow customers to opt in. If you plan to charge the customer while they’re not actively checking out, make sure (at a minimum) that your terms also cover the following:

• 指定された取引で顧客の代理として単独の支払いまたは一連の支払いを開始することをお客様に許可するという、顧客からお客様への同意
• 予期される支払い時期と支払い頻度 (たとえば、請求が予定されている分割払いまたはサブスクリプションの決済なのか、あるいは予定されていないトップアップなのか)。
• 決済金額の決定方法。
• サブスクリプションサービスに使用される支払い方法を設定する場合は、キャンセルに関するポリシー。

これらの規約に関する顧客の書面による同意の記録を必ず保管してください。

When you save a payment method, you can only use it for the specific purpose that you included in your terms. If you want to charge customers when they’re not actively checking out and also save the customer’s payment method to present to them as a saved payment method for future purchases, you must explicitly collect consent from the customer. One way to do so is with a “Save my payment method for future use” checkbox.