PHPackages                             nails/driver-invoice-worldpay - 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. nails/driver-invoice-worldpay

ActiveLibrary[Payment Processing](/categories/payments)

nails/driver-invoice-worldpay
=============================

This is the "WorldPay" driver for the Nails Invoice module.

0.1.0(9y ago)03.1k[1 PRs](https://github.com/nails/driver-invoice-worldpay/pulls)MITPHPCI passing

Since Mar 9Pushed 2mo ago6 watchersCompare

[ Source](https://github.com/nails/driver-invoice-worldpay)[ Packagist](https://packagist.org/packages/nails/driver-invoice-worldpay)[ Docs](http://nailsapp.co.uk/modules/invoice/driver/worldpay)[ RSS](/packages/nails-driver-invoice-worldpay/feed)WikiDiscussions develop Synced yesterday

READMEChangelogDependencies (3)Versions (5)Used By (0)

WorldPay Driver for Nails Invoice Module
========================================

[](#worldpay-driver-for-nails-invoice-module)

[![license](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)[![CircleCI branch](https://camo.githubusercontent.com/12cb2e4ed5b683925e5bb2e29929edd08da7cfb68e7fcf1fc019d84ea07e5589/68747470733a2f2f696d672e736869656c64732e696f2f636972636c6563692f70726f6a6563742f6769746875622f6e61696c732f6472697665722d696e766f6963652d776f726c647061792e737667)](https://circleci.com/gh/nails/driver-invoice-worldpay)

This is the "WorldPay" driver for the Nails Invoice module, it allows the module to accept payments using the WorldPay payment processor.

Configuration
=============

[](#configuration)

WorldPay requires a potentially large number of configurations to be recorded in order to support various currencies, installations, and services.

This driver interfaces with WorldPay using the [Worldwide Payment Gateway XML API](https://developer.worldpay.com/docs/wpg) and uses a configuration object which contains a configuration object per merchant code to be supported. The driver will choose a configuration object at the time of making a charge depending on the currency being checked out, and whether the customer is present or not.

```
{
    "PRODUCTION": [
        {
            "merchant_code": "string",
            "for_currency": "string",
            "installation_id": "string",
            "customer_present": bool,
            "xml_username": "string",
            "xml_password": "string>"
        }
    ],
    "STAGING": [ ... ],
    "DEVELOPMENT": [ ... ]
}
```

`ENVIRONMENT`
-------------

[](#environment)

Each environment has its own set of independent configurations.

`merchant_code`
---------------

[](#merchant_code)

You will have one or more merchant codes associated with your account. This is given to you by WorldPay. Each merchant code should only appear once in the configuration array.

`for_currency`
--------------

[](#for_currency)

This is the ISO code for the currency which the mrchant code supports, e.g. GBP, or USD.

`installation_id`
-----------------

[](#installation_id)

If required, supply the installation ID for this merchant code. This is only used when using hosted payment pages.

`customer_present`
------------------

[](#customer_present)

If `true`, this configuration will be selected when the customer is present. If `false` it'll be selected when the customer is not present.

> A merchant code will either be in `ECOM` or `RECUR` mode, with the former for customer initiated transactions (customer present), and the latter for merchant initiated transactions (customer not present).

`xml_username`
--------------

[](#xml_username)

The username to use when querying the XML API.

`xml_password`
--------------

[](#xml_password)

The password to use when querying the XML API.

3DS Configuration
=================

[](#3ds-configuration)

If you're using the WorldPay 3DS Flex product it will need configured with some values. The configuration is similar to the above in that multiple environments can be defined at once. It takes the following structure:

```
{
    "PRODUCTION": [
        {
            "issuer": "string",
            "org_unit_id": "string",
            "mac_key": "string"
        }
    ],
    "STAGING": [ ... ],
    "DEVELOPMENT": [ ... ]
}
```

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance57

Moderate activity, may be stable

Popularity16

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 65% of commits — single point of failure

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

Unknown

Total

1

Last Release

3351d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ea9a5042213cbf644c7d8082388e559017aed7138152b28a1a623926101ef16a?d=identicon)[hellopablo](/maintainers/hellopablo)

---

Top Contributors

[![hellopablo](https://avatars.githubusercontent.com/u/233585?v=4)](https://github.com/hellopablo "hellopablo (119 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (64 commits)")

---

Tags

codeigniterdriverpaymentsworldpayNailsShed CollectiveInvoice Module

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/nails-driver-invoice-worldpay/health.svg)

```
[![Health](https://phpackages.com/badges/nails-driver-invoice-worldpay/health.svg)](https://phpackages.com/packages/nails-driver-invoice-worldpay)
```

###  Alternatives

[aktive_merchant/aktive_merchant

Aktive-Merchant provides a common interface to process payments using multiple gateways.

15036.8k](/packages/aktive-merchant-aktive-merchant)[tatter/stripe

Stripe SDK integration for CodeIgniter 4

115.3k](/packages/tatter-stripe)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)