qiwi php clientのダウンロードqiwi php clientソースコードダウンロード

qiwi php client

その他のカテゴリー

v0.1.1

ダウンロード

QIWI PHPクライアント

特に？ Zorra TelecomとEvenyone他のもの

こんにちは

出席：現在の方法の数は非常に限られており、Qiwi Doceが通常の代替手段を作らない場合、後で追加されます...注意：現時点では、メソッドの数は非常に限られています。

APIの最小セットはです

counceアカウントの作成

リクエストは、支払いアカウントを作成します。

 PUT /payin/v1/sites/{siteId}/bills/{billId}

✅カウントステータス

リクエストは、支払いの詳細を受け取ることを目的としています。成功した回答では、アカウント上のデータのリストと要求されたBillidによるその支払いが登場します。

 GET /payin/v1/sites/{siteId}/bills/{billId}/details

countアカウントの支払いリストを取得します

アカウントで支払いのリストを取得します

 GET /payin/v1/sites/{siteId}/bills/{billId}

使用できます：アカウントステータス

支払い

リクエストは、支払いトランザクションを作成します。

 PUT /payin/v1/sites/{siteId}/payments/{paymentId}

便利になるまで

❔支払いステータス

支払いトランザクションに関する情報を取得します。

 GET /payin/v1/sites/{siteId}/payments/{paymentId}

便利になるまで

使用できます：アカウントステータス

クライアント認証の完了

追加の認証を正常に受けた後、TSPは、対応するタイプの追加認証を使用してパラメーターを使用してリクエストを送信して監査を完了する必要があります。

 POST /payin/v1/sites/{siteId}/payments/{paymentId}/complete

便利になるまで

支払いの確認

資金を保有した後の支払いを確認します。 2つのステップシナリオが使用されている場合、商人は支払いの承認後にこのリクエストを送信する必要があります。

 PUT /payin/v1/sites/{siteId}/payments/{paymentId}/captures/{captureId}

便利になるまで

確認ステータス

支払いの指定された確認のステータスについて説明します。

 GET /payin/v1/sites/{siteId}/payments/{paymentId}/captures/{captureId}

便利になるまで

操作を返します

リクエストは、最終的な支払いで資金を返品することを目的としています。 TSPは、部分的な金額を返すためのいくつかの要求を満たすことができます。

 PUT /payin/v1/sites/{siteId}/payments/{paymentId}/refunds/{refundId}

便利になるまで

インストール

作曲家

composer require terentev-space/qiwi-php-client

使用法

Qiwiをセットアップ：https：//developer.qiwi.com/en/payments/#start
ライブラリを接続します
準備する

 // Factories
$ configFactory = new  QiwiClient  Factories  ConfigFactory ();
$ clientFactory = new  QiwiClient  Factories  ClientFactory ();

// Make Config
$ config = $ configFactory -> make (
    ' siteId ' ,
    ' token ' ,
    ' publicKey ' // optional
);
/* OR */
$ config = new  QiwiClient  Entities  ClientConfig (
    ' siteId ' ,
    ' publicKey ' ,
    ' token '
);

// Make Client
$ client = $ clientFactory -> make (
    ' siteId ' ,
    ' token ' ,
    ' publicKey ' // optional
);
/* OR */
$ client = Qiwi:: client (
    ' siteId ' ,
    ' token '
);
/* OR */
$ client = new  QiwiClient  Client (
    $ config ,
    new  GuzzleHttp  Client (),
    new  Psr  Log  NullLogger ()
);

使用

 $ billId = ' ... ' ;

$ amount = 1.01 ;
/* OR */
$ amount = 1.019 ; // = 1.01

$ currency = Qiwi:: CURRENCY_RUB ;
/* OR */
$ currency = ' RUB ' ;

$ expiration = null ; // +1 day
/* OR */
$ expiration = ' 2022-01-01T00:00:00+00:00 ' ;
/* OR */
$ expiration = new DateTime ();
/* OR */
$ expiration = $ datetime -> format ( QiwiClient Qiwi:: DATETIME_FORMAT );

$ flags = [
     QiwiClient Qiwi:: FLAG_SALE , // optional
     QiwiClient Qiwi:: FLAG_BIND_PAYMENT_TOKEN , // optional
];

$ account = ' string(64) - id ' ;
$ email = ' string(64) or null - email ' ;
$ phone = ' string(15) or null - phone ' ;

$ country = ' string(1000) or null ' ;
$ city = ' string(1000) or null ' ;
$ region = ' string(1000) or null ' ;
$ details = ' string(1000) or null ' ;

$ pan = ' string(19) or null ' ;
$ wallet = ' string(64) or null ' ;
$ inn = ' string(12) or null ' ;
$ phone = ' string(15) or null ' ;
$ bankAccount = ' string(20) or null ' ;
$ bic = ' string(9) or null ' ;

$ cf1 = ' string(256) or null ' ;
$ cf2 = ' string(256) or null ' ;
$ cf3 = ' string(256) or null ' ;
$ cf4 = ' string(256) or null ' ;
$ cf5 = ' string(256) or null ' ;
$ merchantThemeCode = ' string(256) or null ' ;
$ merchantContractId = ' string(256) or null ' ;
$ merchantBookingNumber = ' string(256) or null ' ;
$ merchantPhone = ' string(256) or null ' ;
$ merchantFullName = ' string(256) or null ' ;
$ invoiceCallbackUrl = ' string(256) or null ' ;

/** @var array $cheque Данные чека для операции. */
$ cheque = [ /* ... */ ];

