SDK Integration Overview

Embed Onerway Web SDK into your own checkout page while Onerway handles sensitive payment data and 3D Secure / SCA flows.

Overview

Web SDK embeds the checkout experience into the merchant's own checkout page. Customers complete payment on the merchant's page and domain. Payment data collection, encrypted transmission, and 3D Secure / SCA flows are handled by Onerway.

Web SDK is an embedded form of Checkout. The merchant page keeps its layout and domain. Sensitive payment data is not handled directly in the merchant page.

Integration profile

Integration complexity
Checkout form
Embedded components + merchant-owned checkout page
Technical requirements
Frontend-backend collaboration and basic payment state management

Integration characteristics

  • The checkout experience is embedded into the merchant's own payment page
  • Customers complete payment on the merchant domain
  • Final transaction status comes from verified webhooks

Capability coverage

  • Render card and wallet payment components inside the merchant page
  • Handle 3D Secure / SCA and sensitive payment data securely
  • Support DIRECT, TOKEN, SUBSCRIBE, and AUTH scenarios
  • Support themes, style variables, and component appearance customization

How It Works

Web SDK embeds payment components, security handling, and authentication flows into the merchant checkout page.

The frontend displays the checkout page. The backend creates the transaction and returns transactionId plus redirectUrl. The SDK handles payment data collection, encrypted transmission, and authentication flows. Final transaction status comes from verified webhooks. Query or polling is used for supplementary lookup.

Supported scenario capabilities

Basic payment integration

Includes Web SDK initialization, component mounting, and basic payment parameter handling.

Core flowInitialization
One-time payments and authorization

Use this capability for standard card payments and authorization scenarios inside the embedded checkout experience.

DIRECTAUTH
Subscription billing

Includes recurring billing and auto-renewal scenarios.

SUBSCRIBEAuto-renewal
Card binding and tokenization

Use this capability to generate and reuse tokenId for faster repeat checkout, first-payment card binding, and follow-up charges.

TOKENRepeat checkout

Related Documentation

Related documentation:

Build a subscriptions integration with Checkout

Create and manage subscriptions to accept recurring payments through Checkout.

SDK Integration Flow

Follow the real merchant integration sequence for Onerway Web SDK, including request preparation, SDK mounting, callback URLs, webhook final status handling, and testing.