Shora AI Payment SDK

Quick Start

# 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 the SDK
const shora = new ShoraSDK({
  apiKey: process.env.SHORA_API_KEY,
  environment: 'sandbox'
});

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

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

Installation

npm install shora-ai-payment-sdk
# or
yarn add shora-ai-payment-sdk

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

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

Demo

Run the included demo to see the SDK in action:

git clone https://github.com/shoraco/shora-ai-payment-sdk
cd shora-ai-payment-sdk
npm install
npm run demo

The demo includes:

• AI chatbot payment integration
• Real payment processing simulation
• Webhook event handling

Why Choose Shora?

Built specifically for the AI era, Shora provides everything you need to integrate payments into AI agents and chatbots.

Features

ACP (Agentic Commerce Protocol) Compatible

• Full compliance with OpenAI/Stripe ACP specification
• Direct integration with ChatGPT and other AI agents
• Secure payment token sharing between buyers and businesses
• Merchants maintain customer relationships and product control

AI Agent Features

• Create, activate, and cancel payment mandates for AI agents
• Secure payment tokens with TTL for agent transactions
• Complete shopping cart management for AI agents
• Token-based payments with PSP routing and failover
• Direct integration with AI agents and chatbots

Enterprise Features

• Multi-tenant support with isolated data per organization
• Complete transaction audit trail
• Real-time payment event notifications
• Tier-based API access control
• OAuth2 + API key hybrid authentication

Global Support

• Multi-currency support for USD, EUR, TRY, GBP, and more
• Turkish PSP integration with PayTR, İyzico, Moka United
• Global PSP support including Stripe, PayPal, Adyen
• Instant payment confirmations

Use Cases

ACP Integration

// ACP-compatible checkout for AI agents
const checkout = await shora.createACPCheckout({
  amount: 150.00,
  currency: 'USD',
  description: 'AI Service Subscription',
  agent_id: 'chatgpt-user-123',
  business_id: 'merchant-456',
  product_id: 'service-premium',
  quantity: 1,
  customer: {
    email: 'user@example.com',
    name: 'John Doe'
  }
});

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

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

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

Global Infrastructure

• Multi-currency: USD, EUR, TRY, GBP, and more
• Turkish PSPs: PayTR, İyzico, Moka United 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,      │
                       │    Moka)      │
                       └─────────────────┘

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 (80% coverage)
npm test

# Run linting
npm run lint

# Run demo
npm run demo

Testing & Quality

# Run all tests (80% coverage)
npm test

# Run unit tests only
npm run test:unit

# Run integration tests
npm run test:integration

# Run with coverage report
npm run test:coverage

# Run linting
npm run lint

# Build for production
npm run build

Test Coverage: 80%+ coverage with Jest framework Code Quality: ESLint + Prettier for consistent code style API Documentation: Swagger docs available at api.shora.cloud/docs

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
• 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