ambosstech-sdk

Official TypeScript SDKs for the Amboss platform.

Packages

Package	Description	npm
@ambosstech/core	Shared client, HTTP layer, errors, GraphQL transport	@ambosstech/core
@ambosstech/payments	Payments domain: webhooks, environments, wallets, transactions	@ambosstech/payments

Install

pnpm add @ambosstech/payments

@ambosstech/core is pulled in as a transitive dependency — no need to install directly.

Quick start

import{Payments}from'@ambosstech/payments';constpayments=newPayments({serviceApiKey: process.env.AMBOSS_API_KEY,webhookSecret: process.env.AMBOSS_WEBHOOK_SECRET,});// verify an incoming webhook (no key required for this)constevent=payments.webhooks.verify({payload: rawBody,signature: headers['x-webhook-signature'],timestamp: headers['x-webhook-timestamp'],});// call the API (requires serviceApiKey)const[environment]=awaitpayments.environments.list();constwallets=awaitpayments.wallets.list({environmentId: environment.id});

See packages/payments/README.md for full docs.

Docs

• docs/INTEGRATION.md — end-to-end integration guide (receive, send, webhooks, production checklist). Self-contained — hand it to your team or your AI coding agent.
• AGENTS.md — guide for AI agents and contributors working on this repo.

License

MIT — see LICENSE.