Checkout Sessions

Use tagada.checkout.createSession to build pre-loaded checkout links: cart line items, currency, and optional customer data are applied before the customer lands on your checkout page.

createSession follows the /checkout/init redirect and returns the final URL plus a checkoutToken (when available) without forcing the browser through the 302.

Create a basic session

import Tagada from '@tagadapay/node-sdk';

const tagada = new Tagada('your-api-key');

const { redirectUrl, checkoutToken } = await tagada.checkout.createSession({
  storeId: 'store_...',
  items: [{ variantId: 'variant_...', quantity: 1 }],
  currency: 'USD',
  checkoutUrl: 'https://your-store.com/checkout',
});

// Share redirectUrl with the customer; persist checkoutToken if you need async status polling

Field	Description
`redirectUrl`	Fully qualified URL to open in the browser
`checkoutToken`	Token extracted from the URL when present (e.g. for `asyncStatus`)

Pre-fill customer data

Optional string fields are passed through to checkout init:

await tagada.checkout.createSession({
  storeId: STORE_ID,
  items: [{ variantId, quantity: 1 }],
  currency: 'USD',
  checkoutUrl,
  customerEmail: 'jane@example.com',
  customerFirstName: 'Jane',
  customerLastName: 'Doe',
  customerPhone: '+15551234567',
});

Customer tags for funnel routing

Attach tags so funnel edge conditions (e.g. customer.hasTag) can route the session:

await tagada.checkout.createSession({
  storeId: STORE_ID,
  items: [{ variantId, quantity: 1 }],
  currency: 'USD',
  checkoutUrl,
  customerTags: ['vip', 'premium'],
});

Combine explicit tags with URL/query enrichment where configured — see Customer Management for auto-enriched tags and tag-driven conditions.

Async payment status (3DS redirects)

After a redirect-based flow (e.g. 3DS), poll session status with the token from createSession:

const status = await tagada.checkout.asyncStatus(checkoutToken!);

checkoutToken may be null if it is not present on the redirect URL. Ensure createSession is used (not the deprecated init helper) so the client can parse the token reliably.

SDK methods reference

Method	Description
`tagada.checkout.createSession(params)`	Build query for `/checkout/init`, return `{ redirectUrl, checkoutToken }`
`tagada.checkout.asyncStatus(checkoutToken)`	GET async status after redirects
`tagada.checkout.pay(params)`	Server-side pay for an existing session (`checkoutSessionId`, instrument, etc.)
`tagada.checkout.init(params)`	Deprecated — prefer `createSession`

Common createSession params include storeId, items, currency, checkoutUrl, returnUrl, locale, customerId, customerEmail, customerFirstName, customerLastName, customerPhone, customerTags, cartToken, and draft.

Next steps

Upsell & downsell funnel

Conditional routing after checkout using funnel edges

Customer management

Tags, listing, and funnel conditions tied to customers

Merchant quick start

End-to-end setup through a live checkout link

Step config guide

Per-step checkout UI, scripts, and order bumps

Apply for TagadaPay Processing Customer Management

Overview

Web Integration

Tracking & Attribution

Node SDK

Funnels

Shopify

SaaS Billing

Headless SDK

Plugin SDK

Plugin CLI

Studio MCP (AI Agents)

CRM MCP (AI Agents)

Hosting & A/B Testing

Internal

Checkout Sessions

Checkout Sessions

Create a basic session

Pre-fill customer data

Customer tags for funnel routing

Async payment status (3DS redirects)

SDK methods reference

Next steps

Upsell & downsell funnel

Customer management

Merchant quick start

Step config guide

​Checkout Sessions

​Create a basic session

​Pre-fill customer data

​Customer tags for funnel routing

​Async payment status (3DS redirects)

​SDK methods reference

​Next steps

Upsell & downsell funnel

Customer management

Merchant quick start

Step config guide

Checkout Sessions

Create a basic session

Pre-fill customer data

Customer tags for funnel routing

Async payment status (3DS redirects)

SDK methods reference

Next steps