Web Redirect on Android

With Web Redirect, your server creates a checkout and returns its redirect URL to your app. The SDK loads the URL in a web view and watches for the redirect to your confirm or cancel URL. When the customer confirms, the SDK returns the order token, and your server completes the payment.

Web Redirect is the simplest way to present checkout. The SDK calls it Checkout V1.

Step 1: Create a checkout on your server

When the customer starts checkout, your server calls Create Checkout and returns the redirectCheckoutUrl from the response to your app.

{
  "amount": { "amount": "100.00", "currency": "USD" },
  "consumer": { "email": "test@example.com" },
  "merchant": {
    "redirectConfirmUrl": "https://example.com/checkout/confirm",
    "redirectCancelUrl": "https://example.com/checkout/cancel"
  },
  "merchantReference": "merchant-order-123"
}

Step 2: Start the checkout

Register an activity result launcher, then launch the intent from createCheckoutIntent with the checkout URL. The SDK checks that the URL is an Afterpay checkout URL before it loads it.

class CartActivity : AppCompatActivity() {
  private val checkoutLauncher =
    registerForActivityResult(StartActivityForResult()) { result ->
      val data = result.data ?: return@registerForActivityResult
      when (result.resultCode) {
        RESULT_OK -> {
          val token = Afterpay.parseCheckoutSuccessResponse(data)
          // Send the token to your server to complete the order.
        }
        RESULT_CANCELED -> {
          val status = Afterpay.parseCheckoutCancellationResponse(data)
          // Handle the cancellation.
        }
      }
    }
  private fun onAfterpayButtonClicked(checkoutUrl: String) {
    checkoutLauncher.launch(
      Afterpay.createCheckoutIntent(this, checkoutUrl),
    )
  }
}

Load the redirect URLs

By default, the SDK stops at the redirect and doesn’t load your confirm or cancel URL. To let the redirect URL load and read the result when it starts loading, pass loadRedirectUrls = true to createCheckoutIntent.

Step 3: Handle the result

parseCheckoutSuccessResponse returns the order token. parseCheckoutCancellationResponse returns a CancellationStatus:

Step 4: Complete the order

Send the order token to your server. To capture the full amount immediately, your server calls Capture Full Payment with the token. To capture later, call Auth and then Capture Payment.

For the full server flow, see the Mobile SDK quickstart.