Lewati ke konten
Buat akun atau Masuk
Logo Dokumen Stripe
/
Buat akunMasuk
Gambaran UmumUpgrade integrasi Anda
Pembayaran online
Gambaran umumTemukan contoh penggunaan AndaGunakan Managed Payments
Pembayaran di tempat
Metode Pembayaran
Skenario pembayaran
Di luar pembayaran

Kumpulkan nomor telepon dan alamat fisik

Pelajari cara mengumpulkan alamat pelanggan dan nomor telepon di aplikasi seluler Anda dengan Elemen Alamat.

Untuk mengumpulkan alamat lengkap untuk penagihan atau pengiriman, gunakan Address Element.

Anda juga dapat menggunakan Address Element untuk:

Stripe mengombinasikan informasi alamat yang dikumpulkan dan metode pembayaran untuk membuat PaymentIntent.

Contoh proses checkout di mana pengguna memilih opsi Tambahkan Alamat Pengiriman. Mereka kemudian dibawa ke layar baru untuk menambahkan alamat pengirimannya ke formulir (mereka melihat saran pengisian otomatis saat mengetikkan alamatnya).

Siapkan Stripe
Sisi server
Sisi klien

Pertama, Anda membutuhkan akun Stripe. Daftar sekarang.

Stripe Android SDK adalah sumber terbuka dan didokumentasikan lengkap.

