OpenClaw Integration

Build powerful AI agents that can automate payment workflows, send invoices, manage customers, and analyze sales data using the Sentry Payments API.

Getting Started

Follow these steps to create an OpenClaw skill that integrates with Sentry Payments:

SENTRY_API_KEY=sntr_abcdefghijklmnopqrstuvwxyz123456
SENTRY_BASE_URL=https://sandbox.sentrypos.app

Example Skill: Invoice Assistant

Here's a complete example of an OpenClaw skill that can send invoices:

const SENTRY_API_KEY = process.env.SENTRY_API_KEY;
const SENTRY_BASE_URL = process.env.SENTRY_BASE_URL;

class InvoiceAssistant {
  constructor() {
    this.headers = {
      'Authorization': `Bearer ${SENTRY_API_KEY}`,
      'Content-Type': 'application/json'
    };
  }

  async sendInvoice(customerInfo, amount, description) {
    try {
      // Create or update customer
      const customerResponse = await fetch(`${SENTRY_BASE_URL}/public/api/v1/customers`, {
        method: 'POST',
        headers: this.headers,
        body: JSON.stringify({
          name: customerInfo.name,
          phone: customerInfo.phone,
          email: customerInfo.email
        })
      });

      if (!customerResponse.ok) {
        throw new Error(`Failed to create customer: ${await customerResponse.text()}`);
      }

      const customerData = await customerResponse.json();
      
      // Create invoice
      const invoiceResponse = await fetch(`${SENTRY_BASE_URL}/public/api/v1/invoices`, {
        method: 'POST',
        headers: this.headers,
        body: JSON.stringify({
          customerId: customerData.customer.id,
          amountCents: Math.round(amount * 100), // Convert dollars to cents
          description: description,
          sendVia: 'SMS' // Send immediately via SMS
        })
      });

      if (!invoiceResponse.ok) {
        throw new Error(`Failed to create invoice: ${await invoiceResponse.text()}`);
      }

      const invoiceData = await invoiceResponse.json();
      
      return {
        success: true,
        invoiceId: invoiceData.invoice.id,
        customerName: customerInfo.name,
        amount: amount,
        paymentUrl: invoiceData.invoice.paymentUrl,
        message: `Invoice sent to ${customerInfo.phone}`
      };
      
    } catch (error) {
      return {
        success: false,
        error: error.message
      };
    }
  }

  async getSalesSummary(days = 30) {
    try {
      const startDate = new Date();
      startDate.setDate(startDate.getDate() - days);
      
      const response = await fetch(
        `${SENTRY_BASE_URL}/public/api/v1/sales/summary?startDate=${startDate.toISOString().split('T')[0]}`,
        { headers: this.headers }
      );

      if (!response.ok) {
        throw new Error(`Failed to get sales summary: ${await response.text()}`);
      }

      return await response.json();
      
    } catch (error) {
      return {
        success: false,
        error: error.message
      };
    }
  }
}

module.exports = InvoiceAssistant;

Skill Patterns

Common patterns for OpenClaw skills integrating with Sentry Payments:

User: "Send an invoice to John for $250 for consulting"
Agent: 
1. Looks up John's contact info
2. Creates invoice via API
3. Sends via SMS
4. Confirms with payment link

User: "How did we do last month?"
Agent:
1. Fetches sales summary for last 30 days
2. Calculates growth, averages, trends
3. Identifies top customers
4. Reports on payment success rate

Agent (scheduled task):
1. Lists all unpaid invoices > 7 days old
2. Sends reminder via API
3. Logs which reminders were sent
4. Escalates to merchant if needed

API Key Scopes for Common Use Cases

Security Best Practices

Testing Your Integration

Test your OpenClaw skill with the sandbox environment before going to production:

// test-invoice-assistant.js
const InvoiceAssistant = require('./invoice-assistant');
const assistant = new InvoiceAssistant();

async function test() {
  console.log('Testing Invoice Assistant...');
  
  // Test 1: Send invoice
  const result = await assistant.sendInvoice(
    {
      name: 'Test Customer',
      phone: '2025550199',
      email: 'test@example.com'
    },
    99.99,
    'Test invoice from OpenClaw'
  );
  
  console.log('Invoice Result:', result);
  
  // Test 2: Get sales summary
  const summary = await assistant.getSalesSummary(7);
  console.log('Sales Summary:', summary);
}

test().catch(console.error);