运行以下命令
composer require gjae/laravel-mercadopago
在您的config/app.php
文件中添加以下行(仅适用于 LARAVEL 版本 <= 5.4):
在您的服务提供商数组(providers)中:
Gjae MercadoPago MPServiceProvider::class,
将以下外观添加到您的别名列表中(仅适用于 LARAVEL 版本 <= 5.4):
' MercadoPago ' => Gjae MercadoPago Facade::class,
最后运行以下命令:
php artisan vendor:publish -- provider ="Gjae MercadoPago MPServiceProvider "
最后运行迁移:
php artisan migrate
现在转到config/mercadopago.php
文件并添加您的配置,您的文件将类似于以下内容:
<?php
return [
/**
* Si es verdadero entonces no se validan las credenciales
* en mercadopago
*/
' local_debug ' => true ,
/**
* Especifica el modo en el que se estara usando
* el mercado pago, : sandbox, production
*/
' mode ' => ' sandbox ' ,
/**
* Credenciales para el caso en que la aplicacion este en modo
* produccion (especificado en la clave mode)
*/
' production ' => [
' access_token ' => env ( ' MP_ACCESS_TOKEN ' , '' ),
' public_key ' => env ( ' MP_PUBLIC_KEY ' , '' ),
],
/**
* Credenciales para el modo sandbox
* especificado el uso en la clave "mode"
*/
' sandbox ' => [
' access_token ' => env ( ' MP_SANDBOX_ACCESS_TOKEN ' , '' ),
' public_key ' => env ( ' MP_SANDBOX_PUBLIC_KEY ' , '' )
],
/**
* Tipo de identificacion usada para los pagos
*/
' identification_type ' => ' DNI ' ,
/**
* Codigo de area telefonico
*/
' area_code ' => '' ,
/**
* Especifica las URL de retorno para el smartcheckout
*/
' back_urls ' => [
' success ' => '' ,
' failure ' => '' ,
' pending ' => '' ,
],
// Indica en que caso de respuesta del pago se ejecutara una autorecarga
// Por defecto: approved (el usuario pagador volvera automaticamente en caso de que el pago haya sido completado y aprobado)
' auto_return ' => ' approved ' ,
];
要开始使用该库,您只需要调用 MercadoPago 外观(或者您在config.php
文件的别名排列中命名的任何名称),调用 begin 方法,该方法具有作为参数的回调函数,该回调函数将接收交易本身作为参数,示例:
MercadoPago:: begin ( function ( $ mp ){
// agrega un item al procesamiento
$ mp -> addItem ([
' title ' => ' Prueba ' , // Titulo del item
' qtty ' => 1 , // Cantidad del item
' price ' => 150.0 , // Precio unitario
' currency ' => ' USD ' , // MONEDA USADA PARA PAGAR
' id ' => " MYAWESOMEPRODUCTID " // ID DEL PRODUCTO (PARA CONTROL INTERNO DE SU APLICACIÓN)
]);
// OPCIONAL: el metodo backUrlAddQS agregara parametros adicionales a la URL de pago, dichos parametros seran devueltos al completar la transaccipon
// usado para control interno de su propia aplicación, si desea agregar un token o ID de seguridad a su proceso
$ mp -> backUrlAddQS ([ ' foo ' => " bar " ]);
});
您可以根据需要多次调用 addItem 方法,以将需要收取费用的项目添加到付款中。最后,在您的回复视图中
MercadoPago 外观的 initPoint 方法将可用(视图代码示例):
<!DOCTYPE html >
< html lang =" en " >
< head >
< meta charset =" UTF-8 " >
< meta name =" viewport " content =" width=device-width, initial-scale=1.0 " >
< meta http-equiv =" X-UA-Compatible " content =" ie=edge " >
< title > Redirigiendo a MercadoPago para procesar su compra </ title >
</ head >
< body >
< input type =" hidden " name =" redirect-mp " id =" mp " value =" {{ MercadoPago::initPoint() }} " >
< script >
window . location = document . getElementById ( 'mp' ) . value
</ script >
</ body >
</ html >
支付网关返回的响应必须通过其路由进行控制并添加到配置文件 ( config/mercadopago.php
)。
在与响应关联的路由中(在配置文件中配置),调用MPResponse类并使用依赖注入来处理响应,例如:
<?php
. . .
use Gjae MercadoPago Contracts MPResponse ;
class MercadoPagoController extends Controller
{
public function successResponse ( MPResponse $ request )
{
. . .
}
}
注入的 MPResponse 对象将自动为您保存响应数据。
此外,您可以将模型与事务相关联,为此,您必须转到 Eloquent 模型类并实现包中包含的 HasTransaction 接口和 HasTransactions 特征:
namespace App ;
. . .
use Illuminate Database Eloquent Model ;
use Gjae MercadoPago Contracts HasTransaction ;
use Gjae MercadoPago Traits HasTransactions ;
class MyAwesomeModel extends Model implements HasTransaction{
use HasTransactions;
. . .
}
完成此操作后,您可以将实现 HasTransaction 接口的任何类的对象(或对象数组)作为第二个参数传递给 begin 函数:
MercadoPago:: begin ( function ( $ mp ){
. . .
}, [ $ HasTransactionObjects ]);
实现HasTransaction
接口和HasTransactions
特征的对象具有事务扩展,该扩展返回与所述对象相关的事务集合:
$ user = App User:: first ();
$ user -> transactions ;
注入控制器的 MPResponse 对象具有 getTransaction 方法,该方法返回接收到的事务的数据
public function successResponse ( MPResponse $ request )
{
$ transaction = $ request -> getTransaction ();
}
当配置文件的“local_debug”选项设置为true时;不会随 Mercadopago URL 一起发出 init_point,这样用户就不会创建不会在网关内执行的交易,并且可以平静地测试操作,而无需等待 Mercadopago 服务器的响应。准备测试完整操作,无论是在生产还是在沙箱模式下,请将此选项更改为 false。