WeChat 결제 개발을 위한 신용카드 결제 예시에 대한 자세한 설명
- 零下一度원래의
- 2018-05-12 10:32:235845검색
이 글에서는 위챗페이의 카드결제 개발과정을 소개합니다. 위챗 카드 결제는 사용자가 위챗 지갑의 카드 스와이프 인터페이스를 열고, 판매자가 QR 코드를 스캔해 결제를 제출해 결제를 완료하는 결제 프로세스를 의미합니다.
1. 카드결제 API
인터페이스 주소
api.mch.weixin.qq.com/pay/micropay
인증서가 필요합니까?
아니요 .
입력 매개변수
이름 변수 이름 필수 유형 예시 값 설명
| 공개 계정 ID | appid | is | String(32) | wx88888888888888888WeChat에서 할당한 공용 계정 ID(법인 번호 corpid는 이 appId입니다) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 가맹점 번호 | mch_id | 예 | 문자열(32) | 1900000109 | WeChat 결제로 할당된 판매자 번호 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 장치 번호 | device_info | No | String(32) | 013467007045764 | 단말 장치 아니요. (매장 번호 등 판매자가 맞춤 설정) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 임의의 문자열 | nonce_str | 예 | 문자열(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 32비트 이하의 임의 문자열입니다. 권장 난수 생성 알고리즘 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 서명 | sign | is | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 서명, 자세한 내용은 서명 생성 알고리즘 참조 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 제품 설명 | 본문 | 예 | String(128) | image image store-Shenzhen Tengda-QQ 인형 | 제품에 대한 간략한 설명 이 필드는 엄격하게 전달되어야 합니다. 사양에 따라 세부정보를 입력하세요. 매개변수 규정을 참조하세요. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 제품 세부정보 | 세부정보 | 아니요 | 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":"苹果手机"
},
{
"goods_id":"iphone6s_32G",
"wxpay_goods_id":"1002",
"goods_name":"iPhone6s 32G",
"quantity":1,
"price":608800,
"goods_category":"123789",
"body":"苹果手机"
}
]
} |
└ products_id String 필수 32 제품번호 └ wxpay_goods_id String 선택 32 WeChat 결제에 의해 정의된 통합 제품 번호 └ products_name String 필수 256 제품 이름 └ products_num Int 필수 제품 수량 └ Price Int 필수 제품 단가(센트) └ products_category String Optional 32 제품 카테고리 ID └ body String Yes 1000 제품 설명 정보 선택 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 추가 데이터 | 첨부 | 아니요 | 문자열(127 ) | 설명 | 추가 데이터는 쿼리 API 및 결제 알림에 그대로 반환됩니다. 이 필드는 주로 판매자가 주문에 대한 사용자 정의 데이터를 전달하는 데 사용됩니다. | 판매자 주문 number | out_trade_no | 예 | String(32) | 1217752501201407033233368018 | 판매자 시스템 내의 주문 번호 32자 이내의 문자를 포함할 수 있습니다. 기타 지침은 판매자 주문 번호를 참조하세요. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 제품 세부정보 | 세부정보 | 아니요 | String(8192) | 제출된 데이터와 일치 | 실제 제출된 반환 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 주문 금액 | total_fee | 예 | Int | 888 | 총 주문 금액, 단위는 다음과 같습니다. 센트, 정수만 가능합니다. 결제 금액을 확인하세요. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 통화 유형 | fee_type | 아니요 | 문자열(16) | CNY | ISO4217 표준을 준수하는 3자리 코드입니다. 기본값은 RMB: CNY입니다. 다른 값 목록은 통화 유형을 참조하세요. td> tr> | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 단말기 IP | spbill_create_ip | 는 | String(16) | 8.8. 8.8 | WeChat 결제 API를 호출하는 기계 IP | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 상품 태그 | goods_tag | 아니요 | String(32) | 제품 태그, 상품권 또는 즉시 할인 기능의 매개변수, 자세한 내용은 상품권 또는 즉시 할인 할인을 참조하세요 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 결제 방법 지정 | limit_pay | No | String(32) | no_credit | no_credit --신용카드 결제를 사용할 수 없도록 지정 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 인증 코드 | auth_code | 예 | String(128) | 120061098828009406 | 결제 승인 코드를 스캔하면 장치가 사용자의 WeChat에 있는 바코드 또는 QR 코드 정보를 읽습니다. |
<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>참고: 매개변수 값은 XML로 이스케이프될 수 있습니다. CDATA 태그는 XML 파서가 데이터를 구문 분석하지 않음을 나타내는 데 사용됩니다.
| 返回状态码 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断 |
| 返回信息 | return_msg | 否 | String(128) | 签名失败 | 返回信息，如非空，为错误原因 签名失败 参数格式校验错误 |
当return_code为SUCCESS的时候，还会包括以下字段：
名称 变量名 必填 类型 示例值 描述
| 公众账号ID | appid | 是 | String(32) | wx8888888888888888 | 调用接口提交的公众账号ID |
| 商户号 | mch_id | 是 | String(32) | 1900000109 | 调用接口提交的商户号 |
| 设备号 | device_info | 否 | String(32) | 013467007045764 | 调用接口提交的终端设备号， |
| 随机字符串 | nonce_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 微信返回的随机字符串 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 微信返回的签名，详见签名生成算法 |
| 业务结果 | result_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
| 错误代码 | err_code | 否 | String(32) | SYSTEMERROR | 详细参见错误列表 |
| 错误代码描述 | err_code_des | 否 | String(128) | 系统错误 | 错误返回的信息描述 |
当return_code 和result_code都为SUCCESS的时，还会包括以下字段：
名称 变量名 必填 类型 示例值 描述
| 用户标识 | openid | 是 | String(128) | Y | 用户在商户appid 下的唯一标识 |
| 是否关注公众账号 | is_subscribe | 是 | String(1) | Y | 用户是否关注公众账号，仅在公众账号类型支付有效，取值范围：Y或N;Y-关注;N-未关注 |
| 交易类型 | trade_type | 是 | String(16) | MICROPAY | 支付类型为MICROPAY(即扫码支付) |
| 付款银行 | bank_type | 是 | String(16) | CMC | 银行类型，采用字符串类型的银行标识，值列表详见银行类型 |
| 货币类型 | fee_type | 否 | String(16) | CNY | 符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型 |
| 订单金额 | total_fee | 是 | Int | 888 | 订单总金额，单位为分，只能为整数，详见支付金额 |
| 现金支付货币类型 | cash_fee_type | 否 | String(16) | CNY | 符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型 |
| 现金支付金额 | cash_fee | 是 | Int | 100 | 订单现金支付金额，详见支付金额 |
| 微信支付订单号 | transaction_id | 是 | String(32) | 1217752501201407033233368018 | 微信支付订单号 |
| 商户订单号 | out_trade_no | 是 | String(32) | 1217752501201407033233368018 | 商户系统的订单号，与请求一致。 |
| 商家数据包 | attach | 否 | String(128) | 123456 | 商家数据包，原样返回 |
| 支付完成时间 | time_end | 是 | String(14) | 20141030133525 | 订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。详见时间规则 |
举例如下：
<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>
二、刷卡支付类实现
在微信支付原来的微信支付类文件中，仿照统一支付类的方式，添加刷卡支付类如下：
/**
* 刷卡支付接口类
*/
class MicroPay_pub extends Wxpay_client_pub
{
function __construct()
{
//设置接口链接
$this->url = "https://api.mch.weixin.qq.com/pay/micropay";
//设置curl超时时间
$this->curl_timeout = WxPayConf_pub::CURL_TIMEOUT;
}
/**
* 生成接口参数xml
*/
function createXml()
{
try
{
//检测必填参数
if($this->parameters["out_trade_no"] == null){
throw new SDKRuntimeException("缺少统一支付接口必填参数out_trade_no！"."<br>");
}elseif($this->parameters["body"] == null){
throw new SDKRuntimeException("缺少统一支付接口必填参数body！"."<br>");
}elseif ($this->parameters["total_fee"] == null ) {
throw new SDKRuntimeException("缺少统一支付接口必填参数total_fee！"."<br>");
}elseif ($this->parameters["auth_code"] == null) {
throw new SDKRuntimeException("缺少统一支付接口必填参数auth_code！"."<br>");
}
$this->parameters["appid"] = WxPayConf_pub::APPID;//公众账号ID
$this->parameters["mch_id"] = WxPayConf_pub::MCHID;//商户号
$this->parameters["spbill_create_ip"] = $_SERVER['REMOTE_ADDR'];//终端ip
$this->parameters["nonce_str"] = $this->createNoncestr();//随机字符串
$this->parameters["sign"] = $this->getSign($this->parameters);//签名
// var_dump($this->parameters);
return $this->arrayToXml($this->parameters);
}catch (SDKRuntimeException $e)
{
die($e->errorMessage());
}
}
}原有的基础类和请求类也列出如下：
/**
* 所有接口的基类
*/
class Common_util_pub
{
function __construct() {
}
function trimString($value)
{
$ret = null;
if (null != $value)
{
$ret = $value;
if (strlen($ret) == 0)
{
$ret = null;
}
}
return $ret;
}
/**
* 作用：产生随机字符串，不长于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;
}
/**
* 作用：格式化参数，签名过程需要使用
*/
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;
}
//签名步骤一：按字典序排序参数
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>";
//签名步骤四：所有字符转为大写
$result_ = strtoupper($String);
//echo "【result】 ".$result_."</br>";
return $result_;
}
/**
* 作用：array转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转为array
*/
public function xmlToArray($xml)
{
//将XML转为array
$array_data = json_decode(json_encode(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
return $array_data;
}
/**
* 作用：以post方式提交xml到对应的接口url
*/
public function postXmlCurl($xml,$url,$second=30)
{
//初始化curl
$ch = curl_init();
//设置超时
curl_setopt($ch, CURLOP_TIMEOUT, $second);
//这里设置代理，如果有的话
//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);
//设置header
curl_setopt($ch, CURLOPT_HEADER, FALSE);
//要求结果为字符串且输出到屏幕上
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
//post提交方式
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
//运行curl
$data = curl_exec($ch);
curl_close($ch);
//返回结果
if($data)
{
curl_close($ch);
return $data;
}
else
{
$error = curl_errno($ch);
echo "curl出错，错误码:$error"."<br>";
echo "<a href='http://curl.haxx.se/libcurl/c/libcurl-errors.html'>错误原因查询</a></br>";
curl_close($ch);
return false;
}
}
/**
* 作用：使用证书，以post方式提交xml到对应的接口url
*/
function postXmlSSLCurl($xml,$url,$second=30)
{
$ch = curl_init();
//超时时间
curl_setopt($ch,CURLOPT_TIMEOUT,$second);
//这里设置代理，如果有的话
//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);
//设置header
curl_setopt($ch,CURLOPT_HEADER,FALSE);
//要求结果为字符串且输出到屏幕上
curl_setopt($ch,CURLOPT_RETURNTRANSFER,TRUE);
//设置证书
//使用证书：cert 与 key 分别属于两个.pem文件
//默认格式为PEM，可以注释
curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM');
curl_setopt($ch,CURLOPT_SSLCERT, dirname(__FILE__).WxPayConf_pub::SSLCERT_PATH);
//默认格式为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);
//返回结果
if($data){
curl_close($ch);
return $data;
}
else {
$error = curl_errno($ch);
echo "curl出错，错误码:$error"."<br>";
echo "<a href='http://curl.haxx.se/libcurl/c/libcurl-errors.html'>错误原因查询</a></br>";
curl_close($ch);
return false;
}
}
/**
* 作用：打印数组
*/
function printErr($wording='',$err='')
{
print_r('<pre class="brush:php;toolbar:false">');
echo $wording."</br>";
var_dump($err);
print_r('');
}
}
/**
* 请求型接口的基类
*/
class Wxpay_client_pub extends Common_util_pub
{
var $parameters;//请求参数，类型为关联数组
public $response;//微信返回的响应
public $result;//返回参数，类型为关联数组
var $url;//接口链接
var $curl_timeout;//curl超时时间
/**
* 作用：设置请求参数
*/
function setParameter($parameter, $parameterValue)
{
$this->parameters[$this->trimString($parameter)] = $this->trimString($parameterValue);
}
/**
* 作用：设置标配的请求参数，生成签名，生成接口参数xml
*/
function createXml()
{
$this->parameters["appid"] = WxPayConf_pub::APPID;//公众账号ID
$this->parameters["mch_id"] = WxPayConf_pub::MCHID;//商户号
$this->parameters["nonce_str"] = $this->createNoncestr();//随机字符串
$this->parameters["sign"] = $this->getSign($this->parameters);//签名
return $this->arrayToXml($this->parameters);
}
/**
* 作用：post请求xml
*/
function postXml()
{
$xml = $this->createXml();
$this->response = $this->postXmlCurl($xml,$this->url,$this->curl_timeout);
return $this->response;
}
/**
* 作用：使用证书post请求xml
*/
function postXmlSSL()
{
$xml = $this->createXml();
$this->response = $this->postXmlSSLCurl($xml,$this->url,$this->curl_timeout);
return $this->response;
}
/**
* 作用：获取结果，默认不使用证书
*/
function getResult()
{
$this->postXml();
$this->result = $this->xmlToArray($this->response);
return $this->result;
}
}三、发起支付
在程序中，获得用户的授权码，并填入到$authcode参数中。授权码就是条码上的那一串18位纯数字，以10、11、12、13、14、15开头
其他参数则自动生成或者手动输入指定。
调用函数如下所示
//全局引入微信支付类
Vendor('Wxpay.WxPayPubHelper.WxPayPubHelper');
//使用统一支付接口
$microPay = new \MicroPay_pub();
//设置统一支付接口参数
$microPay->setParameter("body","方倍商户刷卡支付");//商品描述
$microPay->setParameter("out_trade_no", "$out_trade_no");//商户订单号
$microPay->setParameter("total_fee", $total_fee);//总金额
$microPay->setParameter("auth_code", $authcode);//授权码
//获取统一支付接口结果
$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");
}【相关推荐】
1. 微信公众号平台源码下载
3. 微信开发之微信支付
위 내용은 WeChat 결제 개발을 위한 신용카드 결제 예시에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!
성명：
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
이전 기사：WeChat 개발을 위한 WeChat 결제다음 기사：WeChat 개발을 위한 WeChat 결제