npm install @tagadapay/headless-sdk

import { createHeadlessClient } from '@tagadapay/headless-sdk';

const tagada = createHeadlessClient({ storeId: 'store_xxx' });
// tagada.rx is ready — no extra config

const check = await tagada.rx.isRequiredForProduct(productId);

if (check.required) {
  // Rx product: check the patient before payment (step 2),
  // then show the network questionnaire after payment (step 3)
  // check.requiresIdVerification → plan for photo-ID upload post-purchase
  // check.requiresLabs           → surface lab expectations in the copy
}

const pre = await tagada.rx.validateIntake({
  productId,
  patient: {
    phone: '+1 512 555 0100',
    dateOfBirth: '1990-04-12',      // YYYY-MM-DD
    sexAtBirth: 'female',
    address: { state: 'TX', zip: '78701', country: 'US' },
  },
});
if (!pre.valid) showErrors(pre.issues); // [{ field: 'patient.phone', message: '…' }]

import { isQuestionActive, toIntakeAnswers } from '@tagadapay/headless-sdk';

const { questions } = await tagada.rx.getQuestionsForProduct(productId, variantId);
const ctx = { state: patient.address.state, sexAtBirth: patient.sexAtBirth };
const visible = questions.filter((q) => isQuestionActive(q, answers, ctx)); // re-run on every answer
// answers: Record<externalQuestionId, string | string[] | boolean>, one per visible question.
// select / multiselect: only the option values offered.

const result = await tagada.rx.submitCase({
  orderId,                 // from the paid order
  checkoutToken,           // from your checkout session
  productId,
  patient: {
    firstName: 'Jane',
    lastName: 'Doe',
    email: 'jane@example.com',
    phone: '+1 512 555 0100',
    dateOfBirth: '1990-04-12',
    sexAtBirth: 'female',
    address: { line1: '1 Main St', city: 'Austin', state: 'TX', zip: '78701', country: 'US' },
  },
  intakeAnswers: toIntakeAnswers(questions, answers, ctx),
});

// result.rxCaseId    → 'rxcase_xxx'
// result.status      → 'submitted'
// result.accrualAmountMinor → your commission (affiliate mode; 0 in direct mode)

const { cases } = await tagada.rx.getCasesForOrder({ orderId, checkoutToken });

const status = cases[0]?.status;
// 'submitted' → "Sent to a licensed clinician"
// 'in_review' → "A clinician is reviewing your information"
// 'approved'  → "Approved — preparing your shipment"
// 'shipped'   → "On its way" (lastShipmentShippedAt is set)

const status = await tagada.rx.getActivationStatus(); // defaults to the client's storeId

if (status.payments === 'setting_up') {
  // Tagada is still opening the brand's payment account. Show
  // "Payments are being set up" instead of the pay button.
}
// status.steps   → [{ key: 'application' | 'approval' | 'statement_descriptor' | 'storefront', done }]
// status.missing → e.g. ['storefront']
// status.descriptorStatus → 'none' | 'pending' | 'approved' | 'rejected'

function RxStatus({ orderId, checkoutToken }: Props) {
  const [status, setStatus] = useState<string | null>(null);

  useEffect(() => {
    const tick = async () => {
      const { cases } = await tagada.rx.getCasesForOrder({ orderId, checkoutToken });
      if (cases[0]) setStatus(cases[0].status);
    };
    tick();
    const id = setInterval(tick, 10_000);
    return () => clearInterval(id);
  }, [orderId, checkoutToken]);

  const copy: Record<string, string> = {
    submitted: 'Your information was sent to a licensed clinician.',
    in_review: 'A clinician is reviewing your information.',
    approved: 'Approved! Your treatment is being prepared.',
    shipped: 'Your treatment is on its way.',
    declined: 'A clinician determined this treatment isn’t right for you — the hold on your card has been released.',
  };

  return <p>{status ? copy[status] ?? status : 'Submitting…'}</p>;
}

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

const tagada = new Tagada(process.env.TAGADA_API_KEY!);

await tagada.funnels.create({
  storeId: 'store_xxx',
  isDefault: true,
  config: {
    id: 'rx-storefront',
    name: 'Harbor Clinic storefront',
    version: '1.0.0',
    metadata: { rxStorefront: true },
    nodes: [
      { id: 'rx_landing', name: 'Landing', kind: 'step', type: 'landing', isEntry: true, isDefault: true, position: { x: 0, y: 0 }, config: { path: '/' } },
      { id: 'rx_quiz', name: 'Marketing quiz', kind: 'step', type: 'custom', position: { x: 280, y: 0 }, config: { path: '/quiz', matchSubPaths: true } },
      { id: 'rx_checkout', name: 'Checkout', kind: 'step', type: 'checkout', position: { x: 560, y: 0 }, config: { path: '/checkout' } },
      { id: 'rx_offer', name: 'Offer', kind: 'step', type: 'offer', position: { x: 840, y: 0 }, config: { path: '/offer' } },
      { id: 'rx_thankyou', name: 'Thank you', kind: 'step', type: 'thankyou', isConversion: true, position: { x: 1120, y: 0 }, config: { path: '/thank-you' } },
      { id: 'rx_portal', name: 'Patient portal', kind: 'step', type: 'custom', position: { x: 1400, y: 0 }, config: { path: '/portal', matchSubPaths: true } },
    ],
    edges: [
      { id: 'edge_rx_landing_quiz', source: 'rx_landing', target: 'rx_quiz' },
      { id: 'edge_rx_quiz_checkout', source: 'rx_quiz', target: 'rx_checkout' },
      { id: 'edge_rx_checkout_offer', source: 'rx_checkout', target: 'rx_offer', conditions: { when: 'payment.success' } },
      { id: 'edge_rx_offer_thankyou', source: 'rx_offer', target: 'rx_thankyou' },
      { id: 'edge_rx_thankyou_portal', source: 'rx_thankyou', target: 'rx_portal' },
    ],
  },
});