chargily epay php

Charge Epay Gateway PHP

Intégrez facilement la passerelle Epayment avec Chargly.

• Soutenez actuellement le paiement par les cartes CIB / Edahabia et bientôt par Visa / MasterCard
• Ceci est un package PHP , si vous utilisez un autre langage de programmation Parcourir ici ou consulter la documentation de l'API

Exigences

1. PHP 7.2.5 ou version ultérieure.
2. Obtenez gratuitement votre clé d'API / secret d'Epay par tableau de bord chargée.

Installation

1. Via le compositeur (recommandé)

composer require chargily/epay-php

2. Téléchargez comme zip, nous ne recommandons pas cette option. Mais veillez à télécharger les versions mises à jour tous les temps Télécharger

Démarrage rapide

1. Créer un fichier config epay_config.php C'est là que stockez vos informations d'identification API

 //  Configurations file
return [
    ' key ' => ' your-api-key ' , // you can you found it on your epay.chargily.com.dz Dashboard
    ' secret ' => ' your-api-secret ' , // you can you found it on your epay.chargily.com.dz Dashboard
];

2. Créer un fichier de redirection de paiement redirect.php

 use Chargily  ePay  Chargily ;

require ' path-to-vendor/vendor/autoload.php ' ;

$ epay_config = require ' epay_config.php ' ;

$ chargily = new Chargily ([
    //credentials
    ' api_key ' => $ epay_config [ ' key ' ],
    ' api_secret ' => $ epay_config [ ' secret ' ],
    //urls
    ' urls ' => [
        ' back_url ' => " valid-url-to-redirect-after-payment " , // this is where client redirected after payment processing
        ' webhook_url ' => " valid-url-to-receive-payment-informations " , // this is where you receive payment informations
    ],
    //mode
    ' mode ' => ' EDAHABIA ' , //OR CIB
    //payment details
    ' payment ' => [
        ' number ' => ' payment-number-from-your-side ' , // Payment or order number
        ' client_name ' => ' client name ' , // Client name
        ' client_email ' => ' [email protected] ' , // This is where client receive payment receipt after confirmation
        ' amount ' => 75 , //this the amount must be greater than or equal 75 
        ' discount ' => 0 , //this is discount percentage between 0 and 99
        ' description ' => ' payment-description ' , // this is the payment description

    ]
]);
// get redirect url
$ redirectUrl = $ chargily -> getRedirectUrl ();
//like : https://epay.chargily.com.dz/checkout/random_token_here
//
if ( $ redirectUrl ){
    //redirect
    header ( ' Location: ' . $ redirectUrl );
} else {
    echo " We cant redirect to your payment now " ;
}

3. Créer le fichier de traitement des paiements Process.php

 use Chargily  ePay  Chargily ;

require ' path-to-vendor/vendor/autoload.php ' ;

$ epay_config = require ' epay_config.php ' ;

$ chargily = new Chargily ([
    //credentials
    ' api_key ' => $ epay_config [ ' key ' ],
    ' api_secret ' => $ epay_config [ ' secret ' ],
]);

if ( $ chargily -> checkResponse ()) {
    $ response = $ chargily -> getResponseDetails ();
    //@ToDo: Validate order status by $response['invoice']['invoice_number']. If it is not already approved, approve it.
    //something else
    /*
        $response like the follwing array
            $response = array(
                "invoice" => array(
                            "id" => 5566321,
                            "client" => "Client name",
                            "invoice_number" => "123456789",
                            "due_date" => "2022-01-01 00:00:00",
                            "status" => "paid",
                            "amount" => 75,
                            "fee" => 25,
                            "discount" => 0,
                            "comment" => "Payment description",
                            "tos" => 1,
                            "mode" => "EDAHABIA",
                            "invoice_token" => "randoom_token_here",
                            "due_amount" => 10000,
                            "created_at" => "2022-01-01 06:10:38",
                            "updated_at" => "2022-01-01 06:13:00",
                            "back_url" => "https://www.mydomain.com/success",
                            "new" => 1,
                );
            )
    */
    exit ( ' OK ' );
}

• Guide pour tester votre URL Webhook (processus) Cliquez ici

Configurations

• Configurations disponibles

clé	description	URL de redirection	URL de traitement
api_key	Doit être une corde donnée par l'organisation	requis	requis
API_SECRET	Doit être une corde donnée par l'organisation	requis	requis
URL	Doit être un tableau	requis	pas requis
URL [back_url]	Doit être une chaîne et une URL valide	requis	pas requis
URL [process_url]	Doit être une chaîne et une URL valide	requis	pas requis
mode	Doit être à Cib , Edahabia	requis	pas requis
Paiement [numéro]	doit être une chaîne ou un int	requis	pas requis
paiement [client_name]	doit être une chaîne	requis	pas requis
paiement [client_email]	Doit être une chaîne et un e-mail valide C'est là que le client reçoit un reçu de paiement après confirmation	requis	pas requis
paiement [montant]	Doit être numérique et great ou égal à 75	requis	pas requis
paiement [réduction]	Doit être numérique et entre 0 et 99,99 (pourcentage de remise)	requis	pas requis
Paiement [Description]	doit être une chaîne	requis	pas requis
options	Doit être un tableau	requis	pas requis
Options [En-têtes]	Doit être un tableau	requis	pas requis
Options [Timeout]	Doit être numérique	requis	pas requis

Avis

• Si vous avez fait face à des problèmes, cliquez ici pour en ouvrir un