mercadopago-sdk-php
![Software License][ico-license]
![Coverage Status][ico-scrutinizer]
![Total Downloads][ico-downloads], (*1)
, (*2)
Install
Via Composer, (*3)
``` bash
$ composer require fedeisas/mercadopago-sdk-php, (*4)
Or as a dependency in your project's composer.json:
```json
{
"require": {
"fedeisas/mercadopago-sdk-php": "1.0"
}
}
, (*5)
Basic checkout
- Get your CLIENT_ID and CLIENT_SECRET in the following address:
use MercadoPago\MercadoPago;
use MercadoPago\Http\GuzzleClient;
$mp = new MercadoPago(new GuzzleClient());
$mp->setCredentials('CLIENT_ID', 'CLIENT_SECRET');
Preferences
Get an existent Checkout preference
$preference = $mp->getPreference('PREFERENCE_ID');
var_dump($preference);
Create a Checkout preference
$preference_data = [
'items' => [
[
'title' => 'Test',
'quantity' => 1,
'currency_id' => 'USD',
'unit_price' => 10.4,
]
]
];
$preference = $mp->createPreference($preference_data);
var_dump($preference);
Update an existent Checkout preference
$preference_data = [
'items' => [
[
'title' => 'Test Modified',
'quantity' => 1,
'currency_id' => 'USD',
'unit_price' => 20.4,
]
]
];
$preference = $mp->updatePreference('PREFERENCE_ID', $preference_data);
var_dump($preference);
Payments/Collections
Search for payments
$filters = [
'id' => null,
'site_id' => null,
'external_reference' => null,
];
$searchResult = $mp->searchPayments($filters);
var_dump($searchResult);
Get payment data
use MercadoPago\MercadoPago;
use MercadoPago\Http\GuzzleClient;
$mp = new MercadoPago(new GuzzleClient());
$mp->setCredentials('CLIENT_ID', 'CLIENT_SECRET');
$paymentInfo = $mp->getPayment('PAYMENT_ID');
var_dump($paymentInfo);
Cancel (only for pending payments)
$result = $mp->cancelPayment('PAYMENT_ID');
var_dump($result);
Refund (only for accredited payments)
$result = $mp->refundPayment('PAYMENT_ID');
var_dump($result);
, (*6)
Customized checkout
Use an access token:, (*7)
use MercadoPago\MercadoPago;
use MercadoPago\Http\GuzzleClient;
$mp = new MercadoPago(new GuzzleClient());
$mp->setAccessToken('SOME_ACCESS_TOKEN');
Create payment
$mp->getClient()->post(
'/v1/payments',
$paymentData,
['access_token' => 'SOME_ACCESS_TOKEN']
);
Create customer
$mp->getClient()->post(
'/v1/customers',
['email' => 'email@test.com'],
['access_token' => 'SOME_ACCESS_TOKEN']
);
Get customer
$mp->getClient()->get(
'/v1/customers/CUSTOMER_ID',
[],
['access_token' => 'SOME_ACCESS_TOKEN']
);
- View more Custom checkout related APIs in Developers Site
Testing
bash
$ composer test
, (*8)
Contributing
Please see CONTRIBUTING and CONDUCT for details., (*9)
Security
If you discover any security related issues, please email federicoisas@gmail.com instead of using the issue tracker., (*10)
Credits
License
The MIT License (MIT). Please see License File for more information., (*11)