NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1636 most downloaded on Packagist
Mercado Pago PHP SDK
Latest stable
3.16.0
Last release 2 months ago
27 Aug 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
99 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
fix: correct credential-on-file network data by @luismeli10 in https://github.com/mercadopago/sdk-php/pull/658
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.15.0...3.16.0
network_data, expanded gateway network data, and automatic_payments.subscription.feat: add COF network data support + bump version to 3.15.0 by @barajas-d in https://github.com/mercadopago/sdk-php/pull/656
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.14.0...3.15.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
NetworkData and PointOfInteraction payment resourcesfeat(order): add 19 typed Request classes and dual array|OrderCreateRequest acceptance in create() by @barajas-d in https://github.com/mercadopago/sdk
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.13.0...3.14.0
create() (#639)Common\Address, Identification, Phone (#639)data key (Orders v2) and string paging totals in MPAutoPaginationGenerator (#639)prev_transaction_ref to previous_transaction_reference (#639)squizlabs/php_codesniffer to 4.0.4 (#651)Pin GitHub Actions to SHA for supply chain security by @luismeli10 in https://github.com/mercadopago/sdk-php/pull/638
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.12.1...3.13.0
MPApiException now has 12 specific subtypes per HTTP status codeMPRequestOptions gains optional maxRetries, retryOn, initialDelayMs, maxDelayMs and onRetry callbackDisbursementRefundClient::list(), AdvancedPaymentClient::update(), CustomerCard::update(), PaymentClient::update() (#645)Payment types (#642): firstTransaction, storage, transactionInitiator, referencetoleranceSeconds unit mismatch — ts header value compared in seconds against a millisecond clock (#647)constantTimeEquals RangeError on multibyte v1 hash (#647)Fix path traversal vulnerability in string-ID client methods by @luismeli10 in https://github.com/mercadopago/sdk-php/pull/633
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.12.0...3.12.1
Feature/orders cho pro by @luismeli10 in https://github.com/mercadopago/sdk-php/pull/624
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.11.3...3.12.0
Bump version to 3.12.0-beta.1
Bump version to 3.12.0-beta.1
fix(webhook): preserve data.id case in signature manifest by @danielalfarourrea in https://github.com/mercadopago/sdk-php/pull/621
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.11.2...3.11.3
Fix/preference metadata and webhook signature by @luismeli10 in https://github.com/mercadopago/sdk-php/pull/617
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.11.1...3.11.2
fix: remove deprecated curl_close() call for PHP 8.5 compatibility by @barajas-d in https://github.com/mercadopago/sdk-php/pull/615
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.11.0...3.11.1
feat(order): add prev_transaction_ref to StoredCredential DTO by @danielalfarourrea in https://github.com/mercadopago/sdk-php/pull/611
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.10.0...3.11.0
POST/GET/PUT /v1/advanced_payments).GET/POST /v1/advanced_payments/{id}/refunds, POST /v1/advanced_payments/{id}/disbursements/{id}/refunds).GET /v1/chargebacks).Add WebhookSignatureValidator utility by @danielalfarourrea in https://github.com/mercadopago/sdk-php/pull/597
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.9.2...3.10.0
Add inline documentation and API reference links by @danielalfarourrea in https://github.com/mercadopago/sdk-php/pull/598
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.9.1...3.9.2
Add PSE (Colombia) example to Orders by @danielalfarourrea in https://github.com/mercadopago/sdk-php/pull/596
Full Changelog: https://github.com/mercadopago/sdk-php/compare/v3.9.0...3.9.1
Feature/order fields by @luismeli10 in https://github.com/mercadopago/sdk-php/pull/581
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.8.0...v3.9.0
[FIX] README example by @cuaitz in https://github.com/mercadopago/sdk-php/pull/571
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.7.1...3.8.0
Fix: cards and addresses mapping in customer resource by @andreagostinho-meli in https://github.com/mercadopago/sdk-php/pull/572
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.7.0...3.7.1
3.7.1 in MercadoPagoConfig::$CURRENT_VERSIONaddresses and cards mapping in Customer resource[Feat] Adding orders fields by @aqudsilva in https://github.com/mercadopago/sdk-php/pull/570
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.6.0...3.7.0
Updated issue templates Added and updated fields and tests Updated SDK to version 3.6.0 Documentation improvements For full details, see the CHANGELOG
What's new in version 3.6.0
Updated issue templates Added and updated fields and tests Updated SDK to version 3.6.0 Documentation improvements For full details, see the CHANGELOG.md file.
3.6.0 in MercadoPagoConfig::$CURRENT_VERSION[Fix] Fixing duplicated 'x-idempotency-key' by @aqudsilva in https://github.com/mercadopago/sdk-php/pull/558
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.5.0...3.5.1
OrderClientUnitTest.gitignore to ignore .idea<!-- When releasing, duplicate the block below replacing X.Y.Z and date --> <!-- Example: ## [3.6.0] - 2025-08-27 -->
Enhancement: add notification url to create preference example by @andreagostinho-meli in https://github.com/mercadopago/sdk-php/pull/553
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.4.0...3.5.0
[Enhancement] Ajuste do serializer e adição dos campos faltantes em payments by @VickieAranha in https://github.com/mercadopago/sdk-php/pull/550
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.3.0...3.4.0
[Feature] Payment Industry Data by @kelvincarvalhosilva in https://github.com/mercadopago/sdk-php/pull/548
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.2.0...3.3.0
Feature: Order by @andreagostinho-meli in https://github.com/mercadopago/sdk-php/pull/546
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.1.0...3.2.0
[Enhancement] Add CategoryDescriptor & EventDate by @danielen-meli in https://github.com/mercadopago/sdk-php/pull/543
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.9...3.1.0
[Fix] Order, the order_id does not exists. by @RenanRAM in https://github.com/mercadopago/sdk-php/pull/528
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.8...3.0.9
[Feature] add external-reference in response by @vicorrea25 in https://github.com/mercadopago/sdk-php/pull/530
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.7...3.0.8
Include sub_merchant by @danielen-meli in https://github.com/mercadopago/sdk-php/pull/523
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.6...3.0.7
[Enhancement] Update digital line by @danielen-meli in https://github.com/mercadopago/sdk-php/pull/513
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.5...3.0.6
Update README.md by @rhames07 in https://github.com/mercadopago/sdk-php/pull/505
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.4...3.0.5
Update Merchant Order response by @rhames07 in https://github.com/mercadopago/sdk-php/pull/503
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.3...3.0.4
add missing fields barcode and verification_code in transaction_details by @edmarSoaress in https://github.com/mercadopago/sdk-php/pull/499
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.2...3.0.3
Fix $city type by @rhames07 in https://github.com/mercadopago/sdk-php/pull/493
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.1...3.0.2
Update README by @rhames07 in https://github.com/mercadopago/sdk-php/pull/476
Full Changelog: https://github.com/mercadopago/sdk-php/compare/3.0.0...3.0.1
Support for all Mercado Pago public APIs.
Full Changelog: https://github.com/mercadopago/sdk-php/compare/2.6.1...3.0.0
Update master-v2 CI workflow by @rhames07 in https://github.com/mercadopago/sdk-php/pull/464
Full Changelog: https://github.com/mercadopago/sdk-php/compare/2.6.1...2.6.2
Improve RecuperableError cause processing by @rhames07 in https://github.com/mercadopago/sdk-php/pull/451
Full Changelog: https://github.com/mercadopago/sdk-php/compare/2.6.0...2.6.1
Add resource get customer card list by @eltinMeli in https://github.com/mercadopago/sdk-php/pull/423
Full Changelog: https://github.com/mercadopago/sdk-php/compare/2.5.5...2.6.0
PHP 8.2 Support by @gabrielrbarbosa in https://github.com/mercadopago/sdk-php/pull/395
Full Changelog: https://github.com/mercadopago/sdk-php/compare/2.5.4...2.5.5
Update Manager.php for PHP 8.1 Deprecated Passing null by @llleocesar in https://github.com/mercadopago/sdk-php/pull/410
Full Changelog: https://github.com/mercadopago/sdk-php/compare/2.5.3...2.5.4
Add fields money_release_days, money_release_status
Add fields money_release_days, money_release_status
Adding parameter payment_method to Payment.php
Adding parameter payment_method to Payment.php
Always return fields next_payment_date and summarized to subscription integrations.
Always return fields next_payment_date and summarized to subscription integrations.
Added treatment for API error responses.
Inclusion of the build_version property, which generated an error when parsing the Payments API response.
Removal of deprecated documentation Adjusted error mapping when seeking payment via search feature
Removal of deprecated documentation Adjusted error mapping when seeking payment via search feature
Remove warning: ``` PHP Deprecated: is_file(): Passing null to parameter #1 ($filename) of type string is deprecated in /project/vendor/mercadopago/dx…
Remove warning:
PHP Deprecated: is_file(): Passing null to parameter #1 ($filename) of type string is deprecated in /project/vendor/mercadopago/dx-php/src/MercadoPago/Config.php on line 64
Deprecated: is_file(): Passing null to parameter #1 ($filename) of type string is deprecated in /project/vendor/mercadopago/dx-php/src/MercadoPago/Config.php on line 64
Update dependencies with vulnerabilities.
Fix AuthorizedPayment endpoint mapping.
Fix Preapproval entity adding payment_method_id and card_id.
Fix Preapproval entity adding payment_method_id and card_id.
Remove readOnly property of attributes from Preference entity
Remove readOnly property of attributes from Preference entity
Fix error when creating a payment with merchant services in gateway mode
Fix error when creating a payment with merchant services in gateway mode
FIX Undefined index: cause in OAuth::getOAuthCredentials function
Add search method to Preference
Add date_of_expiration property to Preferences
Add date_of_expiration property to Preferences
Fixing a bug that occurs when creating a payment with taxes.
Removed access token from query param
Added charges details attribute to Payments
- Reference docs - Fixed tests - Industrial fields
Nothing published for this version
One column per quarter.