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
- Your backend creates a payment (
vpay_) with an Idempotency-Key. - Your backend creates a client checkout session and receives
vcs_. - Your app calls
Vestonix.initthenpresentCheckout. - Treat SDK results as UI state. Retrieve the payment or wait for
payment.succeededbefore 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.