$ request = PaySiteBillQuery:: make ( $ billId , $ amount , $ currency )
    -> setExpirationDateTime ( $ expiration ) // optional
    -> setFlags (... $ flags ) // optional
    -> setCustomer (
        $ account ,
        $ email , // optional
        $ phone // optional
    ) // optional
    -> setAddress (
        $ country , // optional
        $ city , // optional
        $ region , // optional
        $ details // optional
    ) // optional
    -> setReceiverData (
        $ pan , // optional
        $ wallet , // optional
        $ inn , // optional
        $ phone , // optional
        $ bankAccount , // optional
        $ bic // optional
    ) // optional
    -> setCustomFields (
        $ cf1 , // optional
        $ cf2 , // optional
        $ cf3 , // optional
        $ cf4 , // optional
        $ cf5 , // optional
        $ merchantThemeCode , // optional
        $ merchantContractId , // optional
        $ merchantBookingNumber , // optional
        $ merchantPhone , // optional
        $ merchantFullName , // optional
        $ invoiceCallbackUrl // optional
    ) // optional
    -> setCheque ( $ cheque )
;
/* OR */
$ request = [
    ' billId ' => $ billId ,
    ' amount ' => [
        ' value ' => $ amount ,
        ' currency ' => $ currency ,
    ],
    ' expirationDateTime ' => $ expiration ,
    ' flags ' => $ flags ,
    ' customer ' => [
        ' account ' => $ account ,
        ' email ' => $ email ,
        ' phone ' => $ phone ,
    ],
    ' address ' => [
        ' country ' => $ country ,
        ' city ' => $ city ,
        ' region ' => $ region ,
        ' details ' => $ details ,
    ],
    ' receiverData ' => [
        ' pan ' => $ pan ,
        ' wallet ' => $ wallet ,
        ' inn ' => $ inn ,
        ' phone ' => $ phone ,
        ' bankAccount ' => $ bankAccount ,
        ' bic ' => $ bic ,
    ],
    ' customFields ' => [
        ' cf1 ' => $ cf1 ,
        ' cf2 ' => $ cf2 ,
        ' cf3 ' => $ cf3 ,
        ' cf4 ' => $ cf4 ,
        ' cf5 ' => $ cf5 ,
        ' merchantThemeCode ' => $ merchantThemeCode ,
        ' merchantContractId ' => $ merchantContractId ,
        ' merchantBookingNumber ' => $ merchantBookingNumber ,
        ' merchantPhone ' => $ merchantPhone ,
        ' merchantFullName ' => $ merchantFullName ,
        ' invoiceCallbackUrl ' => $ invoiceCallbackUrl ,
    ],
    ' cheque ' => $ cheque ,
];

$ response = $ client -> paySiteBill ( $ request );
$ response -> getCode (); // Response code 200
$ response -> getBody (); // Response data array
/** @var QiwiClientEntitiesResultsPaySiteBillResult $data */
$ data = $ response -> parseData ();

// ...
$ billId = $ data -> getBillId ();
// 1.01
$ amount = $ data -> getAmountValue ();
// RUB
$ currency = $ data -> getAmountCurrency ();
// 2000-00-00T00:00:00+00:00
$ exp = $ data -> getExpirationDateTime ();
// 00000000-0000-0000-0000-000000000000
$ invoice = $ data -> getInvoiceUid ();
// CREATED
$ status = $ data -> getStatusValue ();
// 2000-00-00T00:00:00+00:00
$ statusChanged = $ data -> getStatusChangedDateTime ();
// https://oplata.qiwi.com/form?invoiceUid=00000000-0000-0000-0000-000000000000
$ url = $ data -> getPayUrl ();

$ response = $ client -> getSiteBillDetails ( ' 1663126085 ' );
$ response -> getCode (); // Response code 200
$ response -> getBody (); // Response data array
/** @var QiwiClientEntitiesResultsGetSiteBillDetailsResult $data */
$ data = $ response -> parseData ();

// ...
$ billId = $ data -> getBillId ();
// 1.01
$ amount = $ data -> getAmountValue ();
// RUB
$ currency = $ data -> getAmountCurrency ();
// CREATED
$ status = $ data -> getStatusValue ();
// 2000-00-00T00:00:00+00:00
$ statusChanged = $ data -> getStatusChangedDateTime ();
/* ... */
// https://oplata.qiwi.com/form?invoiceUid=00000000-0000-0000-0000-000000000000
$ url = $ data -> getPayUrl ();

/** @var QiwiClientEntitiesItemsSiteBillPayment $payment */
$ payment = $ data -> getPayments ()[ 0 ];

// siteId
$ siteId = $ payment -> getSiteId ();
// ...
$ billId = $ payment -> getBillId ();
// 1.01
$ amount = $ payment -> getAmountValue ();
// RUB
$ currency = $ payment -> getAmountCurrency ();
// CREATED
$ status = $ payment -> getStatusValue ();
/* ... */
// []
$ status = $ payment -> getCustomFields ();

図書館の改訂

ライブラリにはdockerfileがあり、このようなDockerの画像を倒すことができます： docker build -t "qiwi-php-client" .
このような事前コンテナーを起動できます： docker run -it -v $(pwd):/qiwi-php-client qiwi-php-client bash
最初の起動時には、依存関係を締め、実行する必要があります： composer installコンテナに
テスト環境が構成されているため、操作のためにphpunit.xml.distファイルをphpunit.xmlにコピーする必要はありません
コンテナでの開始テスト： ./vendor/bin/phpunit phpunit