chargily epay php

Чаргли Epay Gateway PHP

Интегрируйте Gateway Epayment с обширной.

• В настоящее время поддерживает оплату CIB / Edahabia Cards и вскоре от Visa / MasterCard
• Это пакет PHP , если вы используете другой язык программирования, просматриваете здесь или смотрите на документацию API

Требования

1. PHP 7.2.5 или более поздней версии.
2. Получите свой ключ/секрет API от Epay от Chargily Dashboard бесплатно.

Установка

1. Через композитор (рекомендуется)

composer require chargily/epay-php

2. Скачать как Zip Мы не рекомендуем эту опцию. Но будьте осторожны, чтобы скачать обновленные версии.

Быстрый старт

1. Создать файл конфигурации epay_config.php Это где храните учетные данные 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. Создать файл перенаправления платежей 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. Создать обработку платежных файлов 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 ' );
}

• Руководство для тестирования вашего URL -адреса Webhook (Process) Нажмите здесь

Конфигурации

• Доступные конфигурации

ключ	описание	перенаправить URL	процесс URL
api_key	Должен быть строка, данная организацией	необходимый	необходимый
api_secret	Должен быть строка, данная организацией	необходимый	необходимый
URL	должен быть массив	необходимый	не обязательно
URLS [Back_url]	Должен быть строковый и действительный URL	необходимый	не обязательно
URLS [Process_url]	Должен быть строковый и действительный URL	необходимый	не обязательно
режим	Должен быть в CIB , Эдахабия	необходимый	не обязательно
Оплата [номер]	Должен быть строка или int	необходимый	не обязательно
Оплата [client_name]	должен быть строкой	необходимый	не обязательно
Оплата [client_email]	Должен быть строковой и действительной электронной почты, где клиент получает квитанцию ​​о платеже после подтверждения	необходимый	не обязательно
Оплата [сумма]	Должен быть цифровой и сццовой или равным 75	необходимый	не обязательно
Оплата [скидка]	Должен быть числовым и от 0 до 99,99 (процент скидки)	необходимый	не обязательно
Оплата [Описание]	должен быть строкой	необходимый	не обязательно
параметры	должен быть массив	необходимый	не обязательно
Варианты [заголовки]	должен быть массив	необходимый	не обязательно
Варианты [Тайм -аут]	Должно быть числовое	необходимый	не обязательно

Уведомление

• Если вы столкнулись с проблемами, нажмите здесь, чтобы открыть один