Quick Start Guide

Get up and running with ZEUSXPAY in under 10 minutes

Quick Start Guide

This guide will help you accept your first crypto payment in under 10 minutes.

Prerequisites

A ZEUSXPAY account (sign up here)
Basic knowledge of REST APIs
Your favorite programming language or platform

Step 1: Get Your API Keys

Log in to your ZEUSXPAY Dashboard
Navigate to Settings → API Keys
Click Create API Key
Copy your Secret Key (it starts with sk_test_ for test mode)

⚠️ Important: Keep your secret key safe and never share it publicly.

Step 2: Create Your First Order

Use our API to create a payment order. Here’s an example:

curl -X POST https://sandbox-api.zeusxpay.io/v1/orders 
  -H "Authorization: Bearer sk_test_YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "amount": 100.00,
    "currency": "USD",
    "crypto_currency": "BTC",
    "description": "Test payment",
    "customer_email": "customer@example.com",
    "return_url": "https://yoursite.com/success",
    "cancel_url": "https://yoursite.com/cancel"
  }'

Response

{
	"id": "ord_1234567890",
	"status": "pending",
	"amount": 100.0,
	"currency": "USD",
	"crypto_currency": "BTC",
	"crypto_amount": 0.00234567,
	"payment_url": "https://pay.zeusxpay.io/ord_1234567890",
	"expires_at": "2024-01-01T12:00:00Z",
	"created_at": "2024-01-01T11:00:00Z"
}

Step 3: Redirect Customer to Payment Page

Redirect your customer to the payment_url from the response. They’ll see a beautiful checkout page where they can complete the payment.

// JavaScript example
window.location.href = response.payment_url;

Step 4: Handle Payment Confirmation

There are two ways to confirm a payment:

Option A: Webhooks (Recommended)

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

// Express.js example
app.post('/webhooks/zeusxpay', (req, res) => {
	const event = req.body;

	if (event.type === 'order.completed') {
		// Payment successful! Fulfill the order
		console.log('Payment received:', event.data.id);
	}

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

Learn more about webhooks.

Option B: Polling

Poll our API to check the order status:

curl https://sandbox-api.zeusxpay.io/v1/orders/ord_1234567890 
  -H "Authorization: Bearer sk_test_YOUR_API_KEY"

Step 5: Test the Integration

Use these test values in sandbox mode:

Test Wallet Address: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh
Test Amount: Any amount (will be auto-confirmed in 1 minute)

Code Examples

JavaScript/Node.js

const axios = require('axios');

const zeusxpay = axios.create({
	baseURL: 'https://sandbox-api.zeusxpay.io/v1',
	headers: {
		Authorization: 'Bearer sk_test_YOUR_API_KEY',
		'Content-Type': 'application/json'
	}
});

// Create an order
const order = await zeusxpay.post('/orders', {
	amount: 100.0,
	currency: 'USD',
	crypto_currency: 'BTC',
	description: 'Premium subscription',
	customer_email: 'customer@example.com'
});

console.log('Payment URL:', order.data.payment_url);

Python

import requests

API_KEY = 'sk_test_YOUR_API_KEY'
BASE_URL = 'https://sandbox-api.zeusxpay.io/v1'

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

# Create an order
response = requests.post(f'{BASE_URL}/orders', headers=headers, json={
    'amount': 100.00,
    'currency': 'USD',
    'crypto_currency': 'BTC',
    'description': 'Premium subscription',
    'customer_email': 'customer@example.com'
})

order = response.json()
print(f"Payment URL: {order['payment_url']}")

PHP

<?php
$apiKey = 'sk_test_YOUR_API_KEY';
$baseUrl = 'https://sandbox-api.zeusxpay.io/v1';

$data = [
    'amount' => 100.00,
    'currency' => 'USD',
    'crypto_currency' => 'BTC',
    'description' => 'Premium subscription',
    'customer_email' => 'customer@example.com'
];

$ch = curl_init($baseUrl . '/orders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$order = json_decode($response, true);

echo "Payment URL: " . $order['payment_url'];
?>

Next Steps

Congratulations! You’ve successfully integrated ZEUSXPAY. Here’s what to explore next:

Set up webhooks for real-time notifications
Explore the API with our interactive playground
Learn about testing your integration
Go live and switch to production mode

Need Help?

If you get stuck, we’re here to help: