WC_Order::payment_complete()
When a payment is complete this function is called.
Most of the time this should mark an order as 'processing' so that admin can process/post the items. If the cart contains only downloadable items then the order is 'completed' since the admin needs to take no action. Stock levels are reduced at this point. Sales are also recorded for products. Finally, record the date of payment.
Method of the class: WC_Order{}
Hooks from the method
Return
true|false
. success
Usage
$WC_Order = new WC_Order(); $WC_Order->payment_complete( $transaction_id );
- $transaction_id(string)
- Optional transaction id to store in post meta.
Default: ''
WC_Order::payment_complete() WC Order::payment complete code WC 9.4.2
public function payment_complete( $transaction_id = '' ) { if ( ! $this->get_id() ) { // Order must exist. return false; } try { do_action( 'woocommerce_pre_payment_complete', $this->get_id(), $transaction_id ); if ( WC()->session ) { WC()->session->set( 'order_awaiting_payment', false ); } if ( $this->has_status( apply_filters( 'woocommerce_valid_order_statuses_for_payment_complete', array( 'on-hold', 'pending', 'failed', 'cancelled' ), $this ) ) ) { if ( ! empty( $transaction_id ) ) { $this->set_transaction_id( $transaction_id ); } if ( ! $this->get_date_paid( 'edit' ) ) { $this->set_date_paid( time() ); } $this->set_status( apply_filters( 'woocommerce_payment_complete_order_status', $this->needs_processing() ? 'processing' : 'completed', $this->get_id(), $this ) ); $this->save(); do_action( 'woocommerce_payment_complete', $this->get_id(), $transaction_id ); } else { do_action( 'woocommerce_payment_complete_order_status_' . $this->get_status(), $this->get_id(), $transaction_id ); } } catch ( Exception $e ) { /** * If there was an error completing the payment, log to a file and add an order note so the admin can take action. */ $logger = wc_get_logger(); $logger->error( sprintf( 'Error completing payment for order #%d', $this->get_id() ), array( 'order' => $this, 'error' => $e, ) ); $this->add_order_note( __( 'Payment complete event failed.', 'woocommerce' ) . ' ' . $e->getMessage() ); return false; } return true; }