Developer Documentation

import requests
import time
BASE_URL = "https://api.cygnuspay.org"
SESSION = requests.Session()
# 1. Login
SESSION.post(f"{BASE_URL}/api/login", json={
    "username": "your_username",
    "password": "your_password",
    "otp": "123456"  # if 2FA enabled
})
# 2. Create Payment Link
SESSION.post(f"{BASE_URL}/pay/create", data={
    "type": "onetime",
    "title": "Order #1234",
    "amount": 29.99,
    "currency": "USDT"
})
# 3. Share the link: https://app.cygnuspay.org/pay/@your_username/<identifier>
# 4. Poll for confirmation
def wait_for_payment(identifier, initial_balance=0.0, timeout=600):
    """Poll payment status. Returns True when confirmed."""
    start = time.time()
    while time.time() - start < timeout:
        resp = SESSION.get(
            f"{BASE_URL}/pay/check/{identifier}",
            params={"initial_balance": initial_balance}
        )
        data = resp.json()
        if data.get("confirmed"):
            return True
        time.sleep(15)
    return False

{
    "success": false,
    "message": "Human-readable error description"
}

"""Example: E-commerce checkout integration with Cygnus Pay"""
from flask import Flask, redirect, jsonify
import requests
app = Flask(__name__)
CNSPAY_BASE = "https://api.cygnuspay.org"
CNSPAY_SESSION = requests.Session()
# Login once on startup
CNSPAY_SESSION.post(f"{CNSPAY_BASE}/api/login", json={
    "username": "your_merchant_account",
    "password": "your_password"
})
@app.route("/checkout/<order_id>")
def checkout(order_id):
    """Redirect customer to Cygnus Pay payment page"""
    pay_link = "abc123def456"
    return redirect(f"{CNSPAY_BASE}/pay/@yourusername/{pay_link}")
@app.route("/api/check-payment/<order_id>")
def check_payment(order_id):
    """Backend endpoint to verify payment status"""
    pay_link = "abc123def456"
    resp = CNSPAY_SESSION.get(f"{CNSPAY_BASE}/pay/check/{pay_link}")
    data = resp.json()
    if data.get("confirmed"):
        return jsonify({"paid": True})
    return jsonify({"paid": False})