README

PHP SDK 用于通过 REST 协议与 QIWI 服务器交互。使用此包来访问 QIWI 服务器。使用演示服务器的详细说明正在开发中。可以通过 QIWI 服务器模拟包和在线商店模拟包进行测试。

• QIWI-gate: https://github.com/fintech-fab/qiwi-gate
• QIWI-shop: https://github.com/fintech-fab/qiwi-shop

要求

• php >=5.3.0
• php5-curl

安装

Composer

{
    "require": {
        "fintech-fab/qiwi-sdk": "dev-master"
    },
}

使用

use FintechFab\QiwiSdk\Curl;
use FintechFab\QiwiSdk\Gateway;


$config = array(
	'gateUrl'  => 'url-to-qiwi-gate',
    'provider' => array(
	        'id'       => 'your-qiwi-gate-id',          //логин в системе QIWI
	        'password' => 'your-qiwi-gate-password',    //пароль в системе QIWI
	        'key'      => 'your-qiwi-gate-key',         //ключ для подписи в QIWI
	    ),
);

Gateway::setConfig($config);

$curl = new Curl();

// выставить счет
$gate = new Gateway($curl);
$billCreated = $gate->createBill(
	1234,		// номер заказа (счета) в вашей системе
	'+71234567890', // номер кошелька киви (моб. тел. плательщика)
	123.45,		// сумма счета
	'Комментарий!',	// комментрий к счету
	60*60*24	// на сутки
);

// проверить статус по номеру заказа (счета)
$gate = new Gateway($curl);
$statusChecked = $gate->doRequestBillStatus(1234);
if($statusChecked){
	$status = $gate->getValueBillStatus();
	switch($status){
		case 'payable': // ожидает оплаты
		case 'paid': // оплачен
		case 'canceled': // отменен
		case 'expired': // отменен, просрочен
	}
}


// отменить счет по номеру заказа (счета)
$gate = new Gateway($curl);
$billCanceled = $gate->cancelBill(1234);


// обработать callback от сервера
$gate = new Gateway($curl);
$correctCallback = $gate->doParseCallback();
if($correctCallback){
	$orderId = $gate->getCallbackOrderId();
	$amount = $gate->getCallbackAmount();
	$statusAfterCallback = $gate->getValueBillStatus();
	switch($statusAfterCallback){
		case 'paid': // оплачен
		case 'canceled': // отменен
		case 'expired': // отменен, просрочен
	}
}

// обработка ошибок
$gate = new Gateway($curl);
$billCreated = $gate->createBill(/*...*/);
if(!$billCreated){
	$errorMessage = $gate->getError();
}