sdk-php

Changelog

All notable changes to this project will be documented in this file.

This project follows Keep a Changelog and Semantic Versioning.

[3.14.0] - 2026-08-11

Added

• Automatic Payments example: two-step recurring flow (#639)
• Order typed Request classes with dual acceptance in create() (#639)
• Order request layer: reuse Common\Address, Identification, Phone (#639)
• Pagination: support data key (Orders v2) and string paging totals in MPAutoPaginationGenerator (#639)

Fixed

• Stored credential: rename prev_transaction_ref to previous_transaction_reference (#639)

CI

• Add CD workflow (#651)
• Standardize CI workflow (#651)
• Add mock-based unit test coverage (#651)

Dependencies

• Fix CVE-2026-67434: upgrade squizlabs/php_codesniffer to 4.0.4 (#651)

[3.13.0] - 2026-08-04

Added

• SDK ergonomics: typed exceptions, configurable retry, and auto-pagination (#646)
  • MPApiException now has 12 specific subtypes per HTTP status code
  • MPRequestOptions gains optional maxRetries, retryOn, initialDelayMs, maxDelayMs and onRetry callback
  • New auto-pagination support on search endpoints
• Missing API methods — DisbursementRefundClient::list(), AdvancedPaymentClient::update(), CustomerCard::update(), PaymentClient::update() (#645)
• CREDENTIAL_ON_FILE messaging fields on Payment types (#642): firstTransaction, storage, transactionInitiator, reference

Fixed

• Webhook toleranceSeconds unit mismatch — ts header value compared in seconds against a millisecond clock (#647)
• constantTimeEquals RangeError on multibyte v1 hash (#647)

CI

• Hotfix: pin GitHub Actions to SHA for supply chain security (#638)

Dependencies

• Bump symfony/console (#643)
• Bump friendsofphp/php-cs-fixer (#644, #640)
• Bump actions/checkout to v7.0.1 (#641)

[3.12.0] - 2026-06-27

Changed

• Order CheckokutPRO capability

[3.11.0] - 2026-05-27

Added

• AdvancedPayment: marketplace split-payment management — Create, Get, Search, Update, Capture, Cancel, UpdateReleaseDate (POST/GET/PUT /v1/advanced_payments).
• DisbursementRefund: refund management for split-payment disbursements — ListAll, CreateAll, Create (GET/POST /v1/advanced_payments/{id}/refunds, POST /v1/advanced_payments/{id}/disbursements/{id}/refunds).
• Chargeback: read-only access to payment dispute records — Get, Search (GET /v1/chargebacks).

[3.7.1] - 2025-10-30

Added

-

Changed

• Bump the SDK version to 3.7.1 in MercadoPagoConfig::$CURRENT_VERSION

Fixed

• Fix addresses and cards mapping in Customer resource

Deprecated

-

Security

[3.6.0] - 2025-09-01

Added

• Atualizações de documentação para instruções de instalação

Changed

• Bump the SDK version to 3.6.0 in MercadoPagoConfig::$CURRENT_VERSION

Fixed

-

Deprecated

-

Removed

-

Security

-

[3.5.1] - 2025-08-28

Added

• Add and update fields and tests

Changed

• Add and fix tests in OrderClientUnitTest
• Updates .gitignore to ignore .idea

Fixed

-

Deprecated

-

Security

-

This site is open source. Improve this page.