README

为 Omnipay League 提供的 MoMo 支付驱动程序。

关于 Omnipay 网关的介绍，请参阅 此处 以获取参考

安装

通过 Composer

composer require gemfourmedia/omnipay-momo

用法

初始化

请阅读 MoMo 文档 此处

use Omnipay\Omnipay;

$gateway = Omnipay::create('MoMo');
$gateway->initialize([
    'accessKey' => 'Provided by MoMo',
    'partnerCode' => 'Provided by MoMo',
    'secretKey' => 'Provided by MoMo',
]);

购买请求

$response = $gateway->purchase([
    'amount' => 20000,
    'redirectUrl' => 'https://yourdomain.com/payment-success',
    'ipnUrl' => 'https://yourdomain.com/ipn',
    'orderId' => 'unique id', // eg: 9
    'requestType' => 'captureWallet', // captureWallet|payWithATM|payWithCC
    'lang' => 'vi', // vi|en
    'orderInfo' => '',
    'requestId' => (string) \Str::uuid(), // eg: da584fe0-0fe3-47c6-ad20-19ad3e050140
    'extraData' => base64_encode(json_encode([])),
])->send();

if ($response->isRedirect()) {
    $redirectUrl = $response->getRedirectUrl();
    
    // TODO: Redirect to MoMo Payment page
}

更多参数，请参阅 此处。

完成购买（处理 MoMo 将您重定向回您站点的响应数据）

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

if ($response->isSuccessful()) {
    print $response->amount;
    print $response->orderId;
    
    var_dump($response->getData());
    
} else {

    print $response->getMessage();
}

更多参数，请参阅 此处。

MoMo IPN（即时支付通知）处理程序

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

if ($response->isSuccessful()) {
    
    print $response->amount;
    print $response->orderId;
    
    // Get all MoMo respone data.
    var_dump($response->getData()); 
    
} else {

    print $response->getMessage();
}

更多响应参数，请参阅 此处。

查询交易（检查交易状态）

$response = $gateway->queryTransaction([
    'orderId' => '9',
    'requestId' => 'da584fe0-0fe3-47c6-ad20-19ad3e050140',
    'lang' => 'vi',
])->send();

if ($response->isSuccessful()) {
    // TODO: handle result.
    print $response->amount;
    print $response->orderId;
    
    var_dump($response->getData()); // All momo response data
    
} else {

    print $response->getMessage();
}

更多参数，请参阅 此处。

退款

$response = $gateway->refund([
    'orderId' => 'refund-10', //Note: orderId (new) of the refund transaction which must be different from orderId of the original purchase transaction
    'requestId' => '1f60e60a-a78c-45c0-b6da-94d1855157ae',
    'amount' => 2100,
    'transId' => 2842402931,
    'lang' => 'vi',
    'description' => 'Example refund 10',
])->send();

if ($response->isSuccessful()) {
    var_dump($response->getData());
    
} else {

    print $response->getMessage();
}

更多响应参数，请参阅 此处。

查询退款状态

$response = $gateway->queryRefund([
    'orderId' => 'refund-10',
    'requestId' => '1f60e60a-a78c-45c0-b6da-94d1855157ae',
    'lang' => 'vi',
])->send();

if ($response->isSuccessful()) {
    
    var_dump($response->getData());
    
} else {

    print $response->getMessage();
}

更多响应参数，请参阅 此处。

调试

    print $response->getCode(); // Get result code from MoMo.
    print $response->getMessage(); // Get message .

结果代码参考 getCode()，请阅读 此处。