ProBuy Backend SDK for Node.js

npm install @probuy/backend-sdk
# or
yarn add @probuy/backend-sdk
# or
pnpm add @probuy/backend-sdk

const session = await probuy.createCheckoutSession(orderData);

// Success Response:
{
  checkout_id: "38a41884-4828-4e1f-a9d6-a472c5c56ec5",
  order_reference_id: "ref-1729425600",
  checkout_url: "https://company.probuy.me/checkout/38a41884-4828-4e1f-a9d6-a472c5c56ec5",
  status: "new",
  expires_at: "2025-10-20T12:00:00Z",
  created_at: "2025-10-20T11:00:00Z"
}

const checkoutUrl = probuy.getCheckoutUrl(checkoutId);
// Returns: https://company.probuy.me/checkout/{checkout_id}

// For development environment:
// Returns: https://probuycompanyportaldev.z1.web.core.windows.net/checkout/{checkout_id}

const result = await probuy.createCheckoutWithRedirectUrl(orderData);

// Response includes all session data plus redirect_url:
{
  checkout_id: string;
  order_reference_id: string;
  checkout_url: string;
  status: string;
  expires_at: string;
  created_at: string;
  redirect_url: string; // Full URL for customer redirection
}

const details = await probuy.getCheckoutDetails(checkoutId);

// Success Response:
{
  checkout_id: "38a41884-4828-4e1f-a9d6-a472c5c56ec5",
  order_reference_id: "ref-1729425600",
  order_number: "ORD-12345",
  currency: "SAR",
  total_amount: 1000.00,
  tax_amount: 150.00,
  status: "approved", // new, approved, authorized, declined, expired, cancelled, completed
  consumer: {
    email: "[email protected]",
    first_name: "Ahmed",
    last_name: "Ali",
    phone_number: "+966501234567"
  },
  created_at: "2025-10-20T11:00:00Z",
  updated_at: "2025-10-20T11:15:00Z",
  expires_at: "2025-10-20T12:00:00Z",
  merchant_url: {
    success: "https://yoursite.com/payment/success",
    failure: "https://yoursite.com/payment/failed",
    cancel: "https://yoursite.com/payment/cancelled"
  }
}

import {
  ProBuyError,
  ProBuyValidationError,
  ProBuyAuthenticationError,
  ProBuyNetworkError,
  ProBuyApiError
} from '@probuy/backend-sdk';

try {
  const session = await probuy.createCheckoutSession(orderData);
} catch (error) {
  if (error instanceof ProBuyValidationError) {
    // Invalid order data - Error Response Example:
    // {
    //   error: "ValidationError",
    //   message: "Invalid request data",
    //   details: {
    //     total_amount: "Must be greater than 100",
    //     consumer.email: "Invalid email format"
    //   }
    // }
    console.error('Validation error:', error.message, error.details);
    return { error: 'Invalid order data', details: error.details };
  }
  else if (error instanceof ProBuyAuthenticationError) {
    // Invalid or expired API token - Error Response Example:
    // {
    //   error: "AuthenticationError",
    //   message: "Invalid or expired API token"
    // }
    console.error('Authentication error:', error.message);
    return { error: 'Authentication failed' };
  }
  else if (error instanceof ProBuyNetworkError) {
    // Network connectivity issues
    console.error('Network error:', error.message);
    return { error: 'Connection failed, please try again' };
  }
  else if (error instanceof ProBuyApiError) {
    // API returned an error - Error Response Example:
    // {
    //   error: "ServerError",
    //   message: "An unexpected error occurred. Please try again later.",
    //   statusCode: 500
    // }
    console.error('API error:', error.statusCode, error.message);
    return { error: 'Payment service error' };
  }
  else {
    // Unknown error
    console.error('Unknown error:', error);
    return { error: 'An unexpected error occurred' };
  }
}

{
  "error": "ValidationError",
  "message": "Invalid request data",
  "details": {
    "total_amount": "Must be greater than 100",
    "consumer.email": "Invalid email format",
    "currency": "SAR"
  }
}

{
  "error": "AuthenticationError",
  "message": "Invalid or expired API token"
}

{
  "error": "ServerError",
  "message": "An unexpected error occurred. Please try again later."
}

import {
  ProBuyBackendSDK,
  ProBuyConfig,
  CheckoutOrderData,
  CheckoutSessionResponse,
  CheckoutDetailedResponse,
  ProBuyEnvironment
} from '@probuy/backend-sdk';

// Type-safe configuration
const config: ProBuyConfig = {
  apiToken: process.env.PROBUY_API_TOKEN!,
  environment: 'sandbox' as ProBuyEnvironment,
  debug: true
};

const probuy = new ProBuyBackendSDK(config);

// Type-safe order data
const orderData: CheckoutOrderData = {
  order_reference_id: 'ref-123',
  order_number: 'ORD-123',
  currency: 'SAR',
  total_amount: 1000,
  // ... TypeScript will validate all fields
};

// Type-safe responses
const session: CheckoutSessionResponse =
  await probuy.createCheckoutSession(orderData);

const details: CheckoutDetailedResponse =
  await probuy.getCheckoutDetails(session.checkout_id);

import express from 'express';
import { ProBuyBackendSDK } from '@probuy/backend-sdk';

const app = express();
app.use(express.json());

// Initialize SDK
const probuy = new ProBuyBackendSDK({
  apiToken: process.env.PROBUY_API_TOKEN,
  environment: process.env.PROBUY_ENVIRONMENT || 'sandbox',
  debug: process.env.NODE_ENV !== 'production'
});

// Create checkout endpoint
app.post('/api/checkout/create', async (req, res) => {
  try {
    const session = await probuy.createCheckoutWithRedirectUrl(req.body);

    res.json({
      success: true,
      checkout_id: session.checkout_id,
      redirect_url: session.redirect_url
    });
  } catch (error) {
    console.error('Checkout error:', error.message);

    res.status(error.statusCode || 500).json({
      success: false,
      error: error.message,
      code: error.code
    });
  }
});

// Get checkout status
app.get('/api/checkout/:id', async (req, res) => {
  try {
    const details = await probuy.getCheckoutDetails(req.params.id);
    res.json({ success: true, data: details });
  } catch (error) {
    res.status(500).json({ success: false, error: error.message });
  }
});

app.listen(3000, () => {
  console.log('Server running on port 3000');
  console.log('Environment:', probuy.getEnvironment());
});

# ProBuy Configuration
PROBUY_API_TOKEN=your_api_token_here
PROBUY_ENVIRONMENT=sandbox
PROBUY_DEBUG=true

# Server Configuration
NODE_ENV=development
PORT=3000