Add senegal placeholder

config/payment.php

@@ -51,4 +51,20 @@
             'webhook_secret' => ''
         ]
     ],
+
+    /**
+     * Senegal payment gateways configuration
+     */
+    'senegal' => [
+        'orange' => [
+            'client_key' => '',
+            'client_secret' => '',
+            'webhook_secret' => ''
+        ],
+
+        'wave' => [
+            'api_key' => '', // Your Wave API key (starts with wave_sn_prod_ or wave_sn_sandbox_)
+            'webhook_secret' => ''
+        ],
+    ],
 ];

docs/en.md

@@ -298,8 +298,8 @@ For advanced use cases, you can use providers directly:
 ### Orange Money Direct Usage
 
 ```php
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyGateway;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyTokenGenerator;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyGateway;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyTokenGenerator;
 
 $config = [
     'client_key' => 'YOUR_CLIENT_KEY',
@@ -332,9 +332,9 @@ $status = $gateway->verify([
 ### MTN Mobile Money Direct Usage
 
 ```php
-use Bow\Payment\IvoryCost\MTNMobileMoney\MTNMobileMoneyGateway;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoEnvironment;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoTokenGenerator;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MTNMobileMoneyGateway;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoEnvironment;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoTokenGenerator;
 
 $config = [
     'subscription_key' => 'YOUR_SUBSCRIPTION_KEY',

docs/fr.md

@@ -298,8 +298,8 @@ Pour des cas d'utilisation avancés, vous pouvez utiliser les fournisseurs direc
 ### Utilisation Directe d'Orange Money
 
 ```php
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyGateway;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyTokenGenerator;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyGateway;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyTokenGenerator;
 
 $config = [
     'client_key' => 'VOTRE_CLIENT_KEY',
@@ -332,9 +332,9 @@ $status = $gateway->verify([
 ### Utilisation Directe de MTN Mobile Money
 
 ```php
-use Bow\Payment\IvoryCost\MTNMobileMoney\MTNMobileMoneyGateway;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoEnvironment;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoTokenGenerator;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MTNMobileMoneyGateway;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoEnvironment;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoTokenGenerator;
 
 $config = [
     'subscription_key' => 'VOTRE_SUBSCRIPTION_KEY',

src/IvoryCost/Djamo/DjamoGateway.php → src/Gateway/IvoryCost/Djamo/DjamoGateway.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\Djamo;
+namespace Bow\Payment\Gateway\IvoryCost\Djamo;
 
 use Bow\Payment\Common\ProcessorGatewayInterface;
 use Bow\Payment\Exceptions\PaymentRequestException;

src/IvoryCost/MTNMobileMoney/Collection/MomoPayment.php → src/Gateway/IvoryCost/MTNMobileMoney/Collection/MomoPayment.php

@@ -1,11 +1,11 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\MTNMobileMoney\Collection;
+namespace Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\Collection;
 
 use Bow\Payment\Common\Utils;
 use GuzzleHttp\Client as HttpClient;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoToken;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoEnvironment;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoToken;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoEnvironment;
 use Bow\Payment\Exceptions\PaymentRequestException;
 
 class MomoPayment

src/IvoryCost/MTNMobileMoney/Collection/MomoPaymentStatus.php → src/Gateway/IvoryCost/MTNMobileMoney/Collection/MomoPaymentStatus.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\MTNMobileMoney\Collection;
+namespace Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\Collection;
 
 use Bow\Payment\Common\ProcessorStatusInterface;
 

src/IvoryCost/MTNMobileMoney/Collection/MomoTransaction.php → src/Gateway/IvoryCost/MTNMobileMoney/Collection/MomoTransaction.php

@@ -1,10 +1,10 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\MTNMobileMoney\Collection;
+namespace Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\Collection;
 
 use GuzzleHttp\Client as HttpClient;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoToken;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoEnvironment;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoToken;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoEnvironment;
 use Bow\Payment\Exceptions\TransactionVerificationException;
 
 class MomoTransaction

src/IvoryCost/MTNMobileMoney/MTNMobileMoneyGateway.php → src/Gateway/IvoryCost/MTNMobileMoney/MTNMobileMoneyGateway.php

@@ -1,12 +1,12 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\MTNMobileMoney;
+namespace Bow\Payment\Gateway\IvoryCost\MTNMobileMoney;
 
 use Bow\Payment\Common\ProcessorGatewayInterface;
-use Bow\Payment\IvoryCost\MTNMobileMoney\Collection\MomoPayment;
-use Bow\Payment\IvoryCost\MTNMobileMoney\Collection\MomoTransaction;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoTokenGenerator;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoEnvironment;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\Collection\MomoPayment;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\Collection\MomoTransaction;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoTokenGenerator;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoEnvironment;
 
 class MTNMobileMoneyGateway implements ProcessorGatewayInterface
 {

src/IvoryCost/MTNMobileMoney/MomoEnvironment.php → src/Gateway/IvoryCost/MTNMobileMoney/MomoEnvironment.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\MTNMobileMoney;
+namespace Bow\Payment\Gateway\IvoryCost\MTNMobileMoney;
 
 class MomoEnvironment
 {

src/IvoryCost/MTNMobileMoney/MomoToken.php → src/Gateway/IvoryCost/MTNMobileMoney/MomoToken.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\MTNMobileMoney;
+namespace Bow\Payment\Gateway\IvoryCost\MTNMobileMoney;
 
 class MomoToken
 {

src/IvoryCost/MTNMobileMoney/MonoTokenGenerator.php → src/Gateway/IvoryCost/MTNMobileMoney/MonoTokenGenerator.php

@@ -1,10 +1,10 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\MTNMobileMoney;
+namespace Bow\Payment\Gateway\IvoryCost\MTNMobileMoney;
 
 use GuzzleHttp\Client as HttpClient;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoToken;
-use Bow\Payment\IvoryCost\MTNMobileMoney\MomoEnvironment;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoToken;
+use Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MomoEnvironment;
 use Bow\Payment\Exceptions\TokenGenerationException;
 
 class MomoTokenGenerator

src/IvoryCost/MoovFlooz/MoovFloozGateway.php → src/Gateway/IvoryCost/MoovFlooz/MoovFloozGateway.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\MoovFlooz;
+namespace Bow\Payment\Gateway\IvoryCost\MoovFlooz;
 
 use Bow\Payment\Common\ProcessorGatewayInterface;
 use Bow\Payment\Exceptions\PaymentRequestException;

src/IvoryCost/OrangeMoney/OrangeMoneyGateway.php → src/Gateway/IvoryCost/OrangeMoney/OrangeMoneyGateway.php

@@ -1,13 +1,13 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\OrangeMoney;
+namespace Bow\Payment\Gateway\IvoryCost\OrangeMoney;
 
 use Bow\Payment\Common\ProcessorGatewayInterface;
 use Bow\Payment\Common\ProcessorTransactionStatusInterface;
 use Bow\Payment\Exceptions\PaymentRequestException;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyPayment;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyTokenGenerator;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyTransaction;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyPayment;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyTokenGenerator;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyTransaction;
 
 class OrangeMoneyGateway implements ProcessorGatewayInterface
 {

src/IvoryCost/OrangeMoney/OrangeMoneyPayment.php → src/Gateway/IvoryCost/OrangeMoney/OrangeMoneyPayment.php

@@ -1,9 +1,9 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\OrangeMoney;
+namespace Bow\Payment\Gateway\IvoryCost\OrangeMoney;
 
 use \GuzzleHttp\Client as HttpClient;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyToken;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyToken;
 
 class OrangeMoneyPayment
 {

src/IvoryCost/OrangeMoney/OrangeMoneyResponse.php → src/Gateway/IvoryCost/OrangeMoney/OrangeMoneyResponse.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\OrangeMoney;
+namespace Bow\Payment\Gateway\IvoryCost\OrangeMoney;
 
 class OrangeMoneyResponse
 {

src/IvoryCost/OrangeMoney/OrangeMoneyToken.php → src/Gateway/IvoryCost/OrangeMoney/OrangeMoneyToken.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\OrangeMoney;
+namespace Bow\Payment\Gateway\IvoryCost\OrangeMoney;
 
 class OrangeMoneyToken
 {

src/IvoryCost/OrangeMoney/OrangeMoneyTokenGenerator.php → src/Gateway/IvoryCost/OrangeMoney/OrangeMoneyTokenGenerator.php

@@ -1,9 +1,9 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\OrangeMoney;
+namespace Bow\Payment\Gateway\IvoryCost\OrangeMoney;
 
 use \GuzzleHttp\Client as HttpClient;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyToken;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyToken;
 
 class OrangeMoneyTokenGenerator
 {

src/IvoryCost/OrangeMoney/OrangeMoneyTransaction.php → src/Gateway/IvoryCost/OrangeMoney/OrangeMoneyTransaction.php

@@ -1,9 +1,9 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\OrangeMoney;
+namespace Bow\Payment\Gateway\IvoryCost\OrangeMoney;
 
 use \GuzzleHttp\Client as HttpClient;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyToken;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyToken;
 
 class OrangeMoneyTransaction
 {

src/IvoryCost/OrangeMoney/OrangeMoneyTransactionStatus.php → src/Gateway/IvoryCost/OrangeMoney/OrangeMoneyTransactionStatus.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\OrangeMoney;
+namespace Bow\Payment\Gateway\IvoryCost\OrangeMoney;
 
 use Bow\Payment\Common\ProcessorStatusInterface;
 

src/IvoryCost/Wave/WaveCheckoutSession.php → src/Gateway/IvoryCost/Wave/WaveCheckoutSession.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\Wave;
+namespace Bow\Payment\Gateway\IvoryCost\Wave;
 
 /**
  * Wave Checkout Session

src/IvoryCost/Wave/WaveClient.php → src/Gateway/IvoryCost/Wave/WaveClient.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\Wave;
+namespace Bow\Payment\Gateway\IvoryCost\Wave;
 
 use GuzzleHttp\Client as HttpClient;
 use Bow\Payment\Exceptions\PaymentRequestException;

src/IvoryCost/Wave/WaveGateway.php → src/Gateway/IvoryCost/Wave/WaveGateway.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\Wave;
+namespace Bow\Payment\Gateway\IvoryCost\Wave;
 
 use Bow\Payment\Common\ProcessorGatewayInterface;
 use Bow\Payment\Exceptions\PaymentRequestException;

src/IvoryCost/Wave/WavePaymentStatus.php → src/Gateway/IvoryCost/Wave/WavePaymentStatus.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Bow\Payment\IvoryCost\Wave;
+namespace Bow\Payment\Gateway\IvoryCost\Wave;
 
 use Bow\Payment\Common\ProcessorStatusInterface;
 

src/Gateway/Senegal/OrangeMoney/OrangeMoneyGateway.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Bow\Payment\Gateway\Senegal\OrangeMoney;
+
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyGateway as BaseOrangeMoneyGateway;
+
+/**
+ * Orange Money Gateway for Senegal
+ * Orange Money operates across multiple countries
+ * This class extends the base Orange Money implementation
+ * 
+ * The API endpoints and authentication methods are the same
+ * but may use different credentials and regional configurations
+ */
+class OrangeMoneyGateway extends BaseOrangeMoneyGateway
+{
+    // Inherits all functionality from the base Orange Money gateway
+    // Orange Money API is the same for Senegal and Ivory Coast
+}

src/Gateway/Senegal/Wave/WaveGateway.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Bow\Payment\Gateway\Senegal\Wave;
+
+use Bow\Payment\Gateway\IvoryCost\Wave\WaveGateway as BaseWaveGateway;
+
+/**
+ * Wave Gateway for Senegal
+ * Wave operates across multiple countries with the same API
+ * This class extends the base Wave implementation
+ * 
+ * @link https://docs.wave.com/checkout
+ */
+class WaveGateway extends BaseWaveGateway
+{
+    // Inherits all functionality from the base Wave gateway
+    // Wave API is the same for Senegal and Ivory Coast
+}

src/Payment.php

@@ -42,6 +42,12 @@ class Payment implements ProcessorGatewayInterface
      */
     public const CI = 'ivory_coast';
 
+    /**
+     * Senegal country identifier
+     * ISO 3166-1 alpha-2 country code for Senegal
+     */
+    public const SN = 'senegal';
+
     /**
      * Ivory Coast payment provider mapping
      * Maps payment provider identifiers to their respective service classes
@@ -50,11 +56,23 @@ class Payment implements ProcessorGatewayInterface
      * @var array<string, class-string>
      */
     public const CI_PROVIDER = [
-        Payment::ORANGE => \Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyGateway::class,
-        Payment::MTN => \Bow\Payment\IvoryCost\MTNMobileMoney\MTNMobileMoneyGateway::class,
-        Payment::MOOV => \Bow\Payment\IvoryCost\MoovFlooz\MoovFloozGateway::class,
-        Payment::WAVE => \Bow\Payment\IvoryCost\Wave\WaveGateway::class,
-        Payment::DJAMO => \Bow\Payment\IvoryCost\Djamo\DjamoGateway::class,
+        Payment::ORANGE => \Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyGateway::class,
+        Payment::MTN => \Bow\Payment\Gateway\IvoryCost\MTNMobileMoney\MTNMobileMoneyGateway::class,
+        Payment::MOOV => \Bow\Payment\Gateway\IvoryCost\MoovFlooz\MoovFloozGateway::class,
+        Payment::WAVE => \Bow\Payment\Gateway\IvoryCost\Wave\WaveGateway::class,
+        Payment::DJAMO => \Bow\Payment\Gateway\IvoryCost\Djamo\DjamoGateway::class,
+    ];
+
+    /**
+     * Senegal payment provider mapping
+     * Maps payment provider identifiers to their respective service classes
+     * for payment processing in Senegal (SN)
+     * 
+     * @var array<string, class-string>
+     */
+    public const SN_PROVIDER = [
+        Payment::ORANGE => \Bow\Payment\Gateway\Senegal\OrangeMoney\OrangeMoneyGateway::class,
+        Payment::WAVE => \Bow\Payment\Gateway\Senegal\Wave\WaveGateway::class,
     ];
 
     /**
@@ -104,6 +122,14 @@ private function resolveGateway(string $country, string $provider)
                 $config = $this->resolveConfig('ivory_coast', $provider);
                 static::$providerGateway = new $provider($config);
                 break;
+            case self::SN:
+                $provider = self::SN_PROVIDER[$provider] ?? null;
+                if ($provider === null) {
+                    throw new \InvalidArgumentException("The payment gateway [{$provider}] is not supported in country [{$country}].");
+                }
+                $config = $this->resolveConfig('senegal', $provider);
+                static::$providerGateway = new $provider($config);
+                break;
             // Other gateways can be added here
             default:
                 throw new \InvalidArgumentException("The payment gateway [{$provider}] is not supported.");

tests/OrangeMoneyTest.php

@@ -1,8 +1,8 @@
 <?php
 
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyPayment;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyToken;
-use Bow\Payment\IvoryCost\OrangeMoney\OrangeMoneyTokenGenerator;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyPayment;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyToken;
+use Bow\Payment\Gateway\IvoryCost\OrangeMoney\OrangeMoneyTokenGenerator;
 
 class OrangeMoneyTest extends \PHPUnit\Framework\TestCase
 {