关于Android平台Samsung Pay API可用性及集成方法的技术问询

First off, yes, the Samsung Pay API does support Android—but it’s important to note that it’s limited to Samsung Galaxy devices running Android 6.0 (Marshmallow) or higher, with the Samsung Pay app installed and set up by the user.

The link you shared is specific to integrating Samsung Pay with CyberSource (a payment service provider), but let’s walk through the core Android integration steps, plus how to tie in a processor like CyberSource where relevant.

Prerequisites Before You Start #

• A Samsung Developer Account: Required to register your app, access the SDK, and get API keys.
• Your app must be registered in the Samsung Developer Portal with Samsung Pay enabled for your project.
• The Samsung Pay SDK: Downloadable directly from the Samsung Developer Portal (add it to your project’s libs folder or include as a dependency if available).
• A physical Samsung Galaxy device for testing (emulators don’t support Samsung Pay functionality).

Step-by-Step Integration #

1. Configure Your Android Project #

• Add the Samsung Pay SDK library to your project. If using Gradle, include the dependency (check Samsung’s docs for the latest string):

  implementation files('libs/samsung-pay-sdk.jar')
  

• Add required permissions to your AndroidManifest.xml:

  <uses-permission android:name="com.samsung.android.spay.permission.SPAY_USE" />
  

• Declare the Samsung Pay activity to handle payment flows:

  <activity
      android:name="com.samsung.android.sdk.pay.SpayActivity"
      android:exported="true"
      android:theme="@android:style/Theme.Translucent.NoTitleBar" />
  

2. Check Samsung Pay Availability #

Always verify if Samsung Pay is accessible on the user’s device before proceeding:

val samsungPay = SamsungPay()
try {
    samsungPay.initialize(context)
    val isAvailable = samsungPay.isSamsungPayAvailable(context)
    if (isAvailable) {
        // Proceed to set up payment
    } else {
        // Show error: Samsung Pay not available on this device
    }
} catch (e: SPayException) {
    // Handle initialization errors (e.g., outdated SDK)
}

3. Build the Payment Request #

Create a PaymentRequest with merchant details, order info, supported payment methods, and any processor-specific data (like CyberSource credentials):

val merchantInfo = MerchantInfo.Builder()
    .setMerchantId("YOUR_SAMSUNG_MERCHANT_ID")
    .setMerchantName("Your Store Name")
    .build()

val orderInfo = OrderInfo.Builder()
    .setTotalAmount("29.99")
    .setCurrencyCode("USD")
    .build()

val paymentMethod = PaymentMethod.Builder()
    .addCardNetwork(PaymentMethod.CARD_NETWORK_VISA)
    .addCardNetwork(PaymentMethod.CARD_NETWORK_MASTERCARD)
    .build()

val paymentRequest = PaymentRequest.Builder()
    .setMerchantInfo(merchantInfo)
    .setOrderInfo(orderInfo)
    .setPaymentMethod(paymentMethod)
    // Add CyberSource-specific fields here (per their guide)
    .build()

4. Launch the Payment Flow #

Trigger the Samsung Pay UI and handle the result:

samsungPay.requestPayment(paymentRequest, object : PaymentCallback {
    override fun onPaymentSuccess(paymentData: PaymentData) {
        // Extract the payment token and send it to your server/CyberSource
        val paymentToken = paymentData.paymentToken
        // Follow CyberSource's API docs to process the token into a charge
    }

    override fun onPaymentFailure(errorCode: Int, errorMessage: String) {
        // Handle failures (e.g., user canceled, invalid card)
        Toast.makeText(context, "Payment failed: $errorMessage", Toast.LENGTH_SHORT).show()
    }
})

5. Process with CyberSource #

Using the link you referenced, after receiving the payment token from Samsung Pay, send it to CyberSource’s API to complete the transaction. Their guide covers the exact endpoints, payload structure, and authentication needed to charge the tokenized card.

Key Tips #

• Sandbox Testing: Enable sandbox mode in your Samsung Developer project to test with dummy cards without real charges.
• Error Handling: Cover all possible error codes (e.g., ERROR_USER_CANCEL, ERROR_SPAY_NOT_READY) to keep the user experience smooth.
• Compliance: Ensure your app meets PCI standards when handling payment data—never store raw card details, only use the token provided by Samsung Pay.

内容的提问来源于stack exchange，提问作者Ramesh Solanki