laravel mercadopago
1.0.0
Execute o seguinte comando
composer require gjae/laravel-mercadopago No seu arquivo config/app.php adicione as seguintes linhas (SOMENTE PARA VERSÕES LARAVEL <= 5.4):
na sua matriz de provedores de serviços ( provedores ):
Gjae MercadoPago MPServiceProvider::class, adicione a seguinte fachada à sua lista de aliases (SOMENTE PARA VERSÕES LARAVEL <= 5.4):
' MercadoPago ' => Gjae MercadoPago Facade::class,finalmente execute o seguinte comando:
php artisan vendor:publish -- provider ="Gjae MercadoPago MPServiceProvider "E finalmente execute as migrações:
php artisan migrate Agora acesse o arquivo config/mercadopago.php e adicione sua configuração, seu arquivo ficará semelhante a este:
<?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 ' ,
]; Para começar a usar a biblioteca você só precisa chamar a fachada do MercadoPago (ou o nome que você deu na disposição dos aliases do seu arquivo config.php ), chamando o método begin que tem como parâmetro uma função de callback que receberá a própria transação como parâmetro, exemplo:
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 " ]);
}); O método addItem pode ser chamado quantas vezes você considerar necessário para adicionar os itens que deseja cobrar no pagamento. Finalmente, na sua visualização de resposta
Estará disponível o método initPoint da fachada do MercadoPago (exemplo de código de view):
<!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 > As respostas retornadas pelo gateway de pagamento devem ser controladas a partir de suas rotas e adicionadas ao arquivo de configuração ( config/mercadopago.php ).
Nas rotas associadas à resposta (configuradas no arquivo de configuração), chame a classe MPResponse e utilize injeção de dependência para processar a resposta, exemplo:
<?php
. . .
use Gjae MercadoPago Contracts MPResponse ;
class MercadoPagoController extends Controller
{
public function successResponse ( MPResponse $ request )
{
. . .
}
}O objeto MPResponse injetado salvará automaticamente os dados de resposta para você.
Além disso você pode associar modelos à sua transação, para isso você deve ir até sua classe de modelo Eloquent e implementar a interface HasTransaction e a característica HasTransactions incluída no pacote:
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;
. . .
}Feito isso, você pode passar como segundo parâmetro para a função inicial, um objeto (ou array de objetos) de qualquer classe que implemente a interface HasTransaction:
MercadoPago:: begin ( function ( $ mp ){
. . .
}, [ $ HasTransactionObjects ]); Objetos que implementam a interface HasTransaction e o traço HasTransactions possuem a extensão transaction que retorna uma coleção de transações relacionadas ao referido objeto:
$ user = App User:: first ();
$ user -> transactions ; O objeto MPResponse que é injetado no controlador possui o método getTransaction que retorna os dados da transação recebida
public function successResponse ( MPResponse $ request )
{
$ transaction = $ request -> getTransaction ();
}Quando o arquivo de configuração tiver a opção "local_debug" definida como true; Não será emitido um init_point com a URL do Mercadopago, isso é para que o usuário não crie transações que não serão realizadas dentro do gateway e possa testar a operação com tranquilidade sem esperar respostas do servidor do Mercadopago sem necessidade, quando estiver pronto para testar a operação completa, seja no modo de produção ou no modo sandbox, altere esta opção para falso.