Untuk menginstal SDK, tambahkan stripe-androidke blokdependencies` file app/build.gradle Anda:

build.gradle.kts
Kotlin
Groovy
No results
plugins {
    id("com.android.application")
}

android { ... }

dependencies {
  // ...

  // Stripe Android SDK
  implementation("com.stripe:stripe-android:22.0.0")
  // Include the financial connections SDK to support US bank account as a payment method
  implementation("com.stripe:financial-connections:22.0.0")
}

Catatan

Untuk detail mengenai rilis SDK terbaru dan versi sebelumnya, lihat halaman Rilis di GitHub. Untuk menerima notifikasi bila rilis baru diterbitkan, lihat rilis untuk repositori.

Konfigurasikan SDK dengan kunci yang dapat dipublikasikan Stripe agar dapat membuat permintaan ke API Stripe, seperti di subkelas Application Anda:

Kotlin
Java
No results
import com.stripe.android.PaymentConfiguration

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        PaymentConfiguration.init(
            applicationContext,
            
"pk_test_TYooMQauvdEDq54NiTphI7jx"

        )
    }
}

Catatan

Gunakan kunci percobaan Anda saat mencoba serta mengembangkan, dan kunci mode live bila Anda memublikasikan aplikasi.

Siapkan saran pengisian alamat otomatis

Elemen alamat menggunakan Google Places SDK untuk mengambil saran pengisian otomatis alamat. Untuk mengaktifkan saran pengisian otomatis, Anda perlu menyertakan dependensi SDK Google Places ke build.gradle aplikasi.

build.gradle
Groovy
Kotlin
No results
dependencies {
    implementation 'com.google.android.libraries.places:places:2.6.0'
}

Saran pengisian alamat otomatis memerlukan kunci Google Places API. Ikuti panduan penyiapan Google Places SDK untuk membuat kunci API Anda.

Konfigurasikan Address Element

Anda dapat mengonfigurasi Address Element dengan detail, seperti menampilkan nilai default, mengatur negara yang diizinkan, menyesuaikan tampilan, dan sebagainya. Lihat AddressLauncher.Configuration untuk daftar lengkap opsi konfigurasi.

val addressConfiguration = AddressLauncher.Configuration(
  additionalFields: AddressLauncher.AdditionalFieldsConfiguration(
    phone: AdditionalFieldsConfiguration.FieldConfiguration.Required
  ),
  allowedCountries: setOf("US", "CA", "GB"),
  title: "Shipping Address",
  googlePlacesApiKey = "(optional) YOUR KEY HERE"
)

Ambil detail alamat

Ambil detail alamat dengan membuat instance AddressLauncher di metode siklus hidup onCreate dari Activity atau Fragment Anda dan membuat metode callback yang mengimplementasikan antarmuka AddressLauncherResultCallback.

private lateinit var addressLauncher: AddressLauncher
private var shippingDetails: AddressDetails? = null

override fun onCreate(savedInstanceState: Bundle?) {
    addressLauncher = AddressLauncher(this, ::onAddressLauncherResult)
}

private fun onAddressLauncherResult(result: AddressLauncherResult) {
    // TODO: Handle result and update your UI
    when (result) {
        is AddressLauncherResult.Succeeded -> {
            shippingDetails = result.address
        }
        is AddressLauncherResult.Canceled -> {
            // TODO: Handle cancel
        }
    }
}

AddressLauncherResult dapat Succeeded atau Canceled. Lihat selengkapnya detail implementasi.

Catatan

Stripe mengharuskan Anda membuat instance AddressLauncher selama kejadian siklus hidup onCreate dan bukan setelahnya. Jika tidak, callback tidak dapat didaftarkan dengan benar, dan aplikasi Anda akan mogok.

Sajikan Address Element

Sajikan elemen alamat menggunakan peluncur alamat dan konfigurasi dari langkah sebelumnya.

addressLauncher.present(
   publishableKey = publishableKey,
   configuration = addressConfiguration
)

OpsionalIsikan otomatis alamat pengiriman di Payment Element

Jika Anda menggunakan Element Pembayaran seluler, aturPaymentSheet.Configuration.shippingDetails ke alamat yang dikumpulkan oleh elemen alamat. Ketika shippingDetails diisi, pengguna akan memiliki alamat penagihan mereka yang terisi sebelumnya dan mereka akan melihat kotak centang Alamat penagihan sama dengan alamat pengiriman. PaymentIntents yang Dikonfirmasi denganshippingDetails terisi juga memiliki properti intent shipping terisi ketika PaymentIntent dikonfirmasi

val configuration = PaymentSheet.Configuration.Builder("Example, Inc.")
  // ...
  .shippingDetails(shippingDetails)
  .build()

OpsionalMenyesuaikan penampilan

Kini setelah menambahkan Address Element ke aplikasi, Anda dapat menyesuaikan tampilan agar sesuai dengan desain aplikasi Anda selengkapnya. Anda dapat mengonfigurasi penampilan dengan Appearance API menggunakan AddressLauncher.Configuration.appearance.

OpsionalAtur detail tagihan default

Untuk mengatur nilai default bagi detail tagihan yang dikumpulkan di lembar pembayaran, konfigurasikan properti defaultBillingDetails. PaymentSheet akan melengkapi bidang-bidangnya dengan nilai yang Anda berikan.

Kotlin
Java
No results
val address = PaymentSheet.Address(country = "US")
val billingDetails = PaymentSheet.BillingDetails(
  address = address,
  email = "foo@bar.com"
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "Merchant, Inc.")
  .defaultBillingDetails(billingDetails)
  .build()

OpsionalSesuaikan pengumpulan detail tagihan

Konfigurasikan pengumpulan detail tagihan

Menggunakan BillingDetailsCollectionConfiguration untuk menentukan cara Anda ingin mengumpulkan detail tagihan di PaymentSheet.

Anda dapat mengumpulkan nama, email, nomor telepon, dan alamat pelanggan.

Jika Anda ingin melampirkan detail tagihan default ke objek PaymentMethod sekalipun bidang tersebut tidak dikumpulkan di UI, atur billingDetailsCollectionConfiguration.attachDefaultsToPaymentMethod ke true.

Kotlin
Java
No results
val billingDetails = PaymentSheet.BillingDetails(
  email = "foo@bar.com"
)
val billingDetailsCollectionConfiguration = BillingDetailsCollectionConfiguration(
  attachDefaultsToPaymentMethod = true,
  name = BillingDetailsCollectionConfiguration.CollectionMode.Always,
  email = BillingDetailsCollectionConfiguration.CollectionMode.Never,
  address = BillingDetailsCollectionConfiguration.AddressCollectionMode.Full,
)
val configuration = PaymentSheet.Configuration.Builder(merchantDisplayName = "Merchant, Inc.")
  .defaultBillingDetails(billingDetails)
  .billingDetailsCollectionConfiguration(billingDetailsCollectionConfiguration)
  .build()

Catatan

Konsultasikan dengan penasihat hukum mengenai undang-undang yang berlaku untuk mengumpulkan informasi. Hanya kumpulkan nomor telepon jika Anda memerlukannya untuk transaksi.

Apakah halaman ini membantu?
YaTidak