Payments

curl -X POST https:"color:#6a9955">//developer.zippex.app/api/v1/checkouts \
  -H "Authorization: Bearer zx_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "qt_dr_4f8a2b1c0d3e6f",
    "items_subtotal": 4500,
    "success_url": "https://yourapp.com/orders/123/confirmed",
    "cancel_url":  "https://yourapp.com/cart",
    "customer": { "name": "Jane Smith", "email": "jane@example.com" }
  }'

"color:#6a9955">// Same-tab redirect
window.location.href = checkout.checkout_url;

"color:#6a9955">// Or a new tab
window.open(checkout.checkout_url, '_blank');

import SafariServices

"color:#6a9955">// The recommended way to open URLs on iOS — full Stripe UI, Apple Pay,
"color:#6a9955">// and your success_url is delivered back to your app universal link.
let vc = SFSafariViewController(url: URL(string: checkout.checkoutUrl)!)
present(vc, animated: true)

import androidx.browser.customtabs.CustomTabsIntent

"color:#6a9955">// Renders the checkout in an in-app browser tab with shared cookies,
"color:#6a9955">// Google Pay support, and a smooth return to your app via the success_url
"color:#6a9955">// (use an app link / deep link for the cleanest handoff).
CustomTabsIntent.Builder().build()
    .launchUrl(context, Uri.parse(checkout.checkoutUrl))

import * as WebBrowser from 'expo-web-browser';

"color:#6a9955">// openAuthSessionAsync auto-closes the browser once it hits success_url,
"color:#6a9955">// then returns control to your app. Make success_url a deep link / universal
"color:#6a9955">// link into your app (e.g. yourapp://orders/123/confirmed).
const result = await WebBrowser.openAuthSessionAsync(
  checkout.checkout_url,
  'yourapp://orders/123/confirmed', // matches success_url
);
if (result.type === 'success') {
  "color:#6a9955">// Customer paid — call POST /v1/deliveries with checkout.checkout_id
}

npm install @stripe/stripe-js

import { loadStripe } from '@stripe/stripe-js';

"color:#6a9955">// 1. Create the checkout on your server, return values to the browser
const checkout = await fetch('/your-server/create-checkout', { method: 'POST' }).then(r => r.json());

"color:#6a9955">// 2. Initialize Stripe with the publishable key Zippex returned
const stripe = await loadStripe(checkout.publishable_key);

"color:#6a9955">// 3. Mount the Payment Element
const elements = stripe.elements({ clientSecret: checkout.client_secret });
const paymentElement = elements.create('payment');
paymentElement.mount('#payment-element'); // <div id="payment-element"></div>

"color:#6a9955">// 4. Confirm the payment when the customer clicks "Pay"
const { error, paymentIntent } = await stripe.confirmPayment({
  elements,
  confirmParams: { return_url: window.location.origin + '/order-confirmed' },
  redirect: 'if_required',
});

if (!error && paymentIntent.status === 'succeeded') {
  "color:#6a9955">// 5. Now call POST /v1/deliveries with checkout.checkout_id
}

import StripePaymentSheet

"color:#6a9955">// 1. Create the checkout from your server, passing the iOS SDK apiVersion
"color:#6a9955">//    The current SDK exposes STPAPIClient.STPSDKVersion, but Stripe pins
"color:#6a9955">//    apiVersion to "2020-08-27" for ephemeral keys — pass that.
let checkout = try await yourServer.createCheckout(
    quoteId: quoteId,
    itemsSubtotal: 4500,
    stripeVersion: "2020-08-27"
)

"color:#6a9955">// 2. Configure the PaymentSheet with the Zippex publishable key
STPAPIClient.shared.publishableKey = checkout.publishableKey

var config = PaymentSheet.Configuration()
config.merchantDisplayName = "Your Store"
config.customer = .init(id: checkout.customer, ephemeralKeySecret: checkout.ephemeralKey)
config.applePay = .init(merchantId: "merchant.com.yourapp", merchantCountryCode: "CA")
config.allowsDelayedPaymentMethods = true

let paymentSheet = PaymentSheet(
    paymentIntentClientSecret: checkout.clientSecret,
    configuration: config
)

"color:#6a9955">// 3. Present from your view controller
paymentSheet.present(from: self) { result in
    switch result {
    case .completed:
        "color:#6a9955">// Call POST /v1/deliveries with checkout.checkoutId
    case .canceled: break
    case .failed(let error): print(error)
    }
}

dependencies {
    implementation 'com.stripe:stripe-android:21.+'
}

import com.stripe.android.PaymentConfiguration
import com.stripe.android.paymentsheet.PaymentSheet
import com.stripe.android.paymentsheet.PaymentSheetResult

