Testing Guide

Thoroughly testing your ProBuy integration is critical to ensure a smooth payment experience for your customers. This guide covers testing strategies, test scenarios, and best practices for all integration types.

Testing Environments

ProBuy provides separate environments for testing and production:

Test Scenarios

Test all possible payment outcomes to ensure your integration handles each scenario correctly:

1. Successful Payment (Approved)

2. Declined Payment

3. Cancelled Payment

4. Session Timeout

Integration Testing Checklist

Basic Integration Tests

• ✅ SDK/API initialization successful
• ✅ API token authentication working
• ✅ Payment button displays correctly
• ✅ Checkout session creates successfully
• ✅ Customer redirected to ProBuy portal
• ✅ Return URLs working (success, failure, cancel)
• ✅ Order data passed correctly
• ✅ Payment status retrieved accurately

Data Validation Tests

• ✅ Email validation working
• ✅ Phone number format validation
• ✅ Amount within min/max limits (100-50000)
• ✅ Currency code validation (SAR)
• ✅ Country code validation (SA)
• ✅ Required fields enforced
• ✅ Order reference ID uniqueness
• ✅ Special characters handled correctly

User Experience Tests

• ✅ Mobile responsive on iOS and Android
• ✅ Cross-browser compatibility (Chrome, Safari, Firefox, Edge)
• ✅ Loading states display correctly
• ✅ Error messages user-friendly
• ✅ Success confirmation clear
• ✅ Page load times acceptable (<3 seconds)
• ✅ No JavaScript errors in console
• ✅ Accessibility requirements met (WCAG 2.1)

Security Tests

• ✅ HTTPS enabled on all pages
• ✅ API tokens not exposed in client-side code
• ✅ CSRF protection implemented
• ✅ XSS protection in place
• ✅ Payment verification done server-side
• ✅ No sensitive data in URLs
• ✅ Secure cookie settings
• ✅ Content Security Policy configured

Error Handling Tests

• ✅ Network failure handled gracefully
• ✅ API timeout handled
• ✅ Invalid token error shown
• ✅ Rate limiting handled
• ✅ Server error (500) handled
• ✅ Validation errors displayed clearly
• ✅ Retry mechanism for failures
• ✅ Error logging implemented

Performance Testing

Load Testing

Test your integration under various load conditions:

Performance Metrics to Monitor

• **API Response Time:** <2 seconds average
• **Page Load Time:** <3 seconds
• **Time to Interactive:** <5 seconds
• **Error Rate:** <0.5%
• **Success Rate:** >99%
• **Server CPU Usage:** <70%
• **Memory Usage:** Stable, no leaks

Mobile Testing

Device Testing Matrix

Mobile-Specific Tests

• ✅ Touch targets minimum 44x44 pixels
• ✅ Text readable without zoom
• ✅ Forms easy to fill on mobile
• ✅ Payment button accessible with thumb
• ✅ Portrait and landscape orientations
• ✅ Works on slow 3G connection
• ✅ Deep links working correctly
• ✅ App switching handled properly

Automated Testing

Unit Tests Example

// Jest test example
describe('ProBuy Integration', () => {
  test('creates checkout session with valid data', async () => {
    const orderData = {
      order_reference_id: 'TEST-001',
      currency: 'SAR',
      total_amount: 1500,
      consumer: {
        email: '[email protected]',
        first_name: 'Test',
        last_name: 'User'
      },
      country_code: 'SA'
    };

    const result = await createCheckout(orderData);

    expect(result.checkout_id).toBeDefined();
    expect(result.checkout_url).toContain('company.probuy.me');
    expect(result.status).toBe('pending');
  });

  test('handles invalid email format', async () => {
    const orderData = {
      consumer: {
        email: 'invalid-email',
        // ... other fields
      }
    };

    await expect(createCheckout(orderData))
      .rejects
      .toThrow('Invalid email format');
  });
});

E2E Tests Example (Playwright)

// Playwright E2E test
test('complete payment flow', async ({ page }) => {
  // Navigate to product page
  await page.goto('https://yourstore.com/products/laptop');

  // Add to cart
  await page.click('button:has-text("Add to Cart")');

  // Go to checkout
  await page.click('a:has-text("Checkout")');

  // Select ProBuy payment
  await page.click('button:has-text("Pay with ProBuy")');

  // Wait for redirect to ProBuy
  await page.waitForURL(/company\.probuy\.dev/);

  // Verify checkout page loaded
  await expect(page.locator('h1')).toContainText('Complete Your Purchase');

  // Fill in test customer details
  await page.fill('input[name="email"]', '[email protected]');
  await page.fill('input[name="phone"]', '+966501234567');

  // Submit payment
  await page.click('button:has-text("Complete Payment")');

  // Wait for success redirect
  await page.waitForURL(/yourstore\.com.*success/);

  // Verify success page
  await expect(page.locator('h1')).toContainText('Order Confirmed');
});

Test Data Reference

Use these test credentials in development/sandbox environments:

Test Email Addresses

Company Portal Test Accounts

Use these test accounts to access the Company Portal and experience the complete payment flow from the supplier/merchant perspective:

Test Cards

Use these test cards in sandbox environment for different payment scenarios:

Knet Cards

Visa/Mastercard

Benefit Cards

American Express (AMEX)

Mada Cards

STC Pay

See the Test Cards Guide for more test data including phone numbers and amounts.

Pre-Production Checklist

Before switching to production, verify all items on this checklist:

See our detailed Go-Live Checklist for complete preparation guide.

Monitoring and Logging

Key Metrics to Monitor

• **Payment Success Rate:** Target >95%
• **Average Response Time:** Target <2 seconds
• **Error Rate:** Target <1%
• **Session Completion Rate:** Track abandoned checkouts
• **Approval Rate:** Monitor trends
• **API Availability:** Target 99.9% uptime

Logging Best Practices

// Example logging implementation
function logCheckoutEvent(event, data) {
  const logEntry = {
    timestamp: new Date().toISOString(),
    event: event,
    checkout_id: data.checkout_id,
    order_reference_id: data.order_reference_id,
    amount: data.total_amount,
    currency: data.currency,
    status: data.status,
    user_agent: navigator.userAgent,
    // Do NOT log sensitive data like customer PII
  };

  // Send to your logging service
  logger.info('ProBuy Checkout Event', logEntry);

  // Track in analytics
  analytics.track(event, {
    checkout_id: data.checkout_id,
    value: data.total_amount,
    currency: data.currency
  });
}

// Usage
logCheckoutEvent('checkout_created', checkoutData);
logCheckoutEvent('checkout_completed', checkoutData);
logCheckoutEvent('checkout_failed', { ...checkoutData, error: error.message });

Troubleshooting Failed Tests

Getting Help

If you encounter issues during testing:

Next Steps