Direct API Integration Quick Start

// Example: Node.js with Express
import express from 'express';
import axios from 'axios';

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

// Store your API token securely
const PROBUY_API_TOKEN = process.env.PROBUY_API_TOKEN;
const PROBUY_API_URL = 'https://api.probuy.me'; // Use 'https://sandboxapi.probuy.dev' for sandbox

// Your backend endpoint (not ProBuy's API)
app.post('/api/checkout', async (req, res) => {
  try {
    // Prepare order data from your frontend
    const orderData = {
      order_reference_id: 'ref-' + Date.now(),
      order_number: req.body.orderNumber,
      currency: 'SAR',
      total_amount: req.body.totalAmount,
      tax_amount: req.body.taxAmount,
      consumer: req.body.consumer,
      country_code: 'SA',
      merchant_url: {
        success: 'https://yoursite.com/payment/success',
        failure: 'https://yoursite.com/payment/failure',
        cancel: 'https://yoursite.com/payment/cancel'
      },
      billing_address: req.body.billingAddress,
      items: req.body.items
    };

    // Call ProBuy API
    const response = await axios.post(
      `${PROBUY_API_URL}/api/checkouts/session`,
      orderData,
      {
        headers: {
          'Authorization': `Bearer ${PROBUY_API_TOKEN}`,
          'Content-Type': 'application/json'
        }
      }
    );

    // Return checkout URL to frontend
    res.json({
      success: true,
      checkoutUrl: response.data.checkout_url
    });

  } catch (error) {
    console.error('Checkout error:', error);
    res.status(500).json({
      success: false,
      error: 'Failed to create checkout session'
    });
  }
});

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

<!-- Your checkout form -->
<form id="checkout-form">
  <input type="text" id="firstName" placeholder="First Name" required>
  <input type="text" id="lastName" placeholder="Last Name" required>
  <input type="email" id="email" placeholder="Email" required>
  <input type="tel" id="phone" placeholder="Phone Number" required>

  <!-- Billing Address -->
  <input type="text" id="address" placeholder="Address" required>
  <input type="text" id="city" placeholder="City" required>

  <button type="submit">Proceed to Payment</button>
</form>

<script>
document.getElementById('checkout-form').addEventListener('submit', async (e) => {
  e.preventDefault();

  // Collect form data
  const orderData = {
    orderNumber: 'ORD-' + Date.now(),
    totalAmount: 1500.00, // Your cart total
    taxAmount: 225.00,
    consumer: {
      first_name: document.getElementById('firstName').value,
      last_name: document.getElementById('lastName').value,
      email: document.getElementById('email').value,
      phone_number: document.getElementById('phone').value
    },
    billingAddress: {
      line1: document.getElementById('address').value,
      city: document.getElementById('city').value,
      country_code: 'SA'
    },
    items: [
      {
        name: 'Order Items',
        type: 'Physical',
        quantity: 1,
        unit_price: 1275,
        total_amount: 1500
      }
    ]
  };

  // Call YOUR backend (not ProBuy directly)
  const response = await fetch('/api/checkout', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(orderData)
  });

  const result = await response.json();

  if (result.success) {
    // Redirect to ProBuy checkout
    window.location.href = result.checkoutUrl;
  } else {
    alert('Payment initialization failed');
  }
});
</script>

// success.html - Payment successful
const urlParams = new URLSearchParams(window.location.search);
const checkoutId = urlParams.get('checkout_id');
const status = urlParams.get('status');

if (status === 'approved') {
  // Verify on backend and complete order
  fetch('/api/verify-payment', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ checkoutId })
  })
  .then(res => res.json())
  .then(data => {
    if (data.verified) {
      showSuccessMessage('Payment completed successfully!');
      clearCart();
    }
  });
}

// failure.html - Payment failed
if (status === 'declined') {
  showErrorMessage('Payment was declined. Please try again.');
  // Optionally show retry button
}

// cancel.html - User cancelled
if (status === 'cancelled') {
  showInfoMessage('Payment was cancelled. Your cart has been saved.');
  // Redirect back to cart
}

// Backend endpoint to verify payment
app.post('/api/verify-payment', async (req, res) => {
  const { checkoutId } = req.body;

  try {
    // Get checkout details from ProBuy
    const response = await axios.get(
      `${PROBUY_API_URL}/api/checkouts/${checkoutId}`,
      {
        headers: {
          'Authorization': `Bearer ${PROBUY_API_TOKEN}`
        }
      }
    );

    const checkout = response.data;

    if (checkout.status === 'approved') {
      // Payment successful - complete the order
      await completeOrder(checkout.order_reference_id);

      res.json({
        verified: true,
        orderNumber: checkout.order_number
      });
    } else {
      res.json({
        verified: false,
        status: checkout.status
      });
    }
  } catch (error) {
    console.error('Verification error:', error);
    res.status(500).json({ error: 'Verification failed' });
  }
});