Integration Examples

Complete integration examples and patterns for common use cases. Use these as starting points for your implementation.

Complete Payment Flow

This example shows the complete flow from tokenization to payment processing.

JavaScript / Node.js Example

Full payment processing flow with error handling

// Complete payment flow example
async function processPayment(cardData, amount, currency) {
  try {
    // Step 1: Tokenize card data
    const tokenResponse = await fetch('https://api.demo-gateway.com/v1/tokens', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_SECRET_KEY',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        card_number: cardData.number,
        expiry_month: cardData.expiryMonth,
        expiry_year: cardData.expiryYear,
        cvv: cardData.cvv,
        cardholder_name: cardData.name,
      }),
    });
    
    const { token_id } = await tokenResponse.json();
    
    // Step 2: Create payment with token
    const paymentResponse = await fetch('https://api.demo-gateway.com/v1/payments', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_SECRET_KEY',
        'Content-Type': 'application/json',
        'Idempotency-Key': generateIdempotencyKey(),
      },
      body: JSON.stringify({
        token_id,
        amount,
        currency,
        description: 'Order #12345',
      }),
    });
    
    const payment = await paymentResponse.json();
    
    // Step 3: Handle response
    if (payment.status === 'succeeded') {
      return { success: true, payment_id: payment.payment_id };
    } else if (payment.status === 'pending') {
      // Poll for status or wait for webhook
      return { success: true, pending: true, payment_id: payment.payment_id };
    } else {
      return { success: false, error: payment.error };
    }
  } catch (error) {
    return { success: false, error: error.message };
  }
}