Skip to main content
Drupal is a registered trademark of Dries Buytaert
Release: OpenID Connect / OAuth client 3.0.0-alpha9 New alpha version released for module openid_connect (3.0.0-alpha9). Release: Opensolr Search 4.5.0 Minor update available for module opensolr_search (4.5.0). Release: Timelinr 1.0.1 Minor update available for module timelinr (1.0.1). Usage Milestone: Simplify Module simplify crossed 10,000 active installs. Usage Milestone: Views Reference Filter Module entityreference_filter crossed 10,000 active installs. Usage Milestone: Dropdown Language Module dropdown_language crossed 10,000 active installs. Usage Milestone: Paragraphs Browser Module paragraphs_browser crossed 10,000 active installs. Usage Milestone: OpenAPI Module openapi crossed 10,000 active installs. Usage Milestone: Decoupled Router Module decoupled_router crossed 10,000 active installs. Module Revived: Entityqueue Buttons 1.1.2 Module entityqueue_buttons updated after 8 months of inactivity (1.1.2).

Commerce Purchase Order

280 sites Security covered Drupal 10–11 Commerce ecosystem
View on drupal.org

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.

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
3
Tracked since
Feb 2025
Latest release
1 month ago
Releases (12 mo)
1 ▼ from 2
Maintenance
Active

Release Timeline

Releases

Version Type Core Release date
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