住所の入力をリッスンする

イベントリスナーを使用して、カスタマイズされた方法で使用できるように住所を収集します。

ウェブ

iOS

Android

React Native

Address Element を使用して、顧客の国内および国外の住所を収集します。

ユーザーが「配送先住所を追加」オプションを選択した場合の決済フロープロセスの例。ユーザーは新しい画面に誘導され、ここでフォームに配送先住所を入力します。住所を入力すると、オートコンプリート機能によってユーザーに選択肢が表示されます。

Stripe を設定する

まず、Stripe アカウントが必要です。今すぐ登録してください。

Stripe iOS SDK はオープンソースです。詳細なドキュメントが提供されており、iOS 13 以降をサポートするアプリと互換性があります。

SDK をインストールするには、以下のステップに従います。

Xcode で、File (ファイル) > Add Packages… (パッケージを追加) を選択し、リポジトリー URL として https://github.com/stripe/stripe-ios-spm を入力します。
リリースページから最新のバージョン番号を選択します。
StripePaymentSheet 製品をアプリのターゲットに追加します。

注

For details on the latest SDK release and past versions, see the Releases page on GitHub. To receive notifications when a new release is published, watch releases for the repository.

アプリの起動時に Stripe 公開可能キーを使用して SDK を設定します。これにより、アプリが Stripe API にリクエストを送信できるようになります。

注

テストおよび開発時にはテスト環境のキーを使用し、アプリを公開する際に本番環境のキーを使用します。

Address Element を設定する

You can configure the Address Element with details such as displaying default values, setting allowed countries, customizing the appearance, and so on. Refer to AddressViewController.Configuration for the complete list of configuration options.

let addressConfiguration = AddressViewController.Configuration(
  additionalFields: .init(phone: .required),
  allowedCountries: ["US", "CA", "GB"],
  title: "Shipping Address"
)

住所の詳細を取得する

Retrieve the address details by conforming to AddressViewControllerDelegate and then using addressViewControllerDidFinish to dismiss the view controller. The address value is either a valid address or nil.

extension MyViewController: AddressViewControllerDelegate {
    func addressViewControllerDidFinish(_ addressViewController: AddressViewController, with address: AddressViewController.AddressDetails?) {
        addressViewController.dismiss(animated: true)
        self.addressDetails = address
    }
}

Address Element を表示する

Create an AddressViewController using the address configuration and delegate from the previous steps. You can either present it in a navigation controller or push it onto a navigation controller.

self.addressViewController = AddressViewController(configuration: addressConfiguration, delegate: self)
let navigationController = UINavigationController(rootViewController: addressViewController)

present(navigationController, animated: true)

注