Integration Guide

A complete guide to integrating Traxvo payment processing into your application.

Payment Flow

Customer → Your App → Traxvo API → Blockchain
                ↑         ↓
                └── Webhook ←┘

Customer initiates payment on your website
Your server calls Traxvo to create a deposit address
Display the address to the customer
Customer sends payment
Traxvo detects the deposit and sends webhook
Traxvo forwards funds to your wallet
Your server marks the order as paid

Implementation

1. Create Payment Endpoint

// pages/api/create-payment.js
export default async function handler(req, res) {
  const { orderId, amount, chain, token } = req.body;
 
  const response = await fetch(
    `https://api.traxvo.com/v1/${chain}/${token}/create`,
    {
      method: 'POST',
      headers: {
        'X-API-Key': process.env.TRAXVO_API_KEY,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        callback_url: `${process.env.BASE_URL}/api/webhook`,
        expected_amount: amount,
        metadata: { orderId },
        expires_in: 3600,
      }),
    }
  );
 
  const data = await response.json();
 
  // Store in database
  await db.payment.create({
    orderId,
    depositAddress: data.address_in,
    amount,
    status: 'pending',
  });
 
  res.json({
    address: data.address_in,
    chain: data.chain,
    token: data.token,
  });
}

2. Handle Webhooks

// pages/api/webhook.js
export default async function handler(req, res) {
  // Verify signature first!
  const event = req.body;
 
  if (event.event === 'deposit.completed') {
    await db.payment.update({
      where: { depositAddress: event.address },
      data: { status: 'completed' },
    });
 
    // Fulfill the order
    await fulfillOrder(event.metadata.orderId);
  }
 
  res.status(200).json({ received: true });
}

Security Checklist

Store API key in environment variables
Verify webhook signatures
Use HTTPS for webhook endpoint
Handle duplicate webhooks (idempotency)
Log raw webhook payloads for debugging

Integration Guide

Integration Guide

Payment Flow

Implementation

1. Create Payment Endpoint

2. Handle Webhooks

Security Checklist

On this page