README

Omnipay: VNPay

信息

支持集成VNPay支付网关的库，基于Omnipay League平台开发。

有关Omnipay网关的概念和使用方法，请访问这里进行了解。

安装

通过Composer安装Omnipay VNPay

composer require phpviet/omnipay-vnpay

使用方法

集成于当前流行的各种框架中

• Laravel
• Symfony
• Yii

如果您想在不依赖框架的情况下使用，请继续阅读。

初始化网关

use Omnipay\Omnipay;

$gateway = Omnipay::create('VNPay');
$gateway->initialize([
    'vnp_TmnCode' => 'Do VNPay cấp',
    'vnp_HashSecret' => 'Do VNPay cấp',
]);

上面的网关用于向VNPay发送处理请求，或用于接收VNPay发送的请求。

创建支付请求

$response = $gateway->purchase([
    'vnp_TxnRef' => time(),
    'vnp_OrderType' => 100000,
    'vnp_OrderInfo' => time(),
    'vnp_IpAddr' => '127.0.0.1',
    'vnp_Amount' => 1000000,
    'vnp_ReturnUrl' => 'https://github.com/phpviet',
])->send();

if ($response->isRedirect()) {
    $redirectUrl = $response->getRedirectUrl();
    
    // TODO: chuyển khách sang trang VNPay để thanh toán
}

有关创建请求和VNPay返回的值，请参考这里。

检查返回的vnp_ReturnUrl信息

$response = $gateway->completePurchase()->send();

if ($response->isSuccessful()) {
    // TODO: xử lý kết quả và hiển thị.
    print $response->vnp_Amount;
    print $response->vnp_TxnRef;
    
    var_dump($response->getData()); // toàn bộ data do VNPay gửi sang.
    
} else {

    print $response->getMessage();
}

有关VNPay返回的值，请参考这里。

检查由VNPay发送的IPN信息

$response = $gateway->notification()->send();

if ($response->isSuccessful()) {
    // TODO: xử lý kết quả.
    print $response->vnp_Amount;
    print $response->vnp_TxnRef;
    
    var_dump($response->getData()); // toàn bộ data do VNPay gửi sang.
    
} else {

    print $response->getMessage();
}

有关VNPay发送的值，请参考这里。

检查交易状态

$response = $gateway->queryTransaction([
    'vnp_TransDate' => 20190705151126,
    'vnp_TxnRef' => 1562314234,
    'vnp_OrderInfo' => time(),
    'vnp_IpAddr' => '127.0.0.1',
    'vnp_TransactionNo' => 496558,
])->send();

if ($response->isSuccessful()) {
    // TODO: xử lý kết quả và hiển thị.
    print $response->getTransactionId();
    print $response->getTransactionReference();
    
    var_dump($response->getData()); // toàn bộ data do VNPay gửi về.
    
} else {

    print $response->getMessage();
}

有关创建请求和VNPay返回的值，请参考这里。

退款请求

$response = $gateway->refund([
    'vnp_Amount' => 10000,
    'vnp_TransactionType' => '03',
    'vnp_TransDate' => 20190705151126,
    'vnp_TxnRef' => 32321,
    'vnp_OrderInfo' => time(),
    'vnp_IpAddr' => '127.0.0.1',
    'vnp_TransactionNo' => 496558,
])->send();

if ($response->isSuccessful()) {
    // TODO: xử lý kết quả và hiển thị.
    print $response->getTransactionId();
    print $response->getTransactionReference();
    
    var_dump($response->getData()); // toàn bộ data do VNPay gửi về.
    
} else {

    print $response->getMessage();
}

有关创建请求和VNPay返回的值，请参考这里。

针对开发者

如果您觉得我们的库存在不足或错误，并希望为共同发展做出贡献，我们非常欢迎！请创建issue来提出下一版本的想法，或创建PR来补充不足或错误。对于安全相关的问题，请通过vuongxuongminh@gmail.com发送电子邮件，而不是创建issue。谢谢！