Exemples de paiements et de remboursements UnionPay backend PHP

Cet article présente principalement l'exemple de code de paiement et de remboursement du back-end PHP UnionPay. L'éditeur pense qu'il est assez bon, je vais donc le partager avec vous maintenant et le donner comme référence. Suivons l'éditeur et jetons un coup d'œil

Déclaration : Cet article est basé sur le dernier SDK officiel d'UnionPay (2016-08-09 version 5.1.0). Si les packages sont différents, veuillez vérifier s'il s'agit bien du dernier SDK officiel d'UnionPay. cas. Version

Paiement UnionPay récemment rencontré et remboursements associés (cet article est uniquement basé sur le paiement par contrôle par téléphone mobile). Ce qui suit décrit les problèmes rencontrés au cours de la période et le processus de base. l'officiel Cette image montre certaines choses que nous devons faire pour le personnel back-end lors d'un paiement

Comme le montre cette image, le back-end est responsable de 1 . Commandes de plateforme Générer ; 2. Transférer les commandes vers la plateforme omnicanal UnionPay ; 3. Renvoyer le code tn au front-end pour le paiement ; 4. Traiter les notifications frontales et les notifications asynchrones de la plateforme omnicanal.

Il y a trois difficultés ici, le push de commande, le traitement des notifications asynchrones et la requête sur l'état de la commande.

Téléchargez le package correspondant via les instructions officielles par courrier électronique et insérez-le dans le code php back-end (si vous téléchargez le contrôle de paiement, vous ne verrez probablement que les versions IOS et Android du SDK. . Pour le back-end, il suffit d'en télécharger un, le code PHP y est placé) ; puis de lire attentivement le fichier readme.txt dans le SDK, puis d'effectuer les étapes suivantes :

1. . Configuration des paramètres associés

Pendant le processus d'amarrage, utilisez l'environnement de test le fichier de configuration et le certificat dans le dossier Assets du SDK, placez-les dans le dossier SDK et configurez le /. Fichier sdk/SDKconfig.php à lire correctement Récupérez le fichier de configuration acp_sdk.ini.

Configurez les adresses absolues des quatre fichiers acpsdk.signCert.path, acpsdk.encryptCert.path, acpsdk.rootCert.path et acpsdk.middleCert.path dans le fichier acp_sdk.ini (personnalisez simplement le chemin du fichier) .

En raison de différents systèmes ou d'adresses de projet différentes, des erreurs telles que les adresses absolues des certificats peuvent se produire lors du développement du projet, en particulier dans les environnements de production réels, il est très facile d'avoir différentes adresses de fichiers de déploiement de projet, ce qui le rend. impossible de Après chaque mise à jour, l'adresse du certificat doit être modifiée. Le SDKconfig.php dans le SDK a été modifié pour être compatible avec différentes adresses de fichiers. Veuillez cliquer pour développer et afficher

<?php
namespace com\unionpay\acp\sdk;;
include_once &#39;log.class.php&#39;;
include_once &#39;common.php&#39;;
 
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);
    }
  } 
}

2. . Push de commande de produits Full Channel

Veuillez cliquer pour voir le code correspondant

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(&#39;没收到200应答的情况&#39;);
    }
 
