Payment Processors

enum PaymentProcessor: string
{
    case STRIPE = 'Stripe';
    case NMI = 'NMI';
    case COINBASE = 'Coinbase';
}

{
  "site": {
    "identifier": "psn",
    "name": "PaystubsNow",
    "payment_processors": ["Stripe", "NMI"]
  }
}

enum PaymentType: string
{
    case SALE = 'Sale';
    case REFUND = 'Refund';
    case VOID = 'Void';
    case FREE = 'Free';
}

enum PaymentStatus: string
{
    case PENDING = 'pending';
    case PROCESSING = 'processing';
    case COMPLETED = 'completed';
    case FAILED = 'failed';
}

$transaction = Transaction::create([
    'site_id' => $site->id,
    'user_id' => $user->id,
    'order_id' => $order->id,
    'processor' => PaymentProcessor::STRIPE,
    'amount' => $order->total,
    'type' => PaymentType::SALE,
    'status' => PaymentStatus::PENDING
]);

// Process via selected processor
$result = match($transaction->processor) {
    PaymentProcessor::STRIPE => $this->processStripePayment($transaction),
    PaymentProcessor::NMI => $this->processNMIPayment($transaction),
    PaymentProcessor::COINBASE => $this->processCoinbasePayment($transaction),
};

$transaction->update([
    'processor_id' => $result->id,
    'processor_response' => $result->response,
    'status' => PaymentStatus::COMPLETED
]);

{
  "success": true,
  "data": {
    "transaction": {
      "id": 1,
      "processor": "Stripe",
      "processor_id": "ch_1234567890",
      "amount": 29.99,
      "type": "Sale",
      "status": "completed",
      "created_at": "2024-01-29T12:00:00Z"
    }
  }
}

{
  "success": false,
  "message": "Payment failed",
  "errors": {
    "detail": "Card declined"
  }
}

try {
    $result = $processor->processPayment($payment);
} catch (PaymentException $e) {
    Log::error('Payment failed', [
        'code' => $e->getCode(),
        'message' => $e->getMessage()
    ]);
    return $this->handlePaymentError($e);
}

$processor->processPayment($payment, [
    'idempotency_key' => $payment->uuid
]);

public function handleWebhook(Request $request)
{
    $event = $this->verifyWebhook($request);
    match ($event->type) {
        'charge.succeeded' => $this->handleSuccessfulCharge($event),
        'charge.failed' => $this->handleFailedCharge($event),
        default => $this->handleUnknownEvent($event),
    };
}

// Stripe Test Cards
$cards = [
    'success' => '4242424242424242',
    'decline' => '4000000000000002',
    'error' => '4000000000000127'
];

config(['payment.test_mode' => true]);