PHP での Alipay 開発ガイド

現代社会では、Alipay はますます多くの人々が日常生活で使用する電子決済ツールとなっています。まず理解しなければならないのは、Alipay の支払い機能は API インターフェイスを通じて実装されているということです。 PHPでAlipay APIを利用したい場合は、Alipayが提供するSDKを使用して開発する必要があります。この記事では、PHP での Alipay 開発ガイドを紹介します。

1. Alipay SDK のダウンロード

Alipay SDK の使用を開始するには、まず Alipay Open Platform の公式 Web サイトにアクセスして登録と認証を行う必要があります。認証が完了すると、「開発者センター」からAlipay SDKをダウンロードできるようになります。これには、インターフェイス パラメーター定義、ツール クラス、サンプル コードなどのファイルが含まれます。独自のニーズに応じて、さまざまな SDK バージョンを選択できます。

2. 初期設定

ダウンロードが完了したら、独自の PHP プロジェクトで設定する必要があります。まず、SDK ファイルをプロジェクトにインポートし、対応するクラス ライブラリをプロジェクト構成ファイルに導入する必要があります。

次に、アプリケーション ID、秘密キー、公開キー、ゲートウェイ、その他の情報を含む Alipay 構成を初期化する必要があります。初期化コードは次のとおりです。

<?php
$config = [
    'app_id' => '支付宝应用ID',
    'merchant_private_key' => '应用私钥',
    'alipay_public_key' => '支付宝公钥',
    'gatewayUrl' => 'https://openapi.alipay.com/gateway.do',
    'charset' => 'UTF-8',
    'sign_type' => 'RSA2',
];

上記の構成情報のアプリケーション ID、秘密キー、および公開キーは、Alipay オープン プラットフォームのデベロッパー センターで取得できます。

3. 支払いリクエストの開始

Alipay SDK はさまざまな支払いインターフェイスを提供しますが、最も一般的に使用されるのはコンピューター Web サイト支払いとモバイル支払いです。以下では、コンピュータ Web サイトでの支払いを例として、支払いリクエストを開始する方法を紹介します。

まず、販売者の注文番号、合計注文金額、製品名、コールバック アドレス、その他の情報を含む、Alipay 支払いリクエスト パラメーターの配列を構築する必要があります。構造コードは次のとおりです。

<?php
$requestConfigs = [
    'out_trade_no' => '商户订单号',
    'total_amount' => '订单总金额',
    'subject' => '商品名称',
    'return_url' => '回调地址',
    'notify_url' =>'异步通知地址',
];

このうち、「out_trade_no」は販売者自身の注文番号、「total_amount」は注文の合計金額 (元) です。これらのパラメータは、ビジネス ニーズに応じて販売者自身が入力する必要があります。

次に、Alipay SDK クラスをインスタンス化し、初期化構成と構築パラメーター配列を渡す必要があります。サンプル コードは次のとおりです。

<?php
require_once './vendor/autoload.php';

use AlipayEasySDKFactory;

$config = [
    'app_id' => '支付宝应用ID',
    'merchant_private_key' => '应用私钥',
    'alipay_public_key' => '支付宝公钥',
    'gatewayUrl' => 'https://openapi.alipay.com/gateway.do',
    'charset' => 'UTF-8',
    'sign_type' => 'RSA2',
];
$pay = Factory::payment($config);
$order = $pay->preCreate($requestConfigs);

このうち、「preCreate」は、コンピューター Web サイトの支払いリクエストを開始する Alipay SDK のメソッドであり、返される $order は、支払い QR を含む、Alipay によって返されるすべての情報です。コードなど

最後に、返された情報がユーザーに表示され、ユーザーは Alipay QR コードをスキャンして支払いを完了できます。

4. 支払い結果の処理

Alipay SDK は、支払い結果を処理するために同期通知と非同期通知の 2 つの方法をサポートしています。同期通知とは、ユーザーが支払いを行った後、自動的にAlipayページから加盟店のカスタマイズページにジャンプし、加盟店はこのページで決済結果を表示し、ユーザーは決済結果を確認することができます。非同期通知とは、決済完了直後にAlipayサーバーから加盟店サーバーに決済結果の通知を送信することで、加盟店は通知を受け取った後すぐに注文状況などの情報を更新することができます。

同期通知の場合は、リクエスト パラメーターに return_url を追加して、支払いが成功した後にユーザーがどのページにジャンプするかを指定する必要があります。非同期通知の場合、決済結果通知アドレスを指定するために決済リクエストパラメータにnotify_urlを追加する必要があります。支払い結果の通知を受け取ったら、支払い結果の正当性を確認し、注文およびその他の関連情報を処理する必要があります。

5. 概要

この記事では、PHP での決済開発に Alipay SDK を使用する手順を紹介します。構成の初期化、支払いリクエストのパラメータの構築、支払いリクエストの開始、支払い結果の処理などの手順を通じて、独自の PHP プロジェクトで Alipay 支払い機能にすぐにアクセスできます。同時に、Alipay SDKを使用した開発プロセス中に、違法なチャネルへの漏洩を防ぐために、アプリケーションの秘密キーとAlipayの公開キーの保護に注意を払う必要があります。

以上がPHP での Alipay 開発ガイドの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。