SDK Programming Guide
  • 6. Samsung Pay SDK integration checklist
  • Test your app to ensure compliance with Samsung's guidelines and standards. As a baseline, use the following checklist for In-App Payments.
  • 6.1 In-App payment flow
  • Assume: Purchase items in cart, ready to checkout
  • Condition User Experience
    SPAY_NOT_SUPPORTED | Samsung Pay is not supported on the user's device Samsung Pay button is not displayed as a payment option
    SPAY_NOT_READY | Samsung Pay has not been completely activated, either because the user did not complete a mandatory update(including stub app status) or the user did not sign in with a valid Samsung Account; merchant app can optionally activate or update the Samsung Pay app on the device based on the EXTRA_ERROR_REASON bundle key

    Samsung Pay button is displayed as a payment option but remains disabled, pending user action base on the EXTRA_ERROR_REASON.

    ERROR_SPAY_SETUP_NOT_COMPLETE >> Pop-up message asks if user wishes to activate Samsung Pay:
       a. If no, Samsung Pay button remains disabled
       b. If yes, call activateSamsungPay(); then, on return to merchant app, recheck status

    ERROR_SAMSUNG_PAY_NEED_TO_UPDATE >> Popup message asks if user wishes to update Samsung Pay:
       a. If no, Samsung Pay button remains disabled
       b. If yes, call goToUpdatePage(); then, on return to merchant app, recheck status

    Other EXTRA_ERROR_REASON should be handled while integrating Samsung Pay SDK. If any case happens, Samsung Pay button remains disabled.

    SPAY_READY | Samsung Pay is activated and ready to use; typically returned after the user completes all mandatory updates and signs in

    *You can do the extra check with requestCardInfo API whether there is any card registered in Samsung Pay. If there is no card available for the purchase, you can hide Samsung Pay button.

    		 Samsung Pay button is displayed in accordance with branding guidelines
    All required information is presented before user confirms order
    • total price
    • taxes
    • shipping cost
    Plus, any other special instructions.
    EXTRA_COUNTRY_CODE | Device’s country code (ISO 3166-1 alpha-2) set by Samsung Pay is not supported by merchant Samsung Pay button is not displayed as a payment option