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
- UnivaPayのストアアプリケーショントークンまたはマーチャントアプリケーショントークン
インストール
利用方法
アプリケーショントークン
このSDKでは、ストアタイプとマーチャントタイプの両方のアプリケーショントークンがサポートされています。 ストアタイプトークンを必要とするトランザクショントークンや課金の作成以外のすべての機能は、両方のトークンタイプでサポートされています。
通貨モデル
このSDKはmoneyphpライブラリを使用して金額と通貨をモデル化します。詳細は、ドキュメントを参照してください。
すべての通貨と金額は自動的にCurrencyとMoneyオブジェクトに変換されます。フォーマットされた金額(.*Formattedキーで示される)のみがString形式になります。
列挙型
PHPにはネイティブの組み込み列挙型サポートがないため、列挙子を操作するときに型の安全性を提供するために、TypedEnumというクラスを提供します。各列挙子クラスは最終版であり、 TypedEnumを拡張して、Javaなどの他の言語の列挙子と同様に動作する静的関数を提供します。列挙型クラスは、Univapay\Enumsという名前空間にあります。
デフォルトでは、作成時に値が指定されていない場合、スネークケースになります。
リソースモデルの更新
リソースモデル(Resourceを拡張するモデルクラス)を更新するには、下記のようにします。
ポーリング
次のリソースは、ステータス変更を待機するためのロングポーリングがサポートされています。
ChargeRefundCancelSubscription
これらのリクエストは最初にPENDINGステータスを戻します。ロングポーリングでは、リソースのステータスが変更されたときに、更新されたモデルをフェッチできます。3秒以内に変更が発生しない場合、その時点のリソースが返されます。オプションとして、PENDINGステータスが返された場合に、自動的にリトライするためのリトライ回数を渡すことができます。
リストとページネーション
SDKのすべてのリスト関数は、作成日時の降順でPaginatedオブジェクトとして返されます。配列を介してパラメーターを渡すときは、入力が期待されるタイプと一致するように注意してください。一致しない場合、InvalidArgumentExceptionがスローされます。
リクエスト/レスポンスハンドラ
データをオブジェクトに解析する前に追加の変更または応答への反応を必要とする場合の使用例です。 SDKは、APIからのバックプレッシャーに基づいてリクエストを調整する RateLimitHandlerを提供します(これはデフォルトでUnivapayClientOptions-> rateLimitHandlerに実装されています)。 さらに、 BasicRetryHandlerも提供されており、再試行のために特定の例外をキャッチしてフィルタリングします。 キャッチする例外を指定するには:
SDK開発者向け
ビルド:
コードフォーマット:
テスト:
テストを実行するには、次の環境変数が必要です。
UNIVAPAY_PHP_TEST_TOKEN-testモードのトークンである必要がありますUNIVAPAY_PHP_TEST_SECRETUNIVAPAY_PHP_TEST_ENDPOINT- ローカルAPIインスタンスまたはステージングインスタンスを指します
注:Github Actionsは、プルリクエストがOpenされているブランチでのみ実行されます