TypeScript SDK

import { ClinkPayClient } from '@clink-ai/clink-typescript-sdk';

const client = new ClinkPayClient({
  apiKey: 'YOUR_API_KEY',
  env: 'sandbox',
});

async function main() {
  const session = await client.createCheckoutSession({
    customerEmail: 'customer@example.com',
    originalAmount: 19.99,
    originalCurrency: 'USD',
    uiMode: 'hostedPage',
    priceDataList: [
      { name: '测试商品', quantity: 1, unitAmount: 19.99, currency: 'USD' },
    ],
    successUrl: 'https://merchant.example.com/success',
    cancelUrl: 'https://merchant.example.com/cancel',
    allowPromotionCodes: true,
  });

  console.log(session.sessionId);
  console.log(session.url);
}

main();

import { ClinkPayClient, ClinkApiError } from '@clink-ai/clink-typescript-sdk';

const client = new ClinkPayClient({ apiKey: 'YOUR_API_KEY', env: 'sandbox' });

async function demo() {
  try {
    const order = await client.getOrder('order_123');
    console.log(order.status);
  } catch (e) {
    if (e instanceof ClinkApiError) {
      const { code, message } = e;
      // your code here
    }
    // handle other errors
  }
}

demo();

import { ClinkWebhook, ClinkWebhookSignatureError } from '@clink-ai/clink-typescript-sdk';

const webhook = new ClinkWebhook({ signatureKey: process.env.CLINK_WEBHOOK_SIGNING_KEY });

const REPLAY_WINDOW_MS = 5 * 60 * 1000;

// SDK 只管 HMAC，这两道要在调它之前自己挡
if (headers['x-clink-signtype'] !== 'SHA256') return reject401();

const ts = Number(headers['x-clink-timestamp']);
if (!Number.isFinite(ts) || Math.abs(Date.now() - ts) > REPLAY_WINDOW_MS) return reject401();

try {
  const event = webhook.verifyAndGet({
    timestamp: headers['x-clink-timestamp'],
    body: rawBody,              // 原始请求体，JSON 解析之前的
    headerSignature: headers['x-clink-signature'],
  });

  // event.id、event.type、event.data.object
} catch (e) {
  if (e instanceof ClinkWebhookSignatureError) {
    // 返回 401
  }
}