WordPress action hook

woocommerce_payment_complete

Defined by WooCommerce and fired by 17 plugins in total, running on 7M+ sites between them.

How to use woocommerce_payment_complete

It's an action: your callback runs at that point and receives 1 argument. Nothing needs to be returned. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_action( 'woocommerce_payment_complete', function( $arg1 ) {
	// Your code runs here.
}, 10, 1 );

Argument names come from Pix por Piggly (para Woocommerce)'s source. Other plugins may pass different values: check the call in the plugin you're targeting below.

17 plugins that fire woocommerce_payment_complete

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. WooCommerce icon WooCommerce7+ million installs do_action( 'woocommerce_payment_complete', $this->get_id(), $transaction_id ) includes/class-wc-order.php:186
  2. Pix por Piggly (para Woocommerce) icon Pix por Piggly (para Woocommerce)4,000+ installs do_action( 'woocommerce_payment_complete', $order->get_id() ) src/Core/Ajax.php:400
  3. Phone Orders for WooCommerce icon Phone Orders for WooCommerce1,000+ installs do_action( 'woocommerce_payment_complete', $order->get_id(), "" ) classes/tabs/class-wc-phone-orders-add-order-page.php:1674
  4. PayPlus Payment Gateway icon PayPlus Payment Gateway1,000+ installs do_action( 'woocommerce_payment_complete', $order_id, $order->get_transaction_id() ) includes/wc_payplus_gateway.php:3927
  5. BjornTech PayPal POS integration for WooCommerce icon BjornTech PayPal POS integration for WooCommerce600+ installs do_action( 'woocommerce_payment_complete', $order_id ) includes/izettle-integration-purchase-handler.php:1581
  6. Yandex Pay and Split icon Yandex Pay and Split600+ installs do_action( 'woocommerce_payment_complete', $order->get_id(), '' ) includes/payment-methods/class-wc-gateway-yandex-pay-and-split.php:551
  7. dLocal Go Payments icon dLocal Go Payments400+ installs do_action( 'woocommerce_payment_complete', $order->get_id() ) includes/class-wc-gateway-dlocal-go.php:770
  8. Geidea Online Payments for WooCommerce icon Geidea Online Payments for WooCommerce400+ installs do_action( 'woocommerce_payment_complete', $order->get_id() ) functions/PaymentComplete.php:44
  9. IUGU for WooCommerce icon IUGU for WooCommerce300+ installs do_action( 'woocommerce_payment_complete', $order->get_id() ) inc/class-wc-iugu-api.php:1408
  10. Scanpay for WooCommerce icon Scanpay for WooCommerce200+ installs do_action( 'woocommerce_payment_complete', $oid, $trnid ) hooks/class-wc-scanpay-sync.php:375
  11. 우커머스 네이버페이 icon 우커머스 네이버페이200+ installs do_action( 'woocommerce_payment_complete', $order->get_id() ) includes/class-mnp-order.php:574
  12. Blink For WooCommerce icon Blink For WooCommerce50+ installs do_action( 'woocommerce_payment_complete', $order->get_id(), $transactionId ) src/Orders/OrderStatusApplier.php:190
  13. Simpler Checkout icon Simpler Checkout40+ installs do_action( 'woocommerce_payment_complete', $order_id, null ) includes/Services/OrderService.php:156
  14. Payment4 Crypto Payment gateway icon Payment4 Crypto Payment gateway10+ installs do_action( 'woocommerce_payment_complete', $order->get_id(), $transaction_id ) plugins/woo/class-wc-gateway-payment4.php:690
  15. Bank Transfer (BACS) through Stripe icon Bank Transfer (BACS) through Stripe10+ installs do_action( 'woocommerce_payment_complete', $order->get_id(), $payment_method->id ) includes/class-pio-stripe-bacs-gateway.php:327
  16. Pagador (Braspag) Checkout for WooCommerce icon Pagador (Braspag) Checkout for WooCommerce10+ installs do_action( 'woocommerce_payment_complete', $order->get_id() ) modules/woocommerce/includes/class-wc-checkout-braspag-gateway.php:742
  17. SMT Toolkit for WooCommerce icon SMT Toolkit for WooCommerceFewer than 10 installs do_action( 'woocommerce_payment_complete', $order->get_id(), $state['transaction'] ) includes/modules/payments/class-payment-gateway.php:222

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.