What is FluxPay?

curl -X POST https://fluxpay.online/api/v1/payments/charge \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1234-attempt-1" \
  -d '{
    "amount": 99.99,
    "currency": "USD",
    "card": { "number": "4111111111111111", "holderName": "JOHN DOE", "expiryMonth": "12", "expiryYear": "25", "cvv": "123" },
    "customer": { "email": "john@example.com" }
  }'

# Replaying the same key while the original request is still resolving
# (or after it already resolved) returns, without charging again:
# HTTP 409
# {
#   "error": "Duplicate request for this Idempotency-Key",
#   "code": "IDEMPOTENCY_REPLAY"
# }

const result = await fluxpay.chargePayment({
  amount: 99.99,
  card: { number: '4111111111111111', holderName: 'JOHN DOE',
          expiryMonth: '12', expiryYear: '25', cvv: '123' },
  customer: { email: 'john@example.com' }
});

if (result.payment.requires3DS) {
  // Redirect customer to 3DS page
  res.redirect(result.payment.redirectUrl);

  // Then poll for final status
  const final = await fluxpay.waitForPayment(result.payment.id);
  console.log('Final status:', final.payment.status);
} else if (result.success) {
  console.log('Payment completed:', result.payment.id);
} else {
  console.log('Payment failed:', result.error);
}

const { FluxPayClient } = require('./fluxpay.cjs.js');
// Or ESM: import { FluxPayClient } from './fluxpay.esm.mjs';

const fluxpay = new FluxPayClient({
  apiKey: process.env.FLUXPAY_API_KEY, // sk_live_xxx or sk_test_xxx
});

async function chargeCustomer(order) {
  try {
    const result = await fluxpay.chargePayment({
      amount: order.total,
      currency: 'USD',
      description: `Order #${order.id}`,
      card: {
        number: order.cardNumber,
        holderName: order.cardName,
        expiryMonth: order.expMonth,
        expiryYear: order.expYear,
        cvv: order.cvv,
      },
      customer: {
        email: order.email,
        firstName: order.firstName,
        lastName: order.lastName,
        phone: order.phone,
        billing: {
          address: order.address,
          city: order.city,
          state: order.state,
          postalCode: order.zip,
          country: order.country,
        },
      },
      metadata: { orderId: order.id },
      webhookUrl: 'https://yoursite.com/webhooks/fluxpay',
    });

    if (result.payment.requires3DS) {
      // Store payment ID, redirect customer
      return { redirect: result.payment.redirectUrl, paymentId: result.payment.id };
    }

    if (result.success && result.payment.status === 'COMPLETED') {
      return { success: true, paymentId: result.payment.id };
    }

    // PENDING — wait for webhook or poll
    if (result.payment.status === 'PENDING') {
      const final = await fluxpay.waitForPayment(result.payment.id);
      return { success: final.payment.status === 'COMPLETED', paymentId: final.payment.id };
    }

    return { success: false, error: result.error };
  } catch (err) {
    console.error('Charge failed:', err.message);
    return { success: false, error: err.message };
  }
}