WC_Order::payment_complete( string $transaction_id = '' )
When a payment is complete this function is called.
Description Description
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.
Parameters Parameters
- $transaction_id
-
(Optional) transaction id to store in post meta.
Default value: ''
Return Return
(bool) success
Source Source
File: includes/class-wc-order.php
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() );
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() );
} else {
do_action( 'woocommerce_payment_complete_order_status_' . $this->get_status(), $this->get_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;
}