Get Started with ZendFi

Accept SOL, USDC, and USDT payments in 5 minutes. No blockchain knowledge required.

Quick Start (Using SDK)

The fastest way to integrate ZendFi:

1. Install the SDK

npm install @zendfi/sdk

2. Get your API key

Sign up at zendfi.tech to get your test API key.

3. Create a payment

import { zendfi } from '@zendfi/sdk';

// Set your API key (environment variable recommended)
// ZENDFI_API_KEY=zfi_test_your_key_here

const payment = await zendfi.createPayment({
  amount: 50,
  description: 'Premium subscription',
  customer_email: 'customer@example.com',
});

console.log('Payment URL:', payment.payment_url);
// Send customer to: payment.payment_url

Done! Customer scans QR code or clicks link. Funds arrive in your wallet instantly.

Alternative: Embed Checkout in Your App

Want customers to pay without leaving your site? Use embedded checkout:

import { ZendFiClient, ZendFiEmbeddedCheckout } from '@zendfi/sdk';

// 1. Create payment link (backend)
const client = new ZendFiClient({ apiKey: process.env.ZENDFI_API_KEY });
const link = await client.createPaymentLink({
  amount: 50,
  description: 'Premium subscription',
  currency: 'USD',
  token: 'USDC',
});

// 2. Embed checkout (frontend)
const checkout = new ZendFiEmbeddedCheckout({
  linkCode: link.link_code,
  containerId: 'checkout-container', // HTML element ID
  mode: 'test',
  
  onSuccess: (payment) => {
    console.log('Payment successful!', payment);
    // Show success message, unlock features, etc.
  },
});

await checkout.mount();

Add container in your HTML:

<div id="checkout-container"></div>

The checkout appears directly in your app—no redirects! Learn more →

Detailed Setup (API)

Prefer to use the REST API directly? Here's the complete flow.

Step 1: Create Your Merchant Account

curl -X POST https://api.zendfi.tech/api/v1/merchants \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Store",
    "email": "merchant@example.com",
    "business_address": "123 Main St, San Francisco, CA",
    "wallet_generation_method": "mpc_passkey"
  }'

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My Store",
  "email": "merchant@example.com",
  "api_key": "zfi_test_abc123...",
  "passkey_setup_url": "https://api.zendfi.tech/merchants/550e.../setup-passkey",
  "created_at": "2025-10-26T12:00:00Z"
}

Save Your API Key

Your api_key is shown only once! Store it securely in environment variables.

Wallet Options

Option	Description	Best For
MPC Passkey	Non-custodial wallet with biometric auth	Most users (recommended)
External Wallet	Use your existing Solana wallet	Advanced users with existing setup

MPC Passkey (No seed phrases!):

• No seed phrases to manage
• Export private keys anytime
• Withdraw funds via API
• Secure with WebAuthn/passkeys

{
  "wallet_generation_method": "mpc_passkey"
}

External Wallet:

{
  "wallet_generation_method": "external",
  "wallet_address": "YOUR_SOLANA_WALLET_ADDRESS"
}

Step 2: Set Up Passkey (MPC Only)

If you chose MPC passkey:

1. Open the passkey_setup_url from the response
2. Click "Register Passkey"
3. Complete biometric authentication (Face ID/Touch ID)
4. Wait 5-10 seconds for wallet generation

Done! Your wallet is ready.

Step 3: Test Your API Key

curl https://api.zendfi.tech/api/v1/merchants/me \
  -H "Authorization: Bearer YOUR_API_KEY"

Step 4: Create Your First Payment

curl -X POST https://api.zendfi.tech/api/v1/payments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50,
    "currency": "USD",
    "description": "Premium subscription",
    "customer_email": "customer@example.com"
  }'

Response:

{
  "id": "pay_abc123",
  "amount": 50,
  "currency": "USD",
  "status": "Pending",
  "payment_url": "https://checkout.zendfi.tech/pay/pay_abc123",
  "qr_code": "data:image/png;base64,...",
  "expires_at": "2025-12-22T12:15:00Z",
  "mode": "test"
}

Send your customer to payment_url or show them the qr_code. Done!

