TypeScript SDK

npm install @mcards/sdk

import { McardsSdk } from '@mcards/sdk';

// HMAC authentication
const client = new McardsSdk({
  apiKey: process.env.MCARDS_API_KEY!,
  apiSecret: process.env.MCARDS_API_SECRET!,
  baseUrl: 'https://api.mcards.com', // optional
});

// All requests are automatically signed with HMAC-SHA256
const { data: profile } = await client.partner.getProfile();
console.log(`Partner: ${profile.name}`);

// OAuth2 Bearer token authentication
const client = new McardsSdk();

// 1. Exchange credentials for token
const { data: token } = await client.oauth.createToken(
  'your-client-id',
  'your-client-secret',
  'partner:read wallets:read cards:read'
);

// 2. Set the Bearer token
client.setBearerToken(token.access_token);

// 3. Make authenticated requests
const { data: wallets } = await client.wallets.list();

// All methods return ApiResponse<T>
interface ApiResponse<T> {
  data: T;
  status: number;
  headers: Record<string, string>;
  error?: string;
  ok: boolean;
}

// Check response status
const result = await client.cards.get('card-uuid');
if (!result.ok) {
  console.error(`Error ${result.status}: ${result.error}`);
  return;
}
console.log(result.data); // typed as Card