# No installation needed - cURL is pre-installed on most systems
# Your API key from Dashboard → Settings → API Keys
# Test mode: sk_test_*  |  Live mode: sk_live_*

curl -X POST https://fluxpay.online/api/v1/payments \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 99.99,
    "currency": "USD",
    "customer": {
      "email": "customer@example.com",
      "firstName": "John",
      "lastName": "Doe",
      "phone": "+1-212-555-1234",
      "billing": {
        "address": "123 Main Street",
        "city": "New York",
        "state": "NY",
        "country": "US",
        "postalCode": "10001"
      }
    },
    "description": "Order #1234",
    "language": "fr",
    "webhookUrl": "https://yoursite.com/webhooks/fluxpay",
    "metadata": {
      "orderId": "ORD-2024-001",
      "userId": "user_12345"
    }
  }'

# Response:
# {
#   "success": true,
#   "payment": {
#     "id": "pay_abc123",
#     "status": "PENDING",
#     "amount": 99.99,
#     "currency": "USD",
#     "paymentUrl": "https://fluxpay.online/payment/generic/pay_abc123",
#     "customer": { ... },
#     "createdAt": "2025-01-23T10:30:00Z"
#   }
# }

# WEBHOOK PAYLOAD EXAMPLE
# POST https://yoursite.com/webhooks/fluxpay
# Headers:
#   Content-Type: application/json
#   X-Webhook-Signature: <hmac_sha256_signature>

{
  "event": "payment.completed",
  "transactionId": "pay_abc123",
  "amount": 99.99,
  "currency": "USD",
  "status": "COMPLETED",
  "customerEmail": "customer@example.com",
  "metadata": {
    "orderId": "ORD-2024-001",
    "userId": "user_12345"
  },
  "processedAt": "2025-01-23T10:35:00Z"
}

# YOUR WEBHOOK ENDPOINT MUST:
# 1. Verify the X-Webhook-Signature header (HMAC SHA256)
# 2. Process the event (fulfill order, send email, etc.)
# 3. Return 200 OK within 30 seconds

curl -X POST https://fluxpay.online/api/v1/payments \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 99.99,
    "currency": "USD",
    "customer": {
      "email": "customer@example.com",
      "firstName": "John",
      "lastName": "Doe"
    },
    "description": "Order #1234",
    "metadata": {
      "orderId": "ORD-2024-001"
    },
    "returnUrl": "https://yoursite.com/payment/callback",
    "successUrl": "https://yoursite.com/payment/success",
    "failureUrl": "https://yoursite.com/payment/failure"
  }'

# After payment, customer is redirected to:
# SUCCESS: https://yoursite.com/payment/success?status=success&transaction_id=...
# FAILURE: https://yoursite.com/payment/failure?status=failed&transaction_id=...

// React Component for Embedded Payment
import { useState } from 'react';

function PaymentModal({ paymentUrl, onClose }) {
  return (
    <div className="fixed inset-0 bg-black/50 flex items-center justify-center z-50">
      <div className="bg-white rounded-2xl w-full max-w-lg overflow-hidden">
        <div className="flex justify-between items-center p-4 border-b">
          <h3 className="font-semibold">Complete Payment</h3>
          <button onClick={onClose} className="text-gray-500 hover:text-gray-700">✕</button>
        </div>
        <iframe
          src={paymentUrl}
          className="w-full h-[600px] border-0"
          allow="payment"
        />
      </div>
    </div>
  );
}

// Usage in your checkout page
function CheckoutPage() {
  const [paymentUrl, setPaymentUrl] = useState(null);

  const handleCheckout = async () => {
    const res = await fetch('/api/create-payment', { method: 'POST' });
    const { paymentUrl } = await res.json();
    setPaymentUrl(paymentUrl);
  };

  return (
    <div>
      <button onClick={handleCheckout}>Pay Now</button>
      {paymentUrl && (
        <PaymentModal
          paymentUrl={paymentUrl}
          onClose={() => setPaymentUrl(null)}
        />
      )}
    </div>
  );
}