API Key Modes

ZendFi uses smart API keys that auto-route to the correct network:

Mode	Prefix	Network	Purpose
Test	zfi_test_	Solana Devnet	Development (free)
Live	zfi_live_	Solana Mainnet	Production (real money)

No configuration needed. The SDK/API detects the mode from your key prefix.

Next Steps

Set Up Webhooks

Get notified when payments are confirmed:

// Next.js example
import { createNextWebhookHandler } from '@zendfi/sdk/next';

export const POST = createNextWebhookHandler({
  secret: process.env.ZENDFI_WEBHOOK_SECRET!,
  handlers: {
    PaymentConfirmed: async (event) => {
      // Payment received! Fulfill order
      const payment = event.data;
      await fulfillOrder(payment.metadata.orderId);
    },
  },
});

Full Webhook Guide →

Add Subscriptions

Recurring billing with trials and webhooks:

const subscription = await zendfi.createSubscription({
  plan_id: 'plan_xyz',
  customer_wallet: '7xKXtg...',
  customer_email: 'customer@example.com',
});

Subscriptions Guide →

Test vs Live Mode

Test Mode (Free)

• Uses Solana devnet (test network)
• Get free SOL from sol-faucet.com
• All tokens are worthless (for testing only)
• Perfect for development

Live Mode (Production)

• Uses Solana mainnet (real network)
• Real crypto transactions
• ~$0.0001 network fees (we cover it with 0.6% platform fee)
• Ready for customers

Switch between modes by changing your API key. That's it!

Getting Help

• Discord: discord.gg/zendfi
• Email: support@zendfi.tech
• Docs: Full API Reference →

Ready to scale? Check out Payment Links and Subscriptions.

Example Request

curl -X POST https://api.zendfi.tech/api/v1/payments \
  -H "Authorization: Bearer zfi_test_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25.00,
    "currency": "USD",
    "token": "USDC",
    "description": "Premium Subscription",
    "customer_email": "customer@example.com",
    "metadata": {
      "order_id": "ORD-12345",
      "product": "premium_plan"
    }
  }'

Response

{
  "id": "pay_abc123xyz789",
  "amount": 25.00,
  "currency": "USD",
  "status": "Pending",
  "payment_url": "https://checkout.zendfi.tech/pay/pay_abc123xyz789",
  "qr_code": "data:image/png;base64,...",
  "expires_at": "2025-10-26T12:15:00Z",
  "mode": "test"
}

Payment Flow

1. Create payment → Get payment_url and qr_code
2. Customer pays → Scans QR or clicks link
3. Webhook fired → PaymentConfirmed event sent to your server
4. Funds received → Check your wallet balance!

Step 5: Handle Webhooks

Set up a webhook endpoint to receive real-time payment notifications:

// Express.js example
app.post('/webhooks/zendfi', (req, res) => {
  const { event, data } = req.body;
  
  switch (event) {
    case 'PaymentConfirmed':
      // Payment successful!
      console.log(`Payment ${data.id} confirmed!`);
      // Fulfill the order...
      break;
    case 'PaymentFailed':
      // Payment failed
      console.log(`Payment ${data.id} failed`);
      break;
  }
  
  res.status(200).send('OK');
});

Webhook Verification

Always verify webhook signatures in production. See the Webhooks documentation for details.

Using the SDK

For a better developer experience, use our TypeScript SDK:

import { zendfi } from '@zendfi/sdk';

// Zero-config: API key auto-loaded from ZENDFI_API_KEY env var
// Mode (test/live) auto-detected from API key prefix

// Create a payment
const payment = await zendfi.createPayment({
  amount: 25.00,
  description: 'Premium Subscription'
});

console.log(`Payment URL: ${payment.payment_url}`);

What's Next?

Now that you have the basics down, explore more features:

• Payments API - Full payment API reference
• Subscriptions - Recurring billing
• Payment Links - Reusable payment URLs
• Webhooks - Event notifications
• API Reference - Complete API documentation with SDK examples

Need Help?

• Email: support@zendfi.tech
• Discord: discord.gg/zendfi
• API Reference: api.zendfi.tech

Happy building!