Introdução

O objetivo desta SDK é proporcionar agilidade no processo de desenvolvimento e comunicação com as APIs de pagamento, preferências e notificações.

Instalação

Instale a biblioteca utilizando o seguinte comando:

composer require mp-plugins/php-sdk

Com uma versão específica:

composer require mp-plugins/php-sdk 1.4.0

Consultando versões da SDK

Para consultar as versões disponíveis basta acesssar o seguinte link.

Configuração

Para incluir a biblioteca em seu projeto, basta fazer o seguinte:

<?php
require('vendor/autoload.php');

$sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId' );

Criando um pagamento

<?php
require('vendor/autoload.php');

$sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId' );

$payment = $sdk->getPaymentInstance();

$payment->token = "034215d05985b328683ec816607b2a5d";
$payment->transaction_amount = 230;
$payment->description = "Ergonomic Silk Shirt";
$payment->installments = 1;
$payment->payment_method_id = "master";
$payment->payer->email = "test_user_98934401@testuser.com";
.
.
.

$payment->save();

Criando uma preferência

<?php
require('vendor/autoload.php');

$sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId' );

$preference = $sdk->getPreferenceInstance();

$items = ["items" =>  
            [
                "title" => "Dummy Title",
                "description" => "Dummy description",
                "picture_url" => "http://www.myapp.com/myimage.jpg",
                "category_id" => "car_electronics",
                "quantity" => 1,
                "currency_id" => "BRL",
                "unit_price" => 10.5
            ]
        ];

$preference->items = $items;
$preference->notification_url = "notification_url";
$preference->external_reference = "external_reference";

$preference->save();

Consultando uma notificação

O parâmetro para consulta deve seguir o modelo abaixo:

P-{idPayment}

<?php
require('vendor/autoload.php');

$sdk = new Sdk( 'accessToken', 'platformId', 'productId', 'integratorId' );

$notification = $sdk->getNotificationInstance();

$notification->read(array("id" => "P-1316643861"));