🚀 Shora AI Payment SDK

⚡ Quickstart (30 seconds)

# Install the SDK
npm install shora-ai-payment-sdk

# Or with yarn
yarn add shora-ai-payment-sdk

import ShoraSDK from 'shora-ai-payment-sdk';

// Initialize with your API key
const shora = new ShoraSDK({
  apiKey: 'your_api_key_here',
  environment: 'sandbox' // or 'production'
});

// Create a payment session for your AI agent
const session = await shora.createPaymentSession({
  amount: 2999, // $29.99 in cents
  currency: 'USD',
  description: 'AI Agent Subscription',
  customer: {
    email: 'user@example.com',
    name: 'John Doe'
  }
});

console.log('Payment URL:', session.payment_url);

📦 NPM Package

Install: npm install shora-ai-payment-sdk
Import: import ShoraSDK from 'shora-ai-payment-sdk'
TypeScript: Full TypeScript support included

Basic Usage

import ShoraSDK from 'shora-ai-payment-sdk';

const shora = new ShoraSDK({
  apiKey: process.env.SHORA_API_KEY,
  environment: 'sandbox'
});

// Your AI agent is ready to process payments!

🎮 Live Demo

Try it now: demo.shora.co

• 🤖 AI Chatbot Integration - See how AI agents process payments
• 💳 Real Payment Flow - Complete checkout experience
• 🔧 Developer Tools - API explorer and code examples
• 📊 Analytics Dashboard - Transaction monitoring

🚀 Why Shora?

✨ Features

🤖 AI Agent Features

• Mandate Management: Create, activate, and cancel payment mandates for AI agents
• Token Generation: Secure payment tokens with TTL for agent transactions
• Checkout Sessions: Complete shopping cart management for AI agents
• Payment Processing: Token-based payments with PSP routing and failover
• Agent Integration: Direct integration with AI agents and chatbots

🔒 Enterprise Features

• Multi-tenant Support: Isolated data per organization
• Audit Logs: Complete transaction audit trail
• Custom Webhooks: Real-time payment event notifications
• Rate Limiting: Tier-based API access control
• OAuth2 + API Key: Hybrid authentication system

🌍 Global Support

• Multi-currency: USD, EUR, TRY, GBP, and more
• Turkish PSPs: PayTR, İyzico, Papara integration
• Global PSPs: Stripe, PayPal, Adyen support
• Real-time: Instant payment confirmations

🎯 Use Cases

🤖 AI Chatbots & Agents

// AI agent processes payment
const payment = await shora.agents.pay({
  token: agentToken,
  amount: 150.00,
  currency: 'USD',
  description: 'AI Service Subscription'
});

🛒 E-commerce Integration

// E-commerce checkout
const session = await shora.createPaymentSession({
  amount: 9999, // $99.99
  currency: 'USD',
  customer: { email: 'customer@example.com' },
  items: [
    { name: 'Premium Plan', price: 9999, quantity: 1 }
  ]
});

🔄 Subscription Management

// Recurring payments
const mandate = await shora.agents.createMandate({
  agent_id: 'subscription-bot',
  max_amount: 5000.00,
  currency: 'USD',
  expires_at: '2025-12-31T23:59:59Z'
});

🚀 Getting Started

1. Get Your API Key

Free Tier: Get started for free

• 100 transactions/month
• Sandbox environment
• Basic support

Pro Tier: Upgrade to Pro

• 10,000 transactions/month
• Production environment
• Priority support
• Advanced features

2. Install the SDK

npm install shora-ai-payment-sdk

3. Initialize and Start Building

import ShoraSDK from 'shora-ai-payment-sdk';

const shora = new ShoraSDK({
  apiKey: process.env.SHORA_API_KEY,
  environment: 'sandbox'
});

// Your AI agent is ready to process payments!

📚 API Reference

🤖 Agent Payment Endpoints

💳 Payment Endpoints

🔗 Webhook Endpoints

💡 Example Usage

Basic Payment Flow

// 1. Create payment session
const session = await shora.createPaymentSession({
  amount: 2999, // $29.99
  currency: 'USD',
  description: 'AI Service Subscription',
  customer: {
    email: 'user@example.com',
    name: 'John Doe'
  }
});

// 2. Process payment
const payment = await shora.processPayment({
  sessionId: session.id,
  paymentMethod: 'card',
  cardToken: 'tok_1234567890'
});

