ProBuy Logo
PB

ProBuy Docs

Version 1.0

Integration Documentation

Your comprehensive guide to integrating ProBuy's Buy Now, Pay Later solutions across digital channels. From portal configuration to custom API implementations, we've got you covered.

Get startedView API docs

Quick Start Guide

1

Get to Know ProBuy

Learn about ProBuy's Prosplit platform and capabilities

2

Integration Journey

Complete roadmap from supplier onboarding to production launch

3

Getting Started

Complete guide to getting started with ProBuy payment integration

4

Choose Your SDK

Pick the backend SDK, checkout SDK, or direct API integration

5

Test & Launch

Run sandbox flows, verify webhooks, and complete the go-live checklist

End-to-End Journey

Follow the recommended sequence to deliver a production-ready integration without missing critical portal configuration or Sandbox checkpoints.

View detailed journey
1

Getting Started

Complete guide to getting started with ProBuy integration.

2

Credentials & Setup

Issue API tokens, configure webhooks, and map events.

3

Integration Build

Implement your chosen SDK or direct API flow.

4

Quality Assurance

Cover success, decline, cancel, and settlement scenarios.

5

Go-Live & Monitoring

Switch to production tokens and keep dashboards on watch.

Integration Example

// Install the ProBuy Backend SDK
npm install @probuy/backend-sdk


// Initialize ProBuy Backend SDK
import { ProBuyBackendSDK } from '@probuy/backend-sdk';


const probuy = new ProBuyBackendSDK({
  apiToken: process.env.PROBUY_API_TOKEN,
  environment: 'sandbox' // 'sandbox' or 'prod'
});


// Create a checkout session
const session = await probuy.createCheckoutWithRedirectUrl({
  order_reference_id: 'order-123',
  order_number: 'ORD-123',
  currency: 'SAR',
  total_amount: 500,
  consumer: {
    first_name: 'Ahmed',
    last_name: 'Ali',
    email: '[email protected]',
    phone_number: '+966501234567'
  },
  country_code: 'SA',
  merchant_url: {
    success: 'https://yoursite.com/success',
    failure: 'https://yoursite.com/failure',
    cancel: 'https://yoursite.com/cancel'
  },
  // ... more fields
});


// Redirect customer to checkout
console.log('Redirect to:', session.redirect_url);