//    $this->printResult ($url, $params, $result_arr ); //页面打印请求应答数据
 
    if (!$AcpService->validate ($result_arr) ){
      $log->LogInfo(&#39;应答报文验签失败&#39;);
    }
    if ($result_arr["respCode"] == "00"){
      //成功
      return array(&#39;txn_time&#39;=>$time, &#39;tn&#39;=>$result_arr["tn"]);
//      echo "后续请将此tn传给手机开发，由他们用此tn调起控件后完成支付。
\n";
//      echo "手机端demo默认从仿真获取tn，仿真只返回一个tn，如不想修改手机和后台间的通讯方式，【此页面请修改代码为只输出tn】。
\n";
    } else {
      //其他应答码做以失败处理
      return array(&#39;txn_time&#39;=>$time, &#39;tn&#39;=>0);
      //echo "失败：" . $result_arr["respMsg"] . "。
\n";
 
    }
  }

Veuillez noter que le format txnTime ne doit pas être transmis de manière incorrecte. problèmes dans l'environnement de test. Le tn obtenu peut être retourné à l'APP pour paiement

3. Traitement des notifications asynchrones et requête sur l'état de la transaction de commande

Le principal. La fonction de cette étape est de traiter les informations de réussite de la transaction UnionPay et d'essayer d'éviter les problèmes causés par des rappels non gérés.

Parlons d'abord du traitement des notifications asynchrones. Cette étape est la base principale de la modification du statut de la commande. Il n'y a pas de difficultés réelles, assurez-vous simplement qu'il n'y a pas de problèmes avec les paramètres pertinents

/**
   * 银联回调
   *
   * @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;
  }

Requête sur l'état de la transaction de commande

   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(&#39;没收到200应答的情况&#39;);
    }
 
    if (!$AcpService->validate ($result_arr) ){
      $log->LogInfo(&#39;应答报文验签失败&#39;);
    }
    if ($result_arr["respCode"] == "00"){
      if ($result_arr["origRespCode"] == "00"){
        //交易成功
        $trade_no = &#39;UN&#39; . date(&#39;YmdHis&#39;, time()) . substr(implode(NULL, array_map(&#39;ord&#39;, str_split(substr(uniqid(), 7, 13), 1))), 0, 8);
        $this->dispose($orders[&#39;order_no&#39;], $trade_no, 4);
        $result = array(&#39;errorCode&#39;=>0, &#39;message&#39;=>&#39;交易成功&#39;, &#39;result_arr&#39;=>$result_arr);
 
      } else if ($result_arr["origRespCode"] == "03"
        || $result_arr["origRespCode"] == "04"
        || $result_arr["origRespCode"] == "05"){
        //后续需发起交易状态查询交易确定交易状态
 
        $result = array(&#39;errorCode&#39;=>2, &#39;message&#39;=>&#39;交易处理中&#39;, &#39;result_arr&#39;=>$result_arr);
 
      } else {
        //其他应答码做以失败处理
 
        echo "交易失败：" . $result_arr["origRespMsg"] . "。
\n";
 
        $result = array(&#39;errorCode&#39;=>1, &#39;message&#39;=>"交易失败：" . $result_arr["origRespMsg"] . ".", &#39;result_arr&#39;=>$result_arr);
      }
    } else if ($result_arr["respCode"] == "03"
      || $result_arr["respCode"] == "04"
      || $result_arr["respCode"] == "05" ){
      //后续需发起交易状态查询交易确定交易状态
 
      $result = array(&#39;errorCode&#39;=>2, &#39;message&#39;=>"处理超时，请稍后查询.", &#39;result_arr&#39;=>$result_arr);
    } else {
      //其他应答码做以失败处理
 
 
      $result = array(&#39;errorCode&#39;=>1, &#39;message&#39;=>"失败：" . $result_arr["respMsg"] . ".", &#39;result_arr&#39;=>$result_arr);
    }
 
    return $result;
  }

C'est tout s'il n'y a pas de commande pour le projet. , le remboursement en ligne sera effectué.

Remboursement de la commande

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(&#39;errorCode&#39;=>1, &#39;message&#39;=>"没收到应答.");
    }
 
    if (!$AcpService->validate ($result_arr) ){
      return array(&#39;errorCode&#39;=>1, &#39;message&#39;=>"应答报文验签失败.");
    }
 
    if ($result_arr["respCode"] == "00"){
      //交易已受理，等待接收后台通知更新订单状态，如果通知长时间未收到也可发起交易状态查询
      return array(&#39;errorCode&#39;=>0, &#39;message&#39;=>"受理成功.");
 
    } else if ($result_arr["respCode"] == "03"
      || $result_arr["respCode"] == "04"
      || $result_arr["respCode"] == "05" ){
      //后续需发起交易状态查询交易确定交易状态
      return array(&#39;errorCode&#39;=>1, &#39;message&#39;=>"处理超时，请稍微查询.");
    } else {
      //其他应答码做以失败处理
 
      return array(&#39;errorCode&#39;=>1, &#39;message&#39;=>"失败：" . $result_arr["respMsg"] . ".");
    }
  }

Effectuez simplement les opérations pertinentes en fonction de la valeur de l'état de retour. Veuillez implémenter vous-même le code logique réel

Changez l'environnement de production<.>

La relation projet est temporairement indisponible - ajouts de suivi

À suivre. . . .

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!