この記事では主にPHPでのバックエンドUnionPayの支払いと返金の例を詳しく紹介します。興味のある方はぜひ参考にしてください。
声明: この記事は最新の UnionPay SDK (2016-08-09 バージョン 5.1.0) に基づいています。異なるパッケージがある場合は、それがこのバージョンであるかどうかを確認してください
最近発生した UnionPay の支払いと関連する返金 (この記事では、携帯電話制御の支払いを前提として、そのプロセス中に発生した問題と基本的なプロセスを順に書き留めます。その前に、バックエンド担当者向けに、公式の画像を通じて支払いを理解します。この図からわかるように、バックエンドは 1. プラットフォーム注文の生成、2. UnionPay オムニチャネル プラットフォーム注文のプッシュ、3. フロントエンドへの tn コードの返しを行う必要があります。支払いのため; 4. オムニチャネル プラットフォームのフロント デスク通知および非同期通知を処理します。
ここには 3 つの問題があります。
注文プッシュ、非同期通知処理、注文状況クエリです。
1. 関連するパラメーターの設定
SDK の Assets フォルダーでテストするドッキング プロセス 環境構成ファイルと証明書を SDK フォルダーに配置し、acp_sdk.ini 構成ファイルを正しく読み取るように /sdk/SDKconfig.php ファイルを構成します。acp_sdk.ini ファイル内の 4 つのファイル acpsdk.signCert.path、acpsdk.encryptCert.path、acpsdk.rootCert.path、および acpsdk.middleCert.path の絶対アドレスを構成します (ファイル パスをカスタマイズするだけです)。
プロジェクト開発中にシステムやプロジェクトアドレスが異なるため、証明書の絶対アドレスなどのエラーが発生する可能性があり、特に実際の運用環境では、プロジェクトデプロイメントファイルのアドレスが毎回異なることが非常に起こりやすくなります。証明書アドレスを変更するために、さまざまなファイル アドレスと互換性があるように SDK の SDKconfig.php を変更しました。
関連コードをクリックして表示してください
<?php
namespace com\unionpay\acp\sdk;;
include_once 'log.class.php';
include_once 'common.php';
class SDKConfig {
private static $_config = null;
public static function getSDKConfig(){
if (SDKConfig::$_config == null ) {
SDKConfig::$_config = new SDKConfig();
}
return SDKConfig::$_config;
}
private $frontTransUrl;
private $backTransUrl;
private $singleQueryUrl;
private $batchTransUrl;
private $fileTransUrl;
private $appTransUrl;
private $cardTransUrl;
private $jfFrontTransUrl;
private $jfBackTransUrl;
private $jfSingleQueryUrl;
private $jfCardTransUrl;
private $jfAppTransUrl;
private $qrcBackTransUrl;
private $qrcB2cIssBackTransUrl;
private $qrcB2cMerBackTransUrl;
private $signMethod;
private $version;
private $ifValidateCNName;
private $ifValidateRemoteCert;
private $signCertPath;
private $signCertPwd;
private $validateCertDir;
private $encryptCertPath;
private $rootCertPath;
private $middleCertPath;
private $frontUrl;
private $backUrl;
private $secureKey;
private $logFilePath;
private $logLevel;
function __construct(){
//如果想把acp_sdk.ini挪到其他路径的话，请修改下面这行指定绝对路径。
$configFilePath = dirname(__FILE__) . "/acp_sdk.ini";
$certsFilePath = dirname(dirname(__FILE__)) . "/certs/";
if(!file_exists($configFilePath)){
$logger = LogUtil::getLogger();
$logger->LogError("配置文件加载失败，文件路径：[" . $configFilePath . "].请检查启动php的用户是否有读权限。");
return;
}
$ini_array = parse_ini_file($configFilePath, true);
$sdk_array = $ini_array["acpsdk"];
$this->frontTransUrl = array_key_exists("acpsdk.frontTransUrl", $sdk_array)?$sdk_array["acpsdk.frontTransUrl"] : null;
$this->backTransUrl = array_key_exists("acpsdk.backTransUrl", $sdk_array)?$sdk_array["acpsdk.backTransUrl"] : null;
$this->singleQueryUrl = array_key_exists("acpsdk.singleQueryUrl", $sdk_array)?$sdk_array["acpsdk.singleQueryUrl"] : null;
$this->batchTransUrl = array_key_exists("acpsdk.batchTransUrl", $sdk_array)?$sdk_array["acpsdk.batchTransUrl"] : null;
$this->fileTransUrl = array_key_exists("acpsdk.fileTransUrl", $sdk_array)?$sdk_array["acpsdk.fileTransUrl"] : null;
$this->appTransUrl = array_key_exists("acpsdk.appTransUrl", $sdk_array)?$sdk_array["acpsdk.appTransUrl"] : null;
$this->cardTransUrl = array_key_exists("acpsdk.cardTransUrl", $sdk_array)?$sdk_array["acpsdk.cardTransUrl"] : null;
$this->jfFrontTransUrl = array_key_exists("acpsdk.jfFrontTransUrl", $sdk_array)?$sdk_array["acpsdk.jfFrontTransUrl"] : null;
$this->jfBackTransUrl = array_key_exists("acpsdk.jfBackTransUrl", $sdk_array)?$sdk_array["acpsdk.jfBackTransUrl"] : null;
$this->jfSingleQueryUrl = array_key_exists("acpsdk.jfSingleQueryUrl", $sdk_array)?$sdk_array["acpsdk.jfSingleQueryUrl"] : null;
$this->jfCardTransUrl = array_key_exists("acpsdk.jfCardTransUrl", $sdk_array)?$sdk_array["acpsdk.jfCardTransUrl"] : null;
$this->jfAppTransUrl = array_key_exists("acpsdk.jfAppTransUrl", $sdk_array)?$sdk_array["acpsdk.jfAppTransUrl"] : null;
$this->qrcBackTransUrl = array_key_exists("acpsdk.qrcBackTransUrl", $sdk_array)?$sdk_array["acpsdk.qrcBackTransUrl"] : null;
$this->qrcB2cIssBackTransUrl = array_key_exists("acpsdk.qrcB2cIssBackTransUrl", $sdk_array)?$sdk_array["acpsdk.qrcB2cIssBackTransUrl"] : null;
$this->qrcB2cMerBackTransUrl = array_key_exists("acpsdk.qrcB2cMerBackTransUrl", $sdk_array)?$sdk_array["acpsdk.qrcB2cMerBackTransUrl"] : null;
$this->signMethod = array_key_exists("acpsdk.signMethod", $sdk_array)?$sdk_array["acpsdk.signMethod"] : null;
$this->version = array_key_exists("acpsdk.version", $sdk_array)?$sdk_array["acpsdk.version"] : null;
$this->ifValidateCNName = array_key_exists("acpsdk.ifValidateCNName", $sdk_array)?$sdk_array["acpsdk.ifValidateCNName"] : "true";
$this->ifValidateRemoteCert = array_key_exists("acpsdk.ifValidateRemoteCert", $sdk_array)?$sdk_array["acpsdk.ifValidateRemoteCert"] : "false";
$this->signCertPath = $certsFilePath . (array_key_exists("acpsdk.signCert.path", $sdk_array)?$sdk_array["acpsdk.signCert.path"]: null);
$this->signCertPwd = array_key_exists("acpsdk.signCert.pwd", $sdk_array)?$sdk_array["acpsdk.signCert.pwd"]: null;
$this->validateCertDir = array_key_exists("acpsdk.validateCert.dir", $sdk_array)? $sdk_array["acpsdk.validateCert.dir"]: null;
$this->encryptCertPath = $certsFilePath . (array_key_exists("acpsdk.encryptCert.path", $sdk_array)? $sdk_array["acpsdk.encryptCert.path"]: null);
$this->rootCertPath = $certsFilePath . (array_key_exists("acpsdk.rootCert.path", $sdk_array)? $sdk_array["acpsdk.rootCert.path"]: null);
$this->middleCertPath = $certsFilePath . (array_key_exists("acpsdk.middleCert.path", $sdk_array)?$sdk_array["acpsdk.middleCert.path"]: null);
$this->frontUrl = array_key_exists("acpsdk.frontUrl", $sdk_array)?$sdk_array["acpsdk.frontUrl"]: null;
$this->backUrl = array_key_exists("acpsdk.backUrl", $sdk_array)?$sdk_array["acpsdk.backUrl"]: null;
$this->secureKey = array_key_exists("acpsdk.secureKey", $sdk_array)?$sdk_array["acpsdk.secureKey"]: null;
$this->logFilePath = array_key_exists("acpsdk.log.file.path", $sdk_array)?$sdk_array["acpsdk.log.file.path"]: null;
$this->logLevel = array_key_exists("acpsdk.log.level", $sdk_array)?$sdk_array["acpsdk.log.level"]: null;
}
public function __get($property_name)
{
if(isset($this->$property_name))
{
return($this->$property_name);
}
else
{
return(NULL);
}
}
}
ここで間違ったtxnTime形式を送信しないように注意してください。テスト環境では問題はありません。取得したtnを支払いのためにアプリに返すだけです
3。非同期通知処理と注文トランザクション ステータス クエリ
まず、非同期通知処理について説明します。このステップは、注文ステータス変更の主な基礎です。実際に難しいことはありません。関連するパラメータに問題がないことを確認してください
use com\unionpay\acp\sdk\AcpService;
use com\unionpay\acp\sdk\LogUtil;
use com\unionpay\acp\sdk\SDKConfig;
/**
* 银联支付下单
*
* @param $orders
* @param $orders_type
* @return array
*/
public function unionPay($orders, $orders_type = 0)
{
include_once dirname(dirname(dirname(__FILE__))) . '/Model/unionpay-sdk/sdk/acp_service.php';
$config = new SDKConfig();
$AcpService = new AcpService();
$log = LogUtil::getLogger();
$time = date('YmdHis', time());
$params = array(
//以下信息非特殊情况不需要改动
'version' => $config->getSDKConfig()->version, //版本号
'encoding' => 'utf-8', //编码方式
'txnType' => '01', //交易类型
'txnSubType' => '01', //交易子类
'bizType' => '000201', //业务类型
'frontUrl' => $config->getSDKConfig()->frontUrl, //前台通知地址
'backUrl' => $this->getURL('api_pay_unionpay_call_back'), //后台通知地址
'signMethod' => $config->getSDKConfig()->signMethod, //签名方法
'channelType' => '08', //渠道类型，07-PC，08-手机
'accessType' => '0', //接入类型
'currencyCode' => '156', //交易币种，境内商户固定156
//TODO 以下信息需要填写
'merId' => $this->getParameter('mer_id'), //商户代码，请改自己的测试商户号
'orderId' => $orders["order_no"], //商户订单号，8-32位数字字母，不能含“-”或“_”
'txnTime' => $time, //订单发送时间，格式为YYYYMMDDhhmmss，取北京时间
'txnAmt' => $orders['total_price'] * 100, //交易金额，单位分
);
$AcpService->sign ( $params ); // 签名
$url = $config->getSDKConfig()->appTransUrl;
$result_arr = $AcpService->post ($params, $url);
if(count($result_arr)<=0) { //没收到200应答的情况 $log->LogInfo('没收到200应答的情况');
}
// $this->printResult ($url, $params, $result_arr ); //页面打印请求应答数据
if (!$AcpService->validate ($result_arr) ){
$log->LogInfo('应答报文验签失败');
}
if ($result_arr["respCode"] == "00"){
//成功
return array('txn_time'=>$time, 'tn'=>$result_arr["tn"]);
// echo "后续请将此tn传给手机开发，由他们用此tn调起控件后完成支付。
\n";
// echo "手机端demo默认从仿真获取tn，仿真只返回一个tn，如不想修改手机和后台间的通讯方式，【此页面请修改代码为只输出tn】。
\n";
} else {
//其他应答码做以失败处理
return array('txn_time'=>$time, 'tn'=>0);
//echo "失败：" . $result_arr["respMsg"] . "。
\n";
}
}
注文取引状況の照会
/**
* 银联回调
*
* @param Request $request
* @return array|Response
*/
public function unionPayCallBackAction(Request $request)
{
if ($request->get('type') == 1){//前台通知-进行订单状态查询
$query = $this->unionPayQuery($request, array(), 1);
return new JsonResponse($query);
}
require_once dirname(dirname(dirname(__FILE__))) . "/Model/unionpay-sdk/sdk/acp_service.php";
$log = LogUtil::getLogger();
$AcpService = new AcpService();
if ($request->request->has('signature') && $AcpService->validate($_POST)) {
$order_no = $request->request->get('orderId');
$respCode = $request->request->get('respCode');
$total = $request->request->get('txnAmt'); // 交易金额
if ($respCode === '00' || $respCode === 'A6') {
$trade_no = $request->request->get('origQryId')?:'UN' . date('YmdHis', time()) . substr(implode(NULL, array_map('ord', str_split(substr(uniqid(), 7, 13), 1))), 0, 8);
$this->dispose($order_no, $trade_no, 4);//订单交易处理-请根据实际情况自行编写
}
} else {
if (!$request->request->has('signature')) {
$log->LogInfo('签名为空');
} else {
$log->LogInfo('验签失败');
}
}
exit;
}
プロジェクトの注文がない場合は、オンラインで返金されます。完成します。
注文返金関連
do{//循环查询，直到获取到退款订单的queryID
sleep($number * 2);
$query = $this->unionPayQuery('', $orders);
$number += 1;
}while($query['errorCode'] != 0 || empty($query['result_arr']["queryId"]));
public function unionPayQuery($request, $orders)
{
require_once dirname(dirname(dirname(__FILE__))) . "/Model/unionpay-sdk/sdk/acp_service.php";
$config = new SDKConfig();
$AcpService = new AcpService();
$log = LogUtil::getLogger();
$params = array(
//以下信息非特殊情况不需要改动
'version' => $config->getSDKConfig()->version, //版本号
'encoding' => 'utf-8', //编码方式
'signMethod' => $config->getSDKConfig()->signMethod, //签名方法
'txnType' => '00', //交易类型
'txnSubType' => '00', //交易子类
'bizType' => '000000', //业务类型
'accessType' => '0', //接入类型
'channelType' => '07', //渠道类型
//TODO 以下信息需要填写
'orderId' => $orders['order_no'], //请修改被查询的交易的订单号，8-32位数字字母，不能含“-”或“_”
'merId' => $this->getParameter('mer_id'), //商户代码，请改自己的测试商户号
'txnTime' => date('YmdHis', time()), //请修改被查询的交易的订单发送时间，格式为YYYYMMDDhhmmss
);
$AcpService->sign ( $params ); // 签名
$url = $config->getSDKConfig()->singleQueryUrl;
$result_arr = $AcpService->post ( $params, $url);
if(count($result_arr)<=0) { //没收到200应答的情况 $log->LogInfo('没收到200应答的情况');
}
if (!$AcpService->validate ($result_arr) ){
$log->LogInfo('应答报文验签失败');
}
if ($result_arr["respCode"] == "00"){
if ($result_arr["origRespCode"] == "00"){
//交易成功
$trade_no = 'UN' . date('YmdHis', time()) . substr(implode(NULL, array_map('ord', str_split(substr(uniqid(), 7, 13), 1))), 0, 8);
$this->dispose($orders['order_no'], $trade_no, 4);
$result = array('errorCode'=>0, 'message'=>'交易成功', 'result_arr'=>$result_arr);
} else if ($result_arr["origRespCode"] == "03"
|| $result_arr["origRespCode"] == "04"
|| $result_arr["origRespCode"] == "05"){
//后续需发起交易状态查询交易确定交易状态
$result = array('errorCode'=>2, 'message'=>'交易处理中', 'result_arr'=>$result_arr);
} else {
//其他应答码做以失败处理
echo "交易失败：" . $result_arr["origRespMsg"] . "。
\n";
$result = array('errorCode'=>1, 'message'=>"交易失败：" . $result_arr["origRespMsg"] . ".", 'result_arr'=>$result_arr);
}
} else if ($result_arr["respCode"] == "03"
|| $result_arr["respCode"] == "04"
|| $result_arr["respCode"] == "05" ){
//后续需发起交易状态查询交易确定交易状态
$result = array('errorCode'=>2, 'message'=>"处理超时，请稍后查询.", 'result_arr'=>$result_arr);
} else {
//其他应答码做以失败处理
$result = array('errorCode'=>1, 'message'=>"失败：" . $result_arr["respMsg"] . ".", 'result_arr'=>$result_arr);
}
return $result;
}
実際のロジックコードはご自身で実装してください
public function refundUnionPay($orders)
{
require_once(dirname(dirname(__FILE__)) . "/Model/unionpay-sdk/sdk/acp_service.php");
set_time_limit(100);
$config = new SDKConfig();
$AcpService = new AcpService();
$log = LogUtil::getLogger();
$number = 0;
do{//循环查询，直到获取到退款订单的queryID
sleep($number * 2);
$query = $this->unionPayQuery('', $orders);
$number += 1;
}while($query['errorCode'] != 0 || empty($query['result_arr']["queryId"]));
if ($query['errorCode'] != 0) {
return array('errorCode'=>1, 'message'=>'订单未成交，无法退款');
}
$params = array(
//以下信息非特殊情况不需要改动
'version' => $config->getSDKConfig()->version, //版本号
'encoding' => 'utf-8', //编码方式
'signMethod' => $config->getSDKConfig()->signMethod, //签名方法
'txnType' => '04', //交易类型
'txnSubType' => '00', //交易子类
'bizType' => '000201', //业务类型
'accessType' => '0', //接入类型
'channelType' => '07', //渠道类型
'backUrl' => $config->getSDKConfig()->backUrl, //后台通知地址
//TODO 以下信息需要填写
'orderId' => "T" . $orders['order_no'], //商户订单号，8-32位数字字母，不能含“-”或“_”，可以自行定制规则，重新产生-此处为在退款订单前拼接 T
'merId' => $this->getParameter('mer_id'), //商户代码，请改成自己的商户号
'origQryId' => $query['result_arr']["queryId"], //原消费的queryId，可以从查询接口或者通知接口中获取
'txnTime' => date('YmdHis', time()), //订单发送时间，格式为YYYYMMDDhhmmss，重新产生，不同于原消费
'txnAmt' => $orders['total_price'] * 100, //交易金额，退货总金额需要小于等于原消费
);
$AcpService->sign ( $params ); // 签名
$url = $config->getSDKConfig()->backTransUrl;
$result_arr = $AcpService->post ( $params, $url);
if(count($result_arr)<=0) { //没收到200应答的情况 return array('errorCode'=>1, 'message'=>"没收到应答.");
}
if (!$AcpService->validate ($result_arr) ){
return array('errorCode'=>1, 'message'=>"应答报文验签失败.");
}
if ($result_arr["respCode"] == "00"){
//交易已受理，等待接收后台通知更新订单状态，如果通知长时间未收到也可发起交易状态查询
return array('errorCode'=>0, 'message'=>"受理成功.");
} else if ($result_arr["respCode"] == "03"
|| $result_arr["respCode"] == "04"
|| $result_arr["respCode"] == "05" ){
//后续需发起交易状态查询交易确定交易状态
return array('errorCode'=>1, 'message'=>"处理超时，请稍微查询.");
} else {
//其他应答码做以失败处理
return array('errorCode'=>1, 'message'=>"失败：" . $result_arr["respMsg"] . ".");
}
}
プロジェクト関係は一時的に利用できません - follow-追加アップ
続きます。 。 。 。関連推奨事項:
PHPバックエンドUnionPay支払いの詳しい説明
PHPバックエンド
と返金例
UnionPay支払いDevelopment_html/ css_WEB-ITnose
以上がPHPを使用したバックエンドUnionPayの支払いと返金の例の詳細な説明の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。
声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
PHPでの依存関係注射：一般的な落とし穴の回避May 16, 2025 am 12:17 AM依存関係の指示（di）inphpenhancesscodeflexibility andtestability bydecouplingdepensitycreation fromusage.toemplementdiefectivilly：1）sudiconticainersichyloiavoidovedovedineriering.2）回避装置の回避装置loadbylimitingdencedentotheeorfour.3）adhe
PHP Webサイトをスピードアップする方法：パフォーマンスチューニングMay 16, 2025 am 12:12 AMtoimproveyourphpwebsite'sperformance、usethesestrategies：1）codecaching withop cachetospeedupscriptscriptintertention.2）最適化策を選択することを最適化してください
PHPで大量の電子メールを送信する：可能ですか？May 16, 2025 am 12:10 AMはい、itispossibletosendmassemailswithphp.1）uselibrarieslikephpmailerorsforfienceemailsending.2）vetseemailstoavoidspamflags.3）emorizeemailsusingdynamicconttoimbroveengagemention.
PHPの依存噴射の目的は何ですか？May 16, 2025 am 12:10 AM依存関係の指示（di）inphpisadesignpatterntativevevesion ofコントロール（IOC）は、依存性を依存していることによって、微分化された誘惑を依存させ、微分、テスト可能性、および柔軟性を高めることができます
PHPを使用して電子メールを送信する方法は？May 16, 2025 am 12:03 AMPHPを使用して電子メールを送信する最良の方法は次のとおりです。1。PHPのMail（）関数を基本送信に使用します。 2。phpmailerライブラリを使用して、より複雑なHTMLメールを送信します。 3. SendGridなどのトランザクションメールサービスを使用して、信頼性と分析機能を改善します。これらの方法を使用すると、電子メールが受信トレイに届くだけでなく、受信者を引き付けることもできます。
PHP多次元アレイの要素の総数を計算する方法は？May 15, 2025 pm 09:00 PMPHP多次元アレイの要素の総数を計算することは、再帰的または反復的な方法を使用して行うことができます。 1.再帰的な方法は、アレイを通過し、ネストされた配列を再帰的に処理することによりカウントされます。 2。反復法は、スタックを使用して再帰をシミュレートして深さの問題を回避します。 3. array_walk_recursive関数も実装できますが、手動でカウントする必要があります。
PHPのDo-While Loopsの特徴は何ですか？May 15, 2025 pm 08:57 PMPHPでは、ループの特性は、ループ本体が少なくとも1回実行されることを確認し、条件に基づいてループを続行するかどうかを決定することです。 1）条件付きチェックの前にループ本体を実行します。これは、ユーザー入力検証やメニューシステムなど、操作を少なくとも1回実行する必要があるシナリオに適しています。 2）ただし、do-whileループの構文は、初心者間の混乱を引き起こす可能性があり、不要なパフォーマンスオーバーヘッドを追加する可能性があります。
PHPで弦をハッシュする方法は？May 15, 2025 pm 08:54 PMPHPの効率的なハッシュ文字列は、次の方法を使用できます。1。MD5関数を使用して高速ハッシュを使用しますが、パスワードストレージには適していません。 2。SHA256関数を使用して、セキュリティを改善します。 3. password_hash関数を使用してパスワードを処理して、最高のセキュリティと利便性を提供します。
ホットAIツール
Undresser.AI Undress
リアルなヌード写真を作成する AI 搭載アプリ
AI Clothes Remover
写真から衣服を削除するオンライン AI ツール。
Undress AI Tool
脱衣画像を無料で
Clothoff.io
AI衣類リムーバー
Video Face Swap
完全無料の AI 顔交換ツールを使用して、あらゆるビデオの顔を簡単に交換できます。
人気の記事
<🎜>：庭を育てる - 完全な突然変異ガイド
4週間前ByDDD
<🎜>：バブルガムシミュレーターインフィニティ - ロイヤルキーの取得と使用方法
1 か月前By尊渡假赌尊渡假赌尊渡假赌
Nordhold：Fusion System、説明
1 か月前By尊渡假赌尊渡假赌尊渡假赌
マンドラゴラ：魔女の木のささやき - グラップリングフックのロックを解除する方法
4週間前By尊渡假赌尊渡假赌尊渡假赌
ホットツール
SublimeText3 Linux 新バージョン
SublimeText3 Linux 最新バージョン
SublimeText3 英語版
推奨: Win バージョン、コードプロンプトをサポート!
メモ帳++7.3.1
使いやすく無料のコードエディター
PhpStorm Mac バージョン
最新(2018.2.1)のプロフェッショナル向けPHP統合開発ツール
Safe Exam Browser
Safe Exam Browser は、オンライン試験を安全に受験するための安全なブラウザ環境です。このソフトウェアは、あらゆるコンピュータを安全なワークステーションに変えます。あらゆるユーティリティへのアクセスを制御し、学生が無許可のリソースを使用するのを防ぎます。
