This guide will help you start accepting payments with our API quickly and securely. Follow these steps to begin processing transactions.

​
Step 1: Create Your Account

1

Sign Up

Create your Juicyway business account:

2

Get API Keys

After signing up:

  1. Navigate to Settings → API Keys.

  2. Fetch test and live API keys.

  3. Store keys securely - never expose them in client-side code.

3

Set Up Webhooks

Configure webhooks to receive real-time payment updates:

  1. Go to Settings → Webhooks

  2. Add your webhook URL

​
Step 2: Make Your First API Call

Test your integration with this simple API call:

curl -X POST "https://api-sandbox.spendjuice.com/payment-sessions" \
-H "Authorization: Bearer YOUR_TEST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "customer": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "phone_number": "+2348118873422",
    "billing_address": {
      "line1": "123 Test Lane",
      "city": "Test City",
      "state": "Test State",
      "country": "NG",
      "zip_code": "12345"
    }
  },
  "description": "Test Payment",
  "currency": "NGN",
  "amount": 100000,
  "payment_method": {
    "type": "card"
  },
  "reference": "test-payment-123"
}'

​
Step 3: Test Card Payments

Use these test cards to simulate different payment scenarios:

​
Step 4: Handle Webhooks

Set up webhook handling to receive real-time payment updates. Here’s a basic example:

app.post('/webhooks', (req, res) => {
  const payload = req.body;
  const checksum = payload.checksum;
  const businessId = process.env.BUSINESS_ID;
  
  // Validate webhook signature
  if (!validateSignature(payload, checksum, businessId)) {
    return res.status(401).send('Invalid signature');
  }
  
  // Handle different event types
  switch(payload.event) {
    case 'payment.session.succeeded':
      // Handle successful payment
      break;
    case 'payment.session.failed':
      // Handle failed payment
      break;
  }
  
  res.status(200).send('Webhook received');
});

​
Next Steps

  1. Review our API Authentication guide for secure API access

  2. Set up comprehensive Webhook Handling

  3. Learn about Error Handling

  4. Explore supported Payment Methods

Need Help?

HomeWebhooks