How it works
1 Create session (server)
2 Initialise SDK (client)
3 Mount checkout element
4 Customer pays inline
Single element - handles everything
Built-in submit button and validation
Customisable with themes and CSS variables
Automatic 3DS challenge handling
onSuccess / onError callbacks
Works with HTML/JS and React
Before getting started
1. Get your credentials
1 Request a development store with an ecommerce subscription from your Teya contact
3 Select your store and go to Integrations
4 Create ecommerce API credentials and configure webhook URLs
You'll receive a Client ID and Client Secret for OAuth authentication
Use client_credentials grant to obtain access tokens
Each store has its own set of credentials
```admonition
icon: fas fa-info-circle
title: Staging vs Production
content: Use Staging for development and testing. When ready to go live, repeat the credential setup in
Production. Keep separate credentials and token caches for each environment.
```
2. API URLs
| Service | Staging | Production |
|---|
| Online Payments API | https://api.teya.xyz | https://api.teya.com |
| OAuth | https://id.teya.xyz/oauth/v2/oauth-token | https://id.teya.com/oauth/v2/oauth-token |
| Business Portal | https://business.teya.xyz | https://business.teya.com |
3. Required scopes
Request these scopes when obtaining your access token:
| Scope | Description |
|---|
checkout/sessions/create | Create a checkout session for the SDK |
checkout/sessions/id/get | Get checkout session by ID |
```admonition
icon: fas fa-handshake
title: Integrating on behalf of the merchants you serve?
content: Partners and platforms get credentials through the merchant registration flow instead. See Take payments online for partners.
link: /partners/online-payments/overview
```
Domain Verification
To use Apple Pay within the Embedded Checkout, your domain must be verified with Apple. Follow these steps:
1 Download the domain verification file from the
Business Portal under
Integrations > Apple Pay
2 Host the file at https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
3 Click Verify in the Business Portal to complete domain verification
```admonition
icon: fas fa-info-circle
title: Domain Verification for Apple Pay
content: Domain verification is only required if you want Apple Pay to appear in the Embedded Checkout. Card payments work without it. Verification must be completed for each domain (including staging and production).
```
Install the SDK
```bash
npm install @teyaproduct/teya-blocks-js
```
For React applications, also install the React wrapper:
```bash
npm install @teyaproduct/teya-blocks-js @teyaproduct/teya-blocks-react
```
See SDK Initialization for initTeyaBlocks() options, including developmentMode for staging.