README

This library extend API entrypoints of mercadopago/dx-php, like Instore V2, Qr Tramma, and Store Client.

Installation

composer require reyesoft/mercadopago

Usage

Usage it's the same of mercadopago/dx-php, but with some new features and extensions. Like...

Creating and handling a Pos

MercadoPagoConfig::setAccessToken('YOUR_ACCESS_TOKEN']); $store = (new StoreClient())->create( $params->getUserId(), [ 'name' => 'Reyesoft Point', 'business_hours' => [ 'wednesday' => [ [ 'open' => '00:00', 'close' => '23:59', ], ], ], 'external_id' => 'your_store_external_id', 'location' => [ 'street_number' => '3039', 'street_name' => 'Caseros', 'city_name' => 'Belgrano', 'state_name' => 'Capital Federal', 'latitude' => -32.8897322, 'longitude' => -68.8443275, 'reference' => '3er Piso', ], ] );

You can get MercadoPago credentials from https://www.mercadopago.com/mla/account/credentials

Showing a Point Of Sale QR

$pos = new MercadoPagoPos('your_pos_external_id'); $qr_content = $pos->getQrContent(); // just an example, this is Endroid\QrCode library $qr_code = new QrCode($qr_content); $qr_code->setText($qr_content); echo $qr_code->getDataUri();

Putting a order in a Point Of Sale

(new InstoreOrderV2())->create( 'your_mercadopago_user_id', 'your_store_external_id', 'your_pos_external_id', [ 'external_reference' => '#' . $your_order_id, 'title' => 'Order ' . $your_order_id, 'description' => 'Your proyects', 'notification_url' => 'https://yourserver.com/endpoint', 'total_amount' => 100.10, 'expiration_date' => today()->addDays(7)->format('Y-m-d\TH:i:s.vP'), 'items' => [ [ 'title' => 'Your lovely product', 'id' => '#' . $your_order_id, 'external_reference' => '#' . $your_order_id, 'quantity' => 1, 'unit_measure' => 'unit', 'currency_id' => 'ARS', 'unit_price' => 100.10, 'total_amount' => 100.10, 'picture_url' => 'https://yourserver.com/image.jpg', ], ], ] );

Images

docker run -it --rm --name php82 -e PHP_EXTENSIONS="" -v "$PWD":/usr/src/app pablorsk/laravel-json-api:8.2 bash