npm install @receiptrail/sdk

import { ReceiptrailClient } from '@receiptrail/sdk';

const client = new ReceiptrailClient({
  accessToken: 'your-logto-personal-access-token',
});

// Ingest a receipt
const response = await client.ingestor.ingestReceipt(
  {
    merchant_code: 'SQUARE_US',
    location_id: 'LOC_123',
    source_type: 'api',
    format_type: 'json',
    receipts: [
      {
        transaction_id: 'txn_001',
        payload: {
          merchant_name: 'Coffee Shop',
          total_amount: 15.99,
          currency: 'USD',
          transaction_date: '2025-01-15T10:30:00Z',
          line_items: [
            {
              name: 'Latte',
              quantity: 1,
              unit_price: 5.99,
              total_price: 5.99,
            },
          ],
        },
      },
    ],
  },
  'unique-idempotency-key-123'
);

// Process a receipt image
const normalized = await client.normalizer.processImage({
  image_url: 'https://example.com/receipt.jpg',
  merchant_code: 'MERCHANT_123',
});

Configuration Options

const client = new ReceiptrailClient({
  // Required: Your Logto Personal Access Token
  accessToken: 'your-pat-token',

  // Optional: Custom Logto endpoint
  // Default: 'https://dtoqr1.logto.app'
  logtoEndpoint: 'https://your-logto-instance.app',

  // Optional: Custom API base URL
  // Default: 'https://api.receiptrail.ai'
  baseUrl: 'https://api.receiptrail.ai',

  // Optional: Request timeout in milliseconds
  // Default: 30000 (30 seconds)
  timeout: 60000,
});

Available Methods