LLMS_Payment_Gateway::handle_payment_source_switch( LLMS_Order $order, array $form_data = array() )

Called when the Update Payment Method form is submitted from a single order view on the student dashboard


Description Description

Gateways should do whatever the gateway needs to do to validate the new payment method and save it to the order so that future payments on the order will use this new source.

This should be an abstract function but experience has taught me that no one will upgrade follow our instructions and they’ll end up with 500 errors and debug mode disabled and send me giant frustrated question marks.


Top ↑

Parameters Parameters

$order

(LLMS_Order) (Required) Order object.

$form_data

(array) (Optional) Additional data passed from the submitted form (EG $_POST).

Default value: array()


Top ↑

Return Return

(null)


Top ↑

Source Source

File: includes/abstracts/abstract.llms.payment.gateway.php

	public function handle_payment_source_switch( $order, $form_data = array() ) {
		return llms_add_notice(
			sprintf(
				// Translatos: %s = the title of the payment gateway.
				esc_html__( 'The selected payment Gateway "%s" does not support payment method switching.', 'lifterlms' ),
				$this->get_title()
			),
			'error'
		);
	}


Top ↑

Changelog Changelog

Changelog
Version Description
3.10.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.