Integration Guide

app.post('/webhooks/zbd', (req, res) => {
  const event = req.body;

  switch(event.type) {
    case 'ramp.purchase.completed':
      // Payment successful - credit user account
      const { amount, currency, reference_id } = event.data;
      creditUserAccount(reference_id, amount);
      break;

    case 'ramp.purchase.failed':
      // Payment failed - notify user
      notifyUserOfFailure(event.data.reference_id);
      break;

    case 'ramp.kyc.completed':
      // KYC completed - update user status
      updateUserKYCStatus(event.data.user_id);
      break;
  }

  res.status(200).send('OK');
});

import express from 'express';
import { initRampSession, QuoteCurrencyEnum, BaseCurrencyEnum } from '@zbdpay/ramp-ts';

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

// Create session endpoint
app.post('/api/ramp/session', async (req, res) => {
  try {
    const response = await initRampSession({
      apikey: process.env.ZBD_API_KEY,
      email: req.body.email,
      destination: req.body.destination,
      quote_currency: QuoteCurrencyEnum.USD,
      base_currency: BaseCurrencyEnum.BTC,
      webhook_url: `${process.env.BASE_URL}/webhooks/zbd`,
      reference_id: req.user.id,
      metadata: {
        user_id: req.user.id,
        session_id: req.session.id
      }
    });

    res.json({ sessionToken: response.data.session_token });
  } catch (error) {
    res.status(500).json({ error: 'Failed to create session' });
  }
});

// Webhook handler
app.post('/webhooks/zbd', async (req, res) => {
  const event = req.body;

  if (event.type === 'ramp.purchase.completed') {
    // Credit user's account
    await creditUserBalance(
      event.data.reference_id,
      event.data.amount,
      event.data.currency
    );
  }

  res.status(200).send('OK');
});

import React, { useState, useEffect } from 'react';
import { ZBDRamp } from '@zbdpay/ramp-react';

function BuyBitcoin() {
  const [sessionToken, setSessionToken] = useState(null);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    // Fetch session token from backend
    fetch('/api/ramp/session', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        email: user.email,
        destination: user.lightningAddress
      })
    })
    .then(res => res.json())
    .then(data => {
      setSessionToken(data.sessionToken);
      setLoading(false);
    });
  }, []);

  if (loading) return <div>Loading...</div>;

  return (
    <div className="payment-container">
      <h1>Buy Bitcoin</h1>
      <ZBDRamp
        sessionToken={sessionToken}
        onSuccess={(data) => {
          alert('Payment successful!');
          window.location.href = '/wallet';
        }}
        onError={(error) => {
          alert(`Payment failed: ${error.message}`);
        }}
        style={{ width: '100%', height: '600px' }}
      />
    </div>
  );
}