Home
WeChat Applet
WeChat Development
Detailed explanation of credit card payment examples for WeChat payment development
WeChat Applet
WeChat Development
Detailed explanation of credit card payment examples for WeChat payment development
Detailed explanation of credit card payment examples for WeChat payment development
May 12, 2018 am 10:32 AM
This article introduces the development process of card payment under WeChat payment. WeChat card payment refers to the payment process in which the user opens the card swiping interface of WeChat wallet, and the merchant scans the QR code and submits the payment to complete the payment.
1. Card payment API
Interface address
api.mch.weixin.qq.com/pay/micropay
Is a certificate required?
No.
Input parameters
Name variable name required type example value description
| public account ID | appid | is | String(32) | wx8888888888888888 | The public account ID assigned by WeChat (corpid is the This appId) |
| merchant number | mch_id | is | String(32) | 1900000109 | Merchant number assigned by WeChat payment |
| Device number | device_info | No | String(32) | 013467007045764 | Terminal device number (customized by the merchant, such as store number) |
| Random string | nonce_str | is | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | Random string, no longer than 32 bits. The recommended random number generation algorithm |
| signature | sign | is | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | Signature, see signature generation algorithm for details |
| Product description | body | is | String(128) | image image store-Shenzhen Tengda-QQ doll | A brief description of the product, this field must be passed strictly in accordance with the specifications, for details, please see the parameter regulations |
| Product details | detail | No | String(6000) | {
"goods_detail":[
{
"goods_id":"iphone6s_16G",
"wxpay_goods_id":"1001",
"goods_name":"iPhone6s 16G",
"goods_num":1,
"price":528800,
"goods_category":"123456",
"body":"蘋果手機(jī)"
},
{
"goods_id":"iphone6s_32G",
"wxpay_goods_id":"1002",
"goods_name":"iPhone6s 32G",
"quantity":1,
"price":608800,
"goods_category":"123789",
"body":"蘋果手機(jī)"
}
]
} | Product detailed list, using Json format , please be sure to use the CDATA tag to protect the JSON text string before transmitting the signature. goods_detail []： |
| Additional data | attach | No | String(127) | Description | Additional data, returned as is in the query API and payment notification, this field is mainly used for merchants to carry custom data for orders |
| Merchant order number | out_trade_no | is | String(32) | 1217752501201407033233368018 | The order number within the merchant system, within 32 characters, can contain letters. For other instructions, see the merchant order No. |
| Product details | detail | No | String(8192) | is consistent with the submitted data | The actual submitted return |
| order amount | total_fee | is | Int | 888 | Total order amount, unit is cents, can only be an integer, see payment amount |
| Currency type | fee_type | No | String(16) | CNY | is a three-letter code that conforms to the ISO4217 standard. The default is RMB: CNY. For a list of other values, see Currency Type |
| Terminal IP | spbill_create_ip | is | String(16) | 8.8.8.8 | Machine IP calling WeChat payment API |
| Goods tag | goods_tag | No | String(32) | Product tags, parameters of voucher or instant discount function, please refer to voucher or instant discount discount for details | |
| Specified payment method | limit_pay | No | String(32) | no_credit | no_credit--Specify that credit card payment cannot be used |
| Authorization code | auth_code | is | String(128) | 120061098828009406 | Scan the QR code to pay the authorization code , the device reads the barcode or QR code information in the user's WeChat |
Examples are as follows:
<xml> <appid>wx2421b1c4370ec43b</appid> <attach>訂單額外描述</attach> <auth_code>120269300684844649</auth_code> <body>刷卡支付測(cè)試</body> <device_info>1000</device_info> <goods_tag></goods_tag> <mch_id>10000100</mch_id> <nonce_str>8aaee146b1dee7cec9100add9b96cbe2</nonce_str> <out_trade_no>1415757673</out_trade_no> <spbill_create_ip>14.17.22.52</spbill_create_ip> <time_expire></time_expire> <total_fee>1</total_fee> <sign>C29DB7DB1FD4136B84AE35604756362C</sign> </xml>
Note: Parameter values ??can be escaped with XML, The CDATA tag is used to indicate that the data is not parsed by the XML parser.
Return results
Name variable name required type example value description
| return_code | is | String(16) | SUCCESS | SUCCESS/FAIL | This field is the communication identification. Non-transaction identifier. You need to check the result_code to determine whether the transaction is successful. |
| return_msg | No | String(128) | Signature failed | Return information, if not empty, is the error reason | Signature failed Parameter format verification error |
| 公眾賬號(hào)ID | appid | 是 | String(32) | wx8888888888888888 | 調(diào)用接口提交的公眾賬號(hào)ID |
| 商戶號(hào) | mch_id | 是 | String(32) | 1900000109 | 調(diào)用接口提交的商戶號(hào) |
| 設(shè)備號(hào) | device_info | 否 | String(32) | 013467007045764 | 調(diào)用接口提交的終端設(shè)備號(hào)， |
| 隨機(jī)字符串 | nonce_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 微信返回的隨機(jī)字符串 |
| 簽名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 微信返回的簽名，詳見簽名生成算法 |
| 業(yè)務(wù)結(jié)果 | result_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
| 錯(cuò)誤代碼 | err_code | 否 | String(32) | SYSTEMERROR | 詳細(xì)參見錯(cuò)誤列表 |
| 錯(cuò)誤代碼描述 | err_code_des | 否 | String(128) | 系統(tǒng)錯(cuò)誤 | 錯(cuò)誤返回的信息描述 |
當(dāng)return_code 和result_code都為SUCCESS的時(shí)，還會(huì)包括以下字段：
名稱 變量名 必填 類型 示例值 描述
| 用戶標(biāo)識(shí) | openid | 是 | String(128) | Y | 用戶在商戶appid 下的唯一標(biāo)識(shí) |
| 是否關(guān)注公眾賬號(hào) | is_subscribe | 是 | String(1) | Y | 用戶是否關(guān)注公眾賬號(hào)，僅在公眾賬號(hào)類型支付有效，取值范圍：Y或N;Y-關(guān)注;N-未關(guān)注 |
| 交易類型 | trade_type | 是 | String(16) | MICROPAY | 支付類型為MICROPAY(即掃碼支付) |
| 付款銀行 | bank_type | 是 | String(16) | CMC | 銀行類型，采用字符串類型的銀行標(biāo)識(shí)，值列表詳見銀行類型 |
| 貨幣類型 | fee_type | 否 | String(16) | CNY | 符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，默認(rèn)人民幣：CNY，其他值列表詳見貨幣類型 |
| 訂單金額 | total_fee | 是 | Int | 888 | 訂單總金額，單位為分，只能為整數(shù)，詳見支付金額 |
| 現(xiàn)金支付貨幣類型 | cash_fee_type | 否 | String(16) | CNY | 符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼，默認(rèn)人民幣：CNY，其他值列表詳見貨幣類型 |
| 現(xiàn)金支付金額 | cash_fee | 是 | Int | 100 | 訂單現(xiàn)金支付金額，詳見支付金額 |
| 微信支付訂單號(hào) | transaction_id | 是 | String(32) | 1217752501201407033233368018 | 微信支付訂單號(hào) |
| 商戶訂單號(hào) | out_trade_no | 是 | String(32) | 1217752501201407033233368018 | 商戶系統(tǒng)的訂單號(hào)，與請(qǐng)求一致。 |
| 商家數(shù)據(jù)包 | attach | 否 | String(128) | 123456 | 商家數(shù)據(jù)包，原樣返回 |
| 支付完成時(shí)間 | time_end | 是 | String(14) | 20141030133525 | 訂單生成時(shí)間，格式為yyyyMMddHHmmss，如2009年12月25日9點(diǎn)10分10秒表示為20091225091010。詳見時(shí)間規(guī)則 |
舉例如下：
<xml> <return_code><![CDATA[SUCCESS]]></return_code> <return_msg><![CDATA[OK]]></return_msg> <appid><![CDATA[wx2421b1c4370ec43b]]></appid> <mch_id><![CDATA[10000100]]></mch_id> <device_info><![CDATA[1000]]></device_info> <nonce_str><![CDATA[GOp3TRyMXzbMlkun]]></nonce_str> <sign><![CDATA[D6C76CB785F07992CDE05494BB7DF7FD]]></sign> <result_code><![CDATA[SUCCESS]]></result_code> <openid><![CDATA[oUpF8uN95-Ptaags6E_roPHg7AG0]]></openid> <is_subscribe><![CDATA[Y]]></is_subscribe> <trade_type><![CDATA[MICROPAY]]></trade_type> <bank_type><![CDATA[CCB_DEBIT]]></bank_type> <total_fee>1</total_fee> <coupon_fee>0</coupon_fee> <fee_type><![CDATA[CNY]]></fee_type> <transaction_id><![CDATA[1008450740201411110005820873]]></transaction_id> <out_trade_no><![CDATA[1415757673]]></out_trade_no> <attach><![CDATA[訂單額外描述]]></attach> <time_end><![CDATA[20141111170043]]></time_end> </xml>
二、刷卡支付類實(shí)現(xiàn)
在微信支付原來(lái)的微信支付類文件中，仿照統(tǒng)一支付類的方式，添加刷卡支付類如下：
/**
* 刷卡支付接口類
*/
class MicroPay_pub extends Wxpay_client_pub
{
function __construct()
{
//設(shè)置接口鏈接
$this->url = "https://api.mch.weixin.qq.com/pay/micropay";
//設(shè)置curl超時(shí)時(shí)間
$this->curl_timeout = WxPayConf_pub::CURL_TIMEOUT;
}
/**
* 生成接口參數(shù)xml
*/
function createXml()
{
try
{
//檢測(cè)必填參數(shù)
if($this->parameters["out_trade_no"] == null){
throw new SDKRuntimeException("缺少統(tǒng)一支付接口必填參數(shù)out_trade_no！"."<br>");
}elseif($this->parameters["body"] == null){
throw new SDKRuntimeException("缺少統(tǒng)一支付接口必填參數(shù)body！"."<br>");
}elseif ($this->parameters["total_fee"] == null ) {
throw new SDKRuntimeException("缺少統(tǒng)一支付接口必填參數(shù)total_fee！"."<br>");
}elseif ($this->parameters["auth_code"] == null) {
throw new SDKRuntimeException("缺少統(tǒng)一支付接口必填參數(shù)auth_code！"."<br>");
}
$this->parameters["appid"] = WxPayConf_pub::APPID;//公眾賬號(hào)ID
$this->parameters["mch_id"] = WxPayConf_pub::MCHID;//商戶號(hào)
$this->parameters["spbill_create_ip"] = $_SERVER['REMOTE_ADDR'];//終端ip
$this->parameters["nonce_str"] = $this->createNoncestr();//隨機(jī)字符串
$this->parameters["sign"] = $this->getSign($this->parameters);//簽名
// var_dump($this->parameters);
return $this->arrayToXml($this->parameters);
}catch (SDKRuntimeException $e)
{
die($e->errorMessage());
}
}
}原有的基礎(chǔ)類和請(qǐng)求類也列出如下：
/**
* 所有接口的基類
*/
class Common_util_pub
{
function __construct() {
}
function trimString($value)
{
$ret = null;
if (null != $value)
{
$ret = $value;
if (strlen($ret) == 0)
{
$ret = null;
}
}
return $ret;
}
/**
* 作用：產(chǎn)生隨機(jī)字符串，不長(zhǎng)于32位
*/
public function createNoncestr( $length = 32 )
{
$chars = "abcdefghijklmnopqrstuvwxyz0123456789";
$str ="";
for ( $i = 0; $i < $length; $i++ ) {
$str.= substr($chars, mt_rand(0, strlen($chars)-1), 1);
}
return $str;
}
/**
* 作用：格式化參數(shù)，簽名過(guò)程需要使用
*/
function formatBizQueryParaMap($paraMap, $urlencode)
{
$buff = "";
ksort($paraMap);
foreach ($paraMap as $k => $v)
{
if($urlencode)
{
$v = urlencode($v);
}
//$buff .= strtolower($k) . "=" . $v . "&";
$buff .= $k . "=" . $v . "&";
}
$reqPar;
if (strlen($buff) > 0)
{
$reqPar = substr($buff, 0, strlen($buff)-1);
}
return $reqPar;
}
/**
* 作用：生成簽名
*/
public function getSign($Obj)
{
foreach ($Obj as $k => $v)
{
$Parameters[$k] = $v;
}
//簽名步驟一：按字典序排序參數(shù)
ksort($Parameters);
$String = $this->formatBizQueryParaMap($Parameters, false);
//echo '【string1】'.$String.'</br>';
//簽名步驟二：在string后加入KEY
$String = $String."&key=".WxPayConf_pub::KEY;
//echo "【string2】".$String."</br>";
//簽名步驟三：MD5加密
$String = md5($String);
//echo "【string3】 ".$String."</br>";
//簽名步驟四：所有字符轉(zhuǎn)為大寫
$result_ = strtoupper($String);
//echo "【result】 ".$result_."</br>";
return $result_;
}
/**
* 作用：array轉(zhuǎn)xml
*/
function arrayToXml($arr)
{
$xml = "<xml>";
foreach ($arr as $key=>$val)
{
if (is_numeric($val))
{
$xml.="<".$key.">".$val."</".$key.">";
}
else
$xml.="<".$key."><![CDATA[".$val."]]></".$key.">";
}
$xml.="</xml>";
return $xml;
}
/**
* 作用：將xml轉(zhuǎn)為array
*/
public function xmlToArray($xml)
{
//將XML轉(zhuǎn)為array
$array_data = json_decode(json_encode(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
return $array_data;
}
/**
* 作用：以post方式提交xml到對(duì)應(yīng)的接口url
*/
public function postXmlCurl($xml,$url,$second=30)
{
//初始化curl
$ch = curl_init();
//設(shè)置超時(shí)
curl_setopt($ch, CURLOP_TIMEOUT, $second);
//這里設(shè)置代理，如果有的話
//curl_setopt($ch,CURLOPT_PROXY, '8.8.8.8');
//curl_setopt($ch,CURLOPT_PROXYPORT, 8080);
curl_setopt($ch,CURLOPT_URL, $url);
curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($ch,CURLOPT_SSL_VERIFYHOST,FALSE);
//設(shè)置header
curl_setopt($ch, CURLOPT_HEADER, FALSE);
//要求結(jié)果為字符串且輸出到屏幕上
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
//post提交方式
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
//運(yùn)行curl
$data = curl_exec($ch);
curl_close($ch);
//返回結(jié)果
if($data)
{
curl_close($ch);
return $data;
}
else
{
$error = curl_errno($ch);
echo "curl出錯(cuò)，錯(cuò)誤碼:$error"."<br>";
echo "<a href='http://curl.haxx.se/libcurl/c/libcurl-errors.html'>錯(cuò)誤原因查詢</a></br>";
curl_close($ch);
return false;
}
}
/**
* 作用：使用證書，以post方式提交xml到對(duì)應(yīng)的接口url
*/
function postXmlSSLCurl($xml,$url,$second=30)
{
$ch = curl_init();
//超時(shí)時(shí)間
curl_setopt($ch,CURLOPT_TIMEOUT,$second);
//這里設(shè)置代理，如果有的話
//curl_setopt($ch,CURLOPT_PROXY, '8.8.8.8');
//curl_setopt($ch,CURLOPT_PROXYPORT, 8080);
curl_setopt($ch,CURLOPT_URL, $url);
curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($ch,CURLOPT_SSL_VERIFYHOST,FALSE);
//設(shè)置header
curl_setopt($ch,CURLOPT_HEADER,FALSE);
//要求結(jié)果為字符串且輸出到屏幕上
curl_setopt($ch,CURLOPT_RETURNTRANSFER,TRUE);
//設(shè)置證書
//使用證書：cert 與 key 分別屬于兩個(gè).pem文件
//默認(rèn)格式為PEM，可以注釋
curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM');
curl_setopt($ch,CURLOPT_SSLCERT, dirname(__FILE__).WxPayConf_pub::SSLCERT_PATH);
//默認(rèn)格式為PEM，可以注釋
curl_setopt($ch,CURLOPT_SSLKEYTYPE,'PEM');
curl_setopt($ch,CURLOPT_SSLKEY, dirname(__FILE__).WxPayConf_pub::SSLKEY_PATH);
//post提交方式
curl_setopt($ch,CURLOPT_POST, true);
curl_setopt($ch,CURLOPT_POSTFIELDS,$xml);
$data = curl_exec($ch);
//返回結(jié)果
if($data){
curl_close($ch);
return $data;
}
else {
$error = curl_errno($ch);
echo "curl出錯(cuò)，錯(cuò)誤碼:$error"."<br>";
echo "<a href='http://curl.haxx.se/libcurl/c/libcurl-errors.html'>錯(cuò)誤原因查詢</a></br>";
curl_close($ch);
return false;
}
}
/**
* 作用：打印數(shù)組
*/
function printErr($wording='',$err='')
{
print_r('<pre class="brush:php;toolbar:false">');
echo $wording."</br>";
var_dump($err);
print_r('');
}
}
/**
* 請(qǐng)求型接口的基類
*/
class Wxpay_client_pub extends Common_util_pub
{
var $parameters;//請(qǐng)求參數(shù)，類型為關(guān)聯(lián)數(shù)組
public $response;//微信返回的響應(yīng)
public $result;//返回參數(shù)，類型為關(guān)聯(lián)數(shù)組
var $url;//接口鏈接
var $curl_timeout;//curl超時(shí)時(shí)間
/**
* 作用：設(shè)置請(qǐng)求參數(shù)
*/
function setParameter($parameter, $parameterValue)
{
$this->parameters[$this->trimString($parameter)] = $this->trimString($parameterValue);
}
/**
* 作用：設(shè)置標(biāo)配的請(qǐng)求參數(shù)，生成簽名，生成接口參數(shù)xml
*/
function createXml()
{
$this->parameters["appid"] = WxPayConf_pub::APPID;//公眾賬號(hào)ID
$this->parameters["mch_id"] = WxPayConf_pub::MCHID;//商戶號(hào)
$this->parameters["nonce_str"] = $this->createNoncestr();//隨機(jī)字符串
$this->parameters["sign"] = $this->getSign($this->parameters);//簽名
return $this->arrayToXml($this->parameters);
}
/**
* 作用：post請(qǐng)求xml
*/
function postXml()
{
$xml = $this->createXml();
$this->response = $this->postXmlCurl($xml,$this->url,$this->curl_timeout);
return $this->response;
}
/**
* 作用：使用證書post請(qǐng)求xml
*/
function postXmlSSL()
{
$xml = $this->createXml();
$this->response = $this->postXmlSSLCurl($xml,$this->url,$this->curl_timeout);
return $this->response;
}
/**
* 作用：獲取結(jié)果，默認(rèn)不使用證書
*/
function getResult()
{
$this->postXml();
$this->result = $this->xmlToArray($this->response);
return $this->result;
}
}三、發(fā)起支付
在程序中，獲得用戶的授權(quán)碼，并填入到$authcode參數(shù)中。授權(quán)碼就是條碼上的那一串18位純數(shù)字，以10、11、12、13、14、15開頭
其他參數(shù)則自動(dòng)生成或者手動(dòng)輸入指定。
調(diào)用函數(shù)如下所示
//全局引入微信支付類
Vendor('Wxpay.WxPayPubHelper.WxPayPubHelper');
//使用統(tǒng)一支付接口
$microPay = new \MicroPay_pub();
//設(shè)置統(tǒng)一支付接口參數(shù)
$microPay->setParameter("body","方倍商戶刷卡支付");//商品描述
$microPay->setParameter("out_trade_no", "$out_trade_no");//商戶訂單號(hào)
$microPay->setParameter("total_fee", $total_fee);//總金額
$microPay->setParameter("auth_code", $authcode);//授權(quán)碼
//獲取統(tǒng)一支付接口結(jié)果
$microPayResult = $microPay->getResult();
//3. 異常判斷
if (!isset($microPayResult["result_code"]) || ($microPayResult["result_code"] == "FAIL")) {
$this->resRpcError(isset($microPayResult['result_code']) ? $microPayResult['err_code_des'] : $microPayResult['return_msg'], "21000");
}【相關(guān)推薦】
2.?分享微信公眾號(hào)開發(fā)刷卡支付的實(shí)例教程
4.?詳解微信小程序支付功能開發(fā)錯(cuò)誤總結(jié)
The above is the detailed content of Detailed explanation of credit card payment examples for WeChat payment development. For more information, please follow other related articles on the PHP Chinese website!
Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Hot AI Tools
Undress AI Tool
Undress images for free
Undresser.AI Undress
AI-powered app for creating realistic nude photos
AI Clothes Remover
Online AI tool for removing clothes from photos.
Clothoff.io
AI clothes remover
Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!
Hot Article
Grass Wonder Build Guide | Uma Musume Pretty Derby
3 weeks ago
By Jack chen
Roblox: 99 Nights In The Forest - All Badges And How To Unlock Them
3 weeks ago
By DDD
Uma Musume Pretty Derby Banner Schedule (July 2025)
4 weeks ago
By Jack chen
Today's Connections hint and answer 3rd July for 753
1 months ago
By Jack chen
Windows Security is blank or not showing options
4 weeks ago
By 下次還敢
Hot Tools
Notepad++7.3.1
Easy-to-use and free code editor
SublimeText3 Chinese version
Chinese version, very easy to use
Zend Studio 13.0.1
Powerful PHP integrated development environment
Dreamweaver CS6
Visual web development tools
SublimeText3 Mac version
God-level code editing software (SublimeText3)
