PHPackages comicrelief/omnipay-worldpay-cg-hosted - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. comicrelief/omnipay-worldpay-cg-hosted AbandonedArchivedLibrary[Payment Processing](/categories/payments) comicrelief/omnipay-worldpay-cg-hosted ====================================== WorldPay Hosted Corporate Gateway driver for the Omnipay payment processing library v1.0.4(8y ago)417.5k↓50%6[1 PRs](https://github.com/comicrelief/omnipay-worldpay-cg-hosted/pulls)MITPHPPHP ^5.6|^7 Since Aug 14Pushed 7y ago17 watchersCompare [ Source](https://github.com/comicrelief/omnipay-worldpay-cg-hosted)[ Packagist](https://packagist.org/packages/comicrelief/omnipay-worldpay-cg-hosted)[ Docs](https://github.com/comicrelief/omnipay-worldpay-cg-hosted)[ RSS](/packages/comicrelief-omnipay-worldpay-cg-hosted/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (17)Used By (0) Omnipay: Worldpay Hosted Corporate Gateway (XML) ================================================ [](#omnipay-worldpay-hosted-corporate-gateway-xml) **WorldPay Hosted driver for the Omnipay PHP payment processing library** [Omnipay](https://github.com/omnipay/omnipay) is a framework agnostic, multi-gateway payment processing library for PHP 5.6+. This package implements WorldPay XML Corporate Gateway Hosted support for Omnipay. Installation ------------ [](#installation) Omnipay is installed via [Composer](http://getcomposer.org/). First, make sure you have composer installed by visiting and following the instructions. Then, install this package by requiring it through composer: ``` $ php composer.phar require comicrelief/omnipay-worldpay-cg-hosted ``` Basic Usage ----------- [](#basic-usage) The following gateways are provided by this package: - WorldPay Corporate Gateway Hosted For general usage instructions, please see the main [Omnipay](https://github.com/omnipay/omnipay) repository. Order description ----------------- [](#order-description) We currently set the order description to "Merchandise" by default. To set another one, use `PurchaseRequest::setDescription()`. Notification setup ------------------ [](#notification-setup) This library aims to be able to give sensible answers for `isValid()`, `isAuthorised()`, `isPending()` and `isCancelled()`, if you select almost every possible type on this screen: [![Notification setup](./docs/Notification%20setup.png "Notification setup")](./docs/Notification%20setup.png) Generally it's good to tick everything you can, so as not to miss notifications you might care about. However we've had to **not tick *SENT\_FOR\_AUTHORISATION*** because of an apparent Worldpay bug that sends two *AUTHORISED* notifications when this is selected, instead of sending the additional type. We have not yet had confirmation from Worldpay on whether this is expected to affect the production gateway or if it will be fixed, so it's safer not to enable this notification for now. Notification verification ------------------------- [](#notification-verification) Worldpay recommend the following to receive notifications and check they came from them: 1. Use server SSL - this should be standard for any payment app! 2. Check the IP's reverse DNS records - this actually isn't very secure and can be spoofed, but is implemented in this library as a first line of defence. There is an IP fallback for known Worldpay subnets, in case your environment can't do public reverse DNS lookups. 3. Request for them to send, and validate on your server, their client TLS certificate. Unfortunately there's no easy server- and environment-agnostic way to implement client TLS verification (point 3) within this library, and for our apps' current infrastructure it wasn't feasible. Some of the work would generally live in your web server anyway rather than this library. We also considered an additional measure, [inquiry requests](http://support.worldpay.com/support/kb/gg/corporate-gateway-guide/content/manage/inquiryrequests.htm), but as this document explains they're not enabled by default and are also nowhere near real-time (~5 minutes latency). This means they are not suitable for checking notifications' validity unless you queue them and accept much longer delays. This means that for now you should *not* consider notifications shown as 'valid' in this library to be guaranteed valid, i.e. **do not ship goods based on this without a later check**, using inquiry requests or the Worldpay UI, that gives a matching result. Any ideas or contributions that you think might improve this situation would be very welcome! Support ------- [](#support) If you are having general issues with Omnipay, we suggest posting on [Stack Overflow](https://stackoverflow.com/). Be sure to add the [omnipay tag](https://stackoverflow.com/questions/tagged/omnipay) so it can be easily found. If you want to keep up to date with release anouncements, discuss ideas for the project, or ask more detailed questions, there is also a [mailing list](https://groups.google.com/forum/#!forum/omnipay) which you can subscribe to. If you believe you have found a bug, please report it using the [issue tracker](https://github.com/comicrelief/omnipay-worldpay-cg-hosted/issues), or better yet, fork the library and submit a pull request. ### Health Score 37 — LowBetter than 83% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity31 Limited adoption so far Community20 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~15 days Recently: every ~43 days Total 15 Last Release 2981d ago Major Versions v0.0.10 → v1.0.02017-09-21 ### Community Maintainers ![](https://www.gravatar.com/avatar/f06b1798977e196e99c5d0b7f408c2c3a13cf09c0df2cf93841b6e1b73124b16?d=identicon)[adamclark-dev](/maintainers/adamclark-dev) --- Top Contributors [![ayanozturk](https://avatars.githubusercontent.com/u/1406135?v=4)](https://github.com/ayanozturk "ayanozturk (12 commits)")[![NoelLH](https://avatars.githubusercontent.com/u/3274454?v=4)](https://github.com/NoelLH "NoelLH (9 commits)")[![knasher](https://avatars.githubusercontent.com/u/1300648?v=4)](https://github.com/knasher "knasher (8 commits)")[![adamclark-dev](https://avatars.githubusercontent.com/u/9998404?v=4)](https://github.com/adamclark-dev "adamclark-dev (2 commits)")[![chrisemerson](https://avatars.githubusercontent.com/u/4631704?v=4)](https://github.com/chrisemerson "chrisemerson (1 commits)")[![zhibek](https://avatars.githubusercontent.com/u/1309381?v=4)](https://github.com/zhibek "zhibek (1 commits)") --- Tags phppaymentgatewaypaymerchantomnipayworldpaycorporate ### Embed Badge ![Health badge](/badges/comicrelief-omnipay-worldpay-cg-hosted/health.svg) ``` [![Health](https://phpackages.com/badges/comicrelief-omnipay-worldpay-cg-hosted/health.svg)](https://phpackages.com/packages/comicrelief-omnipay-worldpay-cg-hosted) ``` ### Alternatives [lokielse/omnipay-alipay Alipay gateway for Omnipay payment processing library 587421.0k11](/packages/lokielse-omnipay-alipay)[omnipay/worldpay WorldPay driver for the Omnipay payment processing library 24934.6k7](/packages/omnipay-worldpay)[sudiptpa/omnipay-nabtransact National Australia Bank (NAB) Transact driver for the Omnipay payment processing library. 1017.2k](/packages/sudiptpa-omnipay-nabtransact)[lucassmacedo/omnipay-mercadopago MercadoPago gateway for OmniPay 154.6k](/packages/lucassmacedo-omnipay-mercadopago) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)