globalpayments/php-sdk
PHP SDK for processing payments with Global Payments, including Heartland Payment Systems and Realex Payments
14.4.4
1.5M downloads/mo
#3653 most downloaded on Packagist
globalpayments/php-sdk
What this package is like to depend on
Last release 3 days ago
20 Aug 2026
Ships on a steady schedule
a new release about every 2 weeks
Most releases are documented
notes for 150 of 190 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
193 releases · first in 2018
43 releases in the last 12 months
see the full history below
Release timeline
193 releases · Aug 2018 to Aug 2026Releases
latest 60 of 193-
14.4.420 Aug 2026Release notes
Open source →Bug Fixes:
- [GPAPI] Fixed Genius logging by wiring requestLogger so gateway request/response logs are now captured correctly
Enhancements:
- [GPAPI] Mapped all missing response fields for /accesstoken
-
14.4.313 Aug 2026Release notes
Open source →Bug Fixes:
- [GP-ECOM] Improved 3DS test reliability by handling known sandbox issues (signature checks and ACS connection drops) so test results are more stable
- [GPAPI] Fixed sandbox changed surcharge error code and CVV error line number. Updated tests to use keyword-based assertions instead of exact-match strings
- [GPAPI] Resolved issue affecting customer creation and recurring payment flows
-
14.4.206 Aug 2026Release notes
Open source →Enhancements:
- [GPAPI] Fixed PHP 8 strict type compliance for builder properties and nullable entity fields
-
14.4.104 Aug 2026Release notes
Open source →Enhancements:
- [GPAPI] Updated HPP allowed-payment-methods to include eRaty
-
14.4.030 Jul 2026Release notes
Open source →New Feature:
- [GPAPI] Added Click to Pay support for HPP Pay By Link and digital wallet payment options
-
14.3.123 Jul 2026 -
14.3.009 Jul 2026Release notes
Open source →New Feature:
- [GPAPI] - Add APAC multi-currency support with decimal precision handling
Enhancements:
- [GPAPI] Add E-Raty support for HPP Links via payer reference
- [Harness] Added CI pipeline and testing harness for PHP SDK
Bug Fixes:
- [GPAPI] Fix DCC currency_conversion_mode handling for bool/int/string
-
14.2.118 Jun 2026Release notes
Open source →Bug Fixes:
- [GPAPI] Fixed transaction response avsResponseCode property assignment
-
14.2.011 Jun 2026Release notes
Open source →Bug Fixes:
- [GPAPI] Fixed address_match_indicator serialization in HPP to properly normalize case variants and validate input values
- [GPAPI] Fixed transaction response properties don't include AVS/CVV response codes
Enhancements:
- [GP-ECOM] Added Visa Direct AFT supplementary data support for API and HPP channels
- [GPAPI] Added eRaty installment payment support for Alternative Payment Methods
- [GPAPI] Additional Active Payer functionality
- [UPA] Added Mexico TYP (Thank You Points) loyalty program support: sale/void/reversal redeem fields, batch report filters, and Verifone T650C/T660 device types
-
14.1.1604 Jun 2026Release notes
Open source →Enhancements:
- [TransIT] Added a basic Transit/TSEP payment page example
- [GPAPI] Added APAC GPAPI auth endpoint verification coverage
Bug Fixes:
- [Portico] Fix PHP 8 strict typing issues in authorization and management flows
Synk:
- [High] Fixed XSS in HPP example by sanitizing the pay-by-link URL before rendering it in the HTML output
-
14.1.1514 May 2026Release notes
Open source →Bug Fixes:
- [GPAPI] Fixed PHP 8.2 fatal error in ManagementBuilder paymentMethod inheritance
-
14.1.1407 May 2026Release notes
Open source →Enhancements:
- [GP-ECOM] Fixed strict type-cast issues in builders for enhanced type safety
-
14.1.1330 Apr 2026Release notes
Open source →Enhancements:
- [GPAPI] Added Visa Direct AFT supplementary data support
Bug Fixes:
- [GPAPI] Added QA and Prod EU Data Residency Endpoint Support
-
14.1.1223 Apr 2026Release notes
Open source →Enhancements:
- [HPP] Added DCC currency_conversion_mode support for explicit YES/NO serialization.
- [GPAPI] Added ability to create 'restricted' access tokens
Bug Fixes:
- [TransIT] Fixed types/properties, PHP 8.1+ deprecations, XML validation, duplicate requests, PHPUnit 9 exceptions, and input validation.
-
14.1.1116 Apr 2026Release notes
Open source →Bug Fixes:
- [Portico] Fixed duplicate transaction error issue
- [GP-ECOM] Fixed HPP transaction type strict string/int comparison causing false UnsupportedTransactionException
-
14.1.1009 Apr 2026Release notes
Open source →Enhancements:
- [GPAPI] Add QA EU Data Residency Endpoint Support (Exclude MTLS)
Bug Fixes:
- [GPAPI] Fixed expiry_month value incorrectly formatted in 'Verify' transactions using raw card data
-
14.1.902 Apr 2026Release notes
Open source →Enhancements:
- [HIGH] Fixed XSS vulnerability by sanitizing pay-by-link URL output in installments example
- [GPAPI] Bug fix links authentication param
-
14.1.826 Mar 2026Release notes
Open source →Enhancements:
- [GPAPI] Added GET payers support
v14.1.7: (03/12/26)
Enhancements:
- [GPAPI] Added Missing Parameters for Visa Installments and HPP Links
-
14.1.712 Mar 2026Nothing published for this version
-
14.1.605 Mar 2026 -
14.1.503 Mar 2026 -
14.1.426 Feb 2026 -
14.1.319 Feb 2026Release notes
Open source →Enhancements:
- [GPAPI] Added filtering options for installments on the Hosted Payment Page
-
14.1.212 Feb 2026 -
14.1.129 Jan 2026Release notes
Open source →Enhancements:
- [HIGH] Fixed XSS vulnerability by sanitizing HTTP headers in hosted payment page
-
14.1.022 Jan 2026Release notes
Open source →Enhancements:
- [PHP8] Add PHP 8 type declarations to class properties for improved type safety
-
14.0.508 Jan 2026Release notes
Open source →Enhancements:
- [UPA] Remove HSA/FSA parameter support (removed in UPA v1.60)
-
14.0.411 Dec 2025 -
14.0.4-beta04 Dec 2025 pre-releaseNothing published for this version
-
14.0.304 Dec 2025Release notes
Open source →Enhancements:
- [Portico] Add EMVChipCondition element support
- [GPAPI] Enable GP-API access using Portico credentials
-
14.0.3-beta04 Dec 2025 pre-releaseNothing published for this version
-
14.0.220 Nov 2025Release notes
Open source →Enhancements:
- [Portico] Bug fix cert endpoint ignored when using production credentials
-
14.0.113 Nov 2025Release notes
Open source →Enhancements:
- [GPAPI] Added ContractReference field in Stored Credential
-
14.0.006 Nov 2025 -
13.4.123 Oct 2025 -
13.4.016 Oct 2025Release notes
Open source →Enhancements:
- Updates for enhanced PHP8.4 compatability
- [UPA] Add DebitTest class for all supported transactions.
- [UPA] Add new SI missing commands : BalanceInquiry, DeleteSAF, InjectCarouselLogo and RemoveCarouselLogo.
-
13.4.0-beta25 Sep 2025 pre-releaseNothing published for this version
-
13.3.909 Oct 2025 -
13.3.809 Oct 2025Release notes
Open source →Enhancements:
- [UPA] Added Surchagble Tippable Amount for UPA and MITC UPA
- [Macroscope] Various high security updates
-
13.3.702 Oct 2025Release notes
Open source →Enhancements:
- [Portico] Implemented conditional clerkId mapping for Credit card transactions
- [Macroscope] Fix 3DS critical security vulnerability
-
13.3.611 Sep 2025Release notes
Open source →Enhancements:
- [UPA] Return all UPA error response properties
- [Macroscope] Reverted security fixes from v13.3.1 and v13.3.3
-
13.3.509 Sep 2025 -
13.3.404 Sep 2025Release notes
Open source →Enhancements:
- [UPA] Add new UPA commands : CancelTransaction, SaveConfigFile, LineItemDisplay, SetLogoCarouselInterval, GetBatteryPercentage
- [GP-API] - Include merchant ID for recurring operations
-
13.3.329 Jul 2025Release notes
Open source →Enhancements:
- Security enhancements for some terminal loggers
- [UPA] - Correct reference mapping
-
13.3.224 Jul 2025 -
13.3.115 Jul 2025 -
13.3.010 Jul 2025 -
13.2.226 Jun 2025 -
13.2.110 Jun 2025Release notes
Open source →Bug Fixes:
- [GP-API] HotFix for Installment class naming convention issue
Enhancements:
- [Portico] - Apply improvements in PorticoReportingTests suite
-
13.2.005 Jun 2025 -
13.1.203 Jun 2025Release notes
Open source →Enchancements:
- [Portico] Added AmountIndicator element
New Feature:
- [GPApi] - Added Installment Object in Create Sale API (POST /transactions)
- [GPApi] - Added Installment Object in Reporting API (GET /transactions & GET /transactions/{id})
-
13.1.129 May 2025Release notes
Open source →Bug Fixes:
- [TSYS/Merchantware] Correction to partial-auth response handling
-
13.1.027 Mar 2025 -
13.0.811 Feb 2025 -
13.0.704 Dec 2024Release notes
Open source →Enhancements:
- Add console logger feature
- [GP-API/GP-ECOM] Unit tests enhancements
-
13.0.620 Nov 2024Release notes
Open source →Enhancements:
- [GP-API] - Add new mapping fields on get transaction list: "funding", "authentication"
-
13.0.514 Nov 2024Release notes
Open source →Enhancements:
- [GP-API] - Add new mapping fields on digital wallet transaction response: masked_number_last4, brand, brand_reference
- [MITC UPA] - Add new commands: getAppInfo, getParam, setTimeZone,clearDataLake, reset, returnToIdle, getDeviceConfig, print, scan, getDebugInfo, setDebugLevel, getDebugLevel, getSignatureFile, communicationCheck, logon, findBatches, getBatchDetails, getBatchReport, displayMessage
-
13.0.407 Nov 2024Release notes
Open source →Enhancements:
- [Portico] Added 'GatewayTxnId' value to GatewayException message when available
-
13.0.315 Oct 2024Release notes
Open source →Enhancements:
- [Portico] Added support for 'CreditIncrementalAuth' transaction type
-
13.0.203 Oct 2024Release notes
Open source →Enhancements:
- [Portico] Added support for 'CardHolderPhone' element
- [GP-API] Update 3DS Object fields in transaction endpoint ("server_trans_ref" and "ds_trans_ref")
- [GP-API] Cleanup and refacto on the GpApiConnector.