class CheckoutActivity : AppCompatActivity() {
    private lateinit var paymentSheet: PaymentSheet

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        paymentSheet = PaymentSheet(this, ::onPaymentResult)

        lifecycleScope.launch {
            "color:#6a9955">// 1. Create checkout via your server, send the Android SDK apiVersion
            val checkout = yourServer.createCheckout(
                quoteId = quoteId,
                itemsSubtotal = 4500,
                stripeVersion = "2020-08-27"
            )

            "color:#6a9955">// 2. Initialize Stripe with the Zippex publishable key
            PaymentConfiguration.init(applicationContext, checkout.publishableKey)

            "color:#6a9955">// 3. Present the sheet
            paymentSheet.presentWithPaymentIntent(
                checkout.clientSecret,
                PaymentSheet.Configuration(
                    merchantDisplayName = "Your Store",
                    customer = PaymentSheet.CustomerConfiguration(
                        id = checkout.customer,
                        ephemeralKeySecret = checkout.ephemeralKey
                    ),
                    googlePay = PaymentSheet.GooglePayConfiguration(
                        environment = PaymentSheet.GooglePayConfiguration.Environment.Production,
                        countryCode = "CA",
                        currencyCode = "CAD"
                    )
                )
            )
        }
    }

    private fun onPaymentResult(result: PaymentSheetResult) {
        when (result) {
            is PaymentSheetResult.Completed -> { /* call POST /v1/deliveries */ }
            is PaymentSheetResult.Canceled -> {}
            is PaymentSheetResult.Failed -> Log.e("Stripe", "Error", result.error)
        }
    }
}

npm install @stripe/stripe-react-native
cd ios && pod install

import { StripeProvider, useStripe } from '@stripe/stripe-react-native';

"color:#6a9955">// Wrap your root component once
export default function App() {
  const [publishableKey, setPublishableKey] = useState('');
  return (
    <StripeProvider publishableKey={publishableKey} merchantIdentifier="merchant.com.yourapp">
      <Checkout onPublishableKey={setPublishableKey} />
    </StripeProvider>
  );
}

function Checkout({ onPublishableKey }) {
  const { initPaymentSheet, presentPaymentSheet } = useStripe();

  async function openSheet() {
    "color:#6a9955">// 1. Create the checkout — send the SDK's apiVersion
    const checkout = await fetch('https:"color:#6a9955">//your-server/create-checkout', {
      method: 'POST',
      body: JSON.stringify({
        quote_id, items_subtotal: 4500,
        stripe_version: '2020-08-27', // matches @stripe/stripe-react-native
      }),
    }).then(r => r.json());

    // 2. Hand Stripe the publishable key from Zippex
    onPublishableKey(checkout.publishable_key);

    // 3. Init + present the sheet (this renders the iOS / Android native UI)
    const init = await initPaymentSheet({
      merchantDisplayName: 'Your Store',
      customerId: checkout.customer,
      customerEphemeralKeySecret: checkout.ephemeral_key,
      paymentIntentClientSecret: checkout.client_secret,
      allowsDelayedPaymentMethods: true,
      applePay: { merchantCountryCode: 'CA' },
      googlePay: { merchantCountryCode: 'CA', testEnv: __DEV__, currencyCode: 'CAD' },
    });
    if (init.error) { console.error(init.error); return; }

    const { error } = await presentPaymentSheet();
    if (!error) {
      "color:#6a9955">// 4. Call POST /v1/deliveries with checkout.checkout_id
    }
  }

  return <Button onPress={openSheet} title="Pay" />;
}

import 'package:flutter_stripe/flutter_stripe.dart';

Future<void> openSheet() async {
  final checkout = await yourServer.createCheckout(
    quoteId: quoteId, itemsSubtotal: 4500, stripeVersion: '2020-08-27',
  );

  Stripe.publishableKey = checkout.publishableKey;

  await Stripe.instance.initPaymentSheet(
    paymentSheetParameters: SetupPaymentSheetParameters(
      merchantDisplayName: 'Your Store',
      paymentIntentClientSecret: checkout.clientSecret,
      customerId: checkout.customer,
      customerEphemeralKeySecret: checkout.ephemeralKey,
      applePay: const PaymentSheetApplePay(merchantCountryCode: 'CA'),
      googlePay: const PaymentSheetGooglePay(merchantCountryCode: 'CA', currencyCode: 'CAD'),
    ),
  );
  await Stripe.instance.presentPaymentSheet();
  "color:#6a9955">// Then POST /v1/deliveries with checkout.checkoutId
}

curl -X POST https:"color:#6a9955">//developer.zippex.app/api/v1/deliveries \
  -H "Authorization: Bearer zx_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "qt_dr_4f8a2b1c0d3e6f",
    "checkout_id": "chk_dr_abc123def456",
    "customer": { "name": "Jane Smith", "phone": "+16045550456" }
  }'