次のコマンドを実行します
composer require gjae/laravel-mercadopago
config/app.php
ファイルに次の行を追加します (LARAVEL バージョン <= 5.4 の場合のみ)。
サービスプロバイダーの配列 (プロバイダー):
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 関数の 2 番目のパラメーターとして渡すことができます。
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 に設定されている場合。 init_point はメルカドパゴ URL では発行されません。これは、ユーザーがゲートウェイ内で実行されないトランザクションを作成せず、メルカドパゴ サーバーからの応答を必要なく待たずに落ち着いて操作をテストできるようにするためです。本番モードでもサンドボックス モードでも完全な操作をテストする準備ができている場合は、このオプションを false に変更します。