// 3. Handle webhook
app.post('/webhook', (req, res) => {
  const event = req.body;
  if (event.type === 'payment.completed') {
    console.log('Payment completed:', event.data);
  }
});

AI Agent Integration

// AI agent creates mandate
const mandate = await shora.agents.createMandate({
  agent_id: 'chatbot-123',
  max_amount: 1000.00,
  currency: 'USD',
  expires_at: '2025-12-31T23:59:59Z'
});

// Generate secure token
const token = await shora.agents.generateToken({
  mandate_id: mandate.id,
  amount: 150.00,
  currency: 'USD'
});

// Process payment with token
const payment = await shora.agents.pay({
  token: token.value,
  amount: 150.00,
  currency: 'USD'
});

🎮 Demo & Examples

Live Demo

Try it now: demo.shora.co

Local Demo

# Clone the repository
git clone https://github.com/shoraco/shora-ai-payment-sdk
cd shora-ai-payment-sdk

# Install dependencies
npm install

# Run the demo
npm run demo

Demo Features

1. 🤖 AI Chatbot - Interactive payment flow
2. 💳 Payment Processing - Real payment simulation
3. 🔔 Webhook Handling - Real-time notifications
4. 📊 Analytics - Transaction monitoring
5. 🔧 Developer Tools - API explorer

🏢 Enterprise Features

🔐 Advanced Security

• OAuth2 + API Key: Hybrid authentication system
• Multi-tenant: Isolated data per organization
• Audit Logs: Complete transaction audit trail
• Rate Limiting: Tier-based API access control

📊 Analytics & Monitoring

• Real-time Dashboard: app.shora.cloud
• Transaction Analytics: Revenue tracking and insights
• Webhook Management: Custom event notifications
• Performance Monitoring: API response times and uptime

🌍 Global Infrastructure

• Multi-currency: USD, EUR, TRY, GBP, and more
• Turkish PSPs: PayTR, İyzico, Papara integration
• Global PSPs: Stripe, PayPal, Adyen support
• Cloudflare CDN: Worldwide low-latency access

💰 Pricing

Get started: app.shora.cloud/signup

Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Agent      │───▶│  Shora SDK     │───▶│  Shora Core    │
│   (Chatbot)     │    │                 │    │  (Payment      │
│                 │    │  Mandate        │    │   Processing)   │
│                 │    │  Management     │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                │
                                ▼
                       ┌─────────────────┐
                       │   Turkish PSPs  │
                       │   (PayTR,       │
                       │    İyzico,      │
                       │    Papara)      │
                       └─────────────────┘

Security

• Token-based Authentication: Secure payment tokens with TTL
• Mandate Validation: AI agent authorization verification
• PCI Compliance: No PCI data exposure
• Rate Limiting: Built-in request rate limiting
• Webhook Security: HMAC signature verification

Development

Prerequisites

• Node.js 18+
• npm or yarn
• Shora Core API access

Local Development

# Install dependencies
npm install

# Copy environment file
cp env.example .env

# Start development server
npm run dev

# Run tests
npm test

# Run demo
npm run demo

Enterprise Development

# Run all tests
npm run test

# Run load tests
npm run test:load

# Run security tests
npm run test:security

# Run linting
npm run lint

# Build for production
npm run build

Environment Variables

SHORA_API_KEY=your_api_key_here
SHORA_BASE_URL=https://api.shora.cloud
SHORA_WEBHOOK_SECRET=your_webhook_secret

License

MIT License - see LICENSE file for details.

Support

• Documentation: https://docs.shora.co
• API Reference: https://api.shora.cloud/docs
• Support Email: dev@shora.co
• GitHub Issues: https://github.com/shora-ai/shora-ai-payment-sdk/issues

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

Roadmap

• Webhook handling for payment events
• Multi-currency support
• Advanced fraud detection
• Real-time payment status updates
• Integration with popular AI frameworks

🚀 Community & Support

📚 Resources

• 📖 Documentation: docs.shora.co
• 🎮 Live Demo: demo.shora.co
• 💬 Discord: discord.gg/shora
• 🐦 Twitter: @shora_co

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• Email: dev@shora.co
• GitHub Issues: Create an issue
• Discord: Join our community

Shora AI Payment SDK - Commerce infrastructure for the AI era