Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.


getpaid.pxpay is unavailable in PyPM, because there aren't any builds for it in the package repositories. Click the linked icons to find out why.

 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
Linux (64-bit)

This package contains pxpay for getpaid.


0.5 (2010-05-07)
  • fixed bug with timeout setting on ssl connection string
0.4 (2009-10-30)
  • add an explicit certs.pem and add known CAs that paymentexpress are

System Message: WARNING/2 (<string>, line 17)

Bullet list ends without a blank line; unexpected unindent.


0.3 (2008-12-31)
  • put order id into TxnData1 so that exported DPS reports have

System Message: WARNING/2 (<string>, line 23)

Bullet list ends without a blank line; unexpected unindent.

an order id we can cross check against orders in getpaid order manager [matt.halstead]

0.2 (2008-08-29)
  • Added buildout files and general text documents to project root.
  • removed setup.cfg
Detailed Documentation

This is a Payment Processor for the PaymentExpress PXPay hosted Payments solution SEE: http://www.paymentexpress.com/technical_resources/ecommerce_hosted/pxpay.html


You need to load both the package zcml and the overrides.zcml

In buildout, make sure you have the egg getpaid.pxpay installed, in the zope instance configuration, add the following:

eggs = getpaid.pxpay


We hook into the last checkout and payment step of the checkout so that the user is redirected to the pxpay web interface to fill out their credit card details and the redirected back to our site where we handle success or failure status of the transaction.

Deferred payment, repeating payments, authorisations, etc, are not yet implemented, but the PXPay interface supports them, so there's no reason they can't be added.

Orders and Finance workflow

An orders persistence and workflow is managed entirely by this payment processor. Since we hook into the last step of the checkout, we are responsible for creating the order, storing it in the manager, and handling the finance workflow.

When a user selects "make payment"

  • an order is created and stored in the order manager (i.e. it is now

System Message: WARNING/2 (<string>, line 73)

Bullet list ends without a blank line; unexpected unindent.

persistent in the zodb)

  • finance workflow: None --> REVIEWING
  • the order is authorized - which means a payment request is made to

System Message: WARNING/2 (<string>, line 78)

Bullet list ends without a blank line; unexpected unindent.


If pxpay returns saying this is ok and here is the url to redirect to, then we update the finance workflow: REVIEWING --> CHARGEABLE --> CHARGING (note: CHARGEABLE --> CHARGING is an automatic transition.

The user is redirected to the pxpay web interface to enter credit card details. The site then redirects them back to our callback and we negotiate a response message. This tells us whether the payment was successful or not.

If the payment was successful, then we update the finance workflow: CHARGING --> CHARGED

If the payment was unsuccessful, then we update the finance workflow: CHARGING --> PAYMENT_DECLINED

If there is an error in the communication with pxpay, then we update the finance workflow: * --> CANCELLED_BY_PROCESSOR with a comment that this was a communication error. We don't destroy the cart though so the user can try again.

The error handler for a communications error is a utility so that it can be overriden easily, for example to redirect the user to another view.

  1. A developer account with PaymentExpress
  2. GetPaid core
  3. zc.ssl
  4. elementtree
  5. plone (tested on plone 3.1)

Darryl Dixon <darryl.dixon@winterhouseconsulting.com> Matt Halstead <matt@elyt.com>


Subscribe to package updates

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.