Differential D1231 Diff 3172 src/app/Providers/PaymentProvider.php

Changeset View

Standalone View

src/app/Providers/PaymentProvider.php

This file was added.

				<?php

				namespace App\Providers;

				use App\Payment;
				use App\Wallet;

				abstract class PaymentProvider
				{
				public const STATUS_OPEN = 'open';
				public const STATUS_CANCELED = 'canceled';
				public const STATUS_PENDING = 'pending';
				public const STATUS_AUTHORIZED = 'authorized';
				public const STATUS_EXPIRED = 'expired';
				public const STATUS_FAILED = 'failed';
				public const STATUS_PAID = 'paid';

				public const TYPE_ONEOFF = 'oneoff';
				public const TYPE_RECURRING = 'recurring';

				/** const int Minimum amount of money in a single payment (in cents) */
				public const MIN_AMOUNT = 1000;

				/**
				* Factory method
				*/
				public static function factory(string $provider = null)
				{
				if (!$provider) {
				$provider = \config('services.payment_provider');
				}

				switch ($provider) {
				case 'stripe':
				return new \App\Providers\Payment\Stripe();

				case 'mollie':
				return new \App\Providers\Payment\Mollie();

				default:
				throw new \Exception("Invalid payment provider: {$provider}");
				}
				}

				/**
				* Create a new auto-payment mandate for a wallet.
				*
				* @param \App\Wallet $wallet The wallet
				* @param array $payment Payment data:
				* - amount: Value in cents
				* - currency: The operation currency
				* - description: Operation desc.
				*
				* @return array Provider payment data:
				* - id: Operation identifier
				* - redirectUrl: the location to redirect to
				*/
				abstract public function createMandate(Wallet $wallet, array $payment): ?array;

				/**
				* Revoke the auto-payment mandate for a wallet.
				*
				* @param \App\Wallet $wallet The wallet
				*
				* @return bool True on success, False on failure
				*/
				abstract public function deleteMandate(Wallet $wallet): bool;

				/**
				* Get a auto-payment mandate for a wallet.
				*
				* @param \App\Wallet $wallet The wallet
				*
				* @return array\|null Mandate information:
				* - id: Mandate identifier
				* - method: user-friendly payment method desc.
				* - isPending: the process didn't complete yet
				* - isValid: the mandate is valid
				*/
				abstract public function getMandate(Wallet $wallet): ?array;

				/**
				* Create a new payment.
				*
				* @param \App\Wallet $wallet The wallet
				* @param array $payment Payment data:
				* - amount: Value in cents
				* - currency: The operation currency
				* - type: first/oneoff/recurring
				* - description: Operation description
				*
				* @return array Provider payment/session data:
				* - id: Operation identifier
				* - redirectUrl
				*/
				abstract public function payment(Wallet $wallet, array $payment): ?array;

				/**
				* Update payment status (and balance).
				*
				* @return int HTTP response code
				*/
				abstract public function webhook(): int;

				/**
				* Create a payment record in DB
				*
				* @param array $payment Payment information
				* @param string $wallet_id Wallet ID
				*/
				protected static function storePayment(array $payment, $wallet_id): void
				{
				$db_payment = new Payment();
				$db_payment->id = $payment['id'];
				$db_payment->description = $payment['description'];
				$db_payment->status = $payment['status'];
				$db_payment->amount = $payment['amount'];
				$db_payment->wallet_id = $wallet_id;
				$db_payment->save();
				}
				}