Skip to main content
drupalreleases

Use direct release data with your AI assistant.

Learn more

Commerce Purchase Order

Security covered Maintenance fixes only 280 sites

Part of the Commerce ecosystem · 487 projects

This module provides a payment gateway for customers to pay using purchase orders. It allows administrators to configure whether users need approval to use purchase orders, set limits on open purchase orders per customer, and provide specific payment instructions. The module also tracks the workflow of purchase orders through states like New, Authorized, and Paid.

Configuration

User field

This payment gateway gives you the option of requiring users to be approved to use purchase orders. When it is installed it adds a field, Purchase Orders Authorized to the User entity. By default, this field is not displayed. To use this field, and require user pre-approval for Purchase Orders, begin by browsing to admin/config/people/accounts/form-display and move this field from Disabled into the form.

Payment Gateways

Payment gateways are added at admin/commerce/config/payment-gateways. Commerce Purchase Order adds the following to the gateway configuration form:

  • Limit maximum open purchase orders The number of unpaid purchase orders a customer has can be used to prevent new purchases. See Workflow below.
  • Purchase order users require approval in the user account settings When selected, the value of Purchase Orders Authorized is examined when the customer "pays and completes" the order. If the field is not checked (is FALSE) then the payment is denied (not authorized).
  • Payment instructions Formatted text instructing the user how to pay their Purchase Order amount. Displayed at checkout and in the confirming email.
  • Conditions: Customer - Limit by field: Purchase Orders Authorized This condition is useful when Commerce Purchase Order is one of multiple gateways enabled. When selected the gateway is only offered as an option if the Customer is approved to use it. See the discussion of the field Purchase Orders Authorized above.

Workflow

Commerce Purchase Orders normally progress through the following:

  1. New The checkout process has begun and a PO number assigned to a one-time payment method.
  2. Authorized The payment is saved and the user has checked out. The Purchase Order has not been paid.
  3. Paid A user with permission to administer payments has browsed to the payment tab of the relevant order, selected Receive as the operation, and recorded the payment by saving the Receive Payment form.
Drupal 10–11

Ask your assistant about Commerce Purchase Order

Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works

Depends on

Dependencies of the latest stable release

Required by

Tracked projects that depend on this one

No tracked projects depend on this one yet.

Activity

Tracked releases
9
Tracked since
Apr 2023
Latest release
6 days ago
Releases (12 mo)
2
Maintenance
Active

Release Timeline

Releases

Version Type Core PHP Release date
2.2.0-beta1 Pre-release 11 Oct 10, 2026
2.2.x-dev Dev 11 Jul 21, 2026
2.1.0 Stable 10–11 Feb 25, 2025
2.1.x-dev Dev 10–11 Feb 25, 2025
2.0.0 Stable 9–10 Apr 5, 2024
8.x-1.4 Stable 8–9 Apr 5, 2024
2.0.0-beta1 Pre-release 9–10 Apr 3, 2023
2.0.x-dev Dev 10–11 Apr 2, 2023
8.x-1.3 Stable 8–9 Apr 1, 2023