wp-pay/core

Core components for the WordPress payment processing library.

v4.24.0 2024-12-17 13:00 UTC

Requires

• php: >=7.4
• ext-dom: *
• ext-libxml: *
• ext-simplexml: *
• automattic/jetpack-autoloader: ^3.0
• pronamic/wp-datetime: ^2.1
• pronamic/wp-html: ^2.2
• pronamic/wp-http: ^1.2
• pronamic/wp-money: ^2.3
• pronamic/wp-number: ^1.3
• pronamic/wp-pay-logos: ^2.2
• viison/address-splitter: ^0.3.4
• woocommerce/action-scheduler: ^3.8

Requires (Dev)

• overtrue/phplint: ^9.4
• php-coveralls/php-coveralls: ^2.4
• php-stubs/wordpress-globals: ^0.2.0
• php-stubs/wp-cli-stubs: ^2.4
• phpmd/phpmd: ^2.9
• phpstan/extension-installer: ^1.3
• phpstan/phpstan: ^1.11
• pronamic/pronamic-cli: ^1.1
• pronamic/wp-coding-standards: ^2.0
• pronamic/wp-documentor: ^1.4
• roots/wordpress: ^6.0
• szepeviktor/phpstan-wordpress: ^1.3
• vimeo/psalm: ^5.24
• wordpress/sqlite-database-integration: ^2.1
• wp-cli/wp-cli: ^2.3
• wp-phpunit/wp-phpunit: ^6.1
• yoast/phpunit-polyfills: ^2.0

GPL-3.0-or-later

• Pronamic
• Remco Tolsma

• wordpress
• pay
• gateway
• core
• wp
• pronamic

README

WordPress Pay » Core

The WordPress payment processing library is intended to make payments and integrations with payment providers easier to set up and maintain within WordPress. It has similarities to libraries like https://github.com/Payum/Payum and https://github.com/thephpleague/omnipay, but is more focused on WordPress. The code complies with the WordPress Coding Standards and the WordPress APIs are used.

Table of contents

• Status
• CLI
• WordPress Filters

Status

CLI

Check pending payment status

wp pay payment status $( wp post list --field=ID --post_type=pronamic_payment --post_status=payment_pending --order=ASC --orderby=date --posts_per_page=100 --paged=1 )

WordPress Filters

pronamic_payment_gateway_configuration_id

\add_filter(
	'pronamic_payment_gateway_configuration_id',
	/**
	 * Filter the payment gateway configuration ID to use specific 
	 * gateways for certain WooCommerce billing countries.
	 *
	 * @param int     $configuration_id Gateway configuration ID.
	 * @param Payment $payment          The payment resource data.
	 * @return int Gateway configuration ID.
	 */
	function( $configuration_id, $payment ) {
		if ( 'woocommerce' !== $payment->get_source() ) {
			return $configuration_id;
		}

		$billing_address = $payment->get_billing_address();

		if ( null === $billing_address ) {
			return $configuration_id;
		}

		$id = $configuration_id;

		switch ( $billing_address->get_country_code() ) {
			case 'US':
				$id = \get_option( 'custom_us_gateway_configuration_id', $id );
				break;
			case 'AU':
				$id = \get_option( 'custom_au_gateway_configuration_id', $id );
				break;
		}

		if ( 'pronamic_gateway' === \get_post_type( $id ) && 'publish' === \get_post_status( $id ) ) {
			$configuration_id = $id;
		}

		return $configuration_id;
	},
	10,
	2
);

pronamic_gateway_configuration_display_value

\add_filter(
	'pronamic_gateway_configuration_display_value',
	function( $display_value, $post_id ) {
		return \get_post_meta( $post_id, '_pronamic_gateway_display_value', true );
	},
	10,
	2
);

pronamic_gateway_configuration_display_value_$id

\add_filter(
	'pronamic_gateway_configuration_display_value_payvision',
	function( $display_value, $post_id ) {
		return \get_post_meta( $post_id, '_pronamic_gateway_payvision_business_id', true );
	},
	10,
	2
);