Download the PHP package univapay/php-sdk without Composer
On this page you can find all versions of the php package univapay/php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download univapay/php-sdk
More information about univapay/php-sdk
Files in univapay/php-sdk
Package php-sdk
Short Description PHP SDK for Univapay Payments
License MIT
Homepage https://github.com/univapay/univapay-php-sdk
Informations about the package php-sdk
UnivaPay PHP SDK
UnivaPay PHP SDKは、UnivaPay決済ゲートウェイと連携する便利なメソッドを提供します。
English
必要なもの
- PHP 7.2.x 以上
- Composer
- npm (dev only)
- UnivaPayのストアアプリケーショントークンまたはマーチャントアプリケーショントークン
インストール
利用方法
アプリケーショントークン
このSDKでは、ストアタイプとマーチャントタイプの両方のアプリケーショントークンがサポートされています。 ストアタイプトークンを必要とするトランザクショントークンや課金の作成以外のすべての機能は、両方のトークンタイプでサポートされています。
通貨モデル
このSDKはmoneyphp
ライブラリを使用して金額と通貨をモデル化します。詳細は、ドキュメントを参照してください。
すべての通貨と金額は自動的にCurrency
とMoney
オブジェクトに変換されます。フォーマットされた金額(.*Formatted
キーで示される)のみがString形式になります。
列挙型
PHPにはネイティブの組み込み列挙型サポートがないため、列挙子を操作するときに型の安全性を提供するために、TypedEnum
というクラスを提供します。各列挙子クラスは最終版であり、 TypedEnum
を拡張して、Javaなどの他の言語の列挙子と同様に動作する静的関数を提供します。列挙型クラスは、Univapay\Enums
という名前空間にあります。
デフォルトでは、作成時に値が指定されていない場合、スネークケースになります。
リソースモデルの更新
リソースモデル(Resource
を拡張するモデルクラス)を更新するには、下記のようにします。
ポーリング
次のリソースは、ステータス変更を待機するためのロングポーリングがサポートされています。
Charge
Refund
Cancel
Subscription
これらのリクエストは最初にPENDING
ステータスを戻します。ロングポーリングでは、リソースのステータスが変更されたときに、更新されたモデルをフェッチできます。3秒以内に変更が発生しない場合、その時点のリソースが返されます。オプションとして、PENDING
ステータスが返された場合に、自動的にリトライするためのリトライ回数を渡すことができます。
リストとページネーション
SDKのすべてのリスト関数は、作成日時の降順でPaginated
オブジェクトとして返されます。配列を介してパラメーターを渡すときは、入力が期待されるタイプと一致するように注意してください。一致しない場合、InvalidArgumentException
がスローされます。
リクエスト/レスポンスハンドラ
データをオブジェクトに解析する前に追加の変更または応答への反応を必要とする場合の使用例です。 SDKは、APIからのバックプレッシャーに基づいてリクエストを調整する RateLimitHandler
を提供します(これはデフォルトでUnivapayClientOptions-> rateLimitHandler
に実装されています)。 さらに、 BasicRetryHandler
も提供されており、再試行のために特定の例外をキャッチしてフィルタリングします。 キャッチする例外を指定するには:
SDK開発者向け
ビルド:
コードフォーマット:
テスト:
テストを実行するには、次の環境変数が必要です。
UNIVAPAY_PHP_TEST_TOKEN
-test
モードのトークンである必要がありますUNIVAPAY_PHP_TEST_SECRET
UNIVAPAY_PHP_TEST_ENDPOINT
- ローカルAPIインスタンスまたはステージングインスタンスを指します
注:Github Actionsは、プルリクエストがOpenされているブランチでのみ実行されます