Sandbox docs
SDKs

Embedded Checkout

Use Vestonix Embedded Checkout when your customers pay inside your application. This is not the Merchant Dashboard and not the Vestonix Business App.

Never embed vsk_test_ or vsk_live_ in a browser, React Native bundle, iOS app, Android app, or Flutter app. Create a client checkout session on your server and pass only vcs_ to the application.

Flow

  1. Your backend creates a payment (vpay_) with an Idempotency-Key.
  2. Your backend creates a client checkout session and receives vcs_.
  3. Your app calls Vestonix.init then presentCheckout.
  4. Treat SDK results as UI state. Retrieve the payment or wait for payment.succeeded before you fulfil.

Server session

Create payment and client session
curl "https://sandbox-api.vestonix.io/v1/payments" \
  -H "Authorization: Bearer vsk_test_YOUR_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"amount":"18.00","currency":"USD"}'

curl "https://sandbox-api.vestonix.io/v1/payments/vpay_ID/client-sessions" \
  -H "Authorization: Bearer vsk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"web","return_url":"https://merchant.example/return"}'

What the SDK may return

checkout_completed, checkout_cancelled, checkout_failed, and requires_action describe the sheet. They do not replace webhooks or GET /v1/payments/{id}.

Wallets and saved cards

Apple Pay and Google Pay stay unavailable until Vestonix enables them for the merchant, country, currency, and provider account. Saved cards stay unavailable until an approved vault exists. Do not infer availability from the SDK itself.