For Developers

Displaying QR Code

Shortcode

[wpify_woo_render_qr_code]

The shortcode automatically detects the order in this order:

1. order_id parameter in shortcode
2. key parameter in URL (thank you page)
3. Global variable $email (in email)
4. Global variable $order
5. Query variable order-pay or view-order

Parameters

Parameter	Type	Description
order_id	int	Order ID (optional)

Example with Order ID

[wpify_woo_render_qr_code order_id="12345"]

PHP Action

do_action( 'wpify_woo_render_qr_code', $order );

Parameters

Parameter	Type	Description
$order	int|WC_Order	Order ID or WC_Order object

Example: QR Code on “My Account” Page

add_action( 'woocommerce_view_order', function( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( $order->get_status() === 'on-hold' ) {
        do_action( 'wpify_woo_render_qr_code', $order );
    }
}, 1, 1 );

Filters

wpify_woo_qr_payment_details

Modifies payment data before generating the QR code.

apply_filters( 'wpify_woo_qr_payment_details', array $payment_details, WC_Order $order );

Parameters

Parameter	Type	Description
$payment_details	array	Payment data (see below)
$order	WC_Order	Order object

Structure of $payment_details

Key	Type	Description
order	string	Order number
total	float	Total amount
vs	string	Variable symbol (order number without non-numeric characters)
currency	string	Currency (CZK, EUR, HUF)
due_date	string	Due date (Y-m-d)
account_number	string	Account number (CZ)
bank_code	string	Bank code (CZ)
iban	string	IBAN
bic	string	BIC/SWIFT
note	string	Message for recipient
recipient_name	string	Recipient name

Example: Custom Variable Symbol

add_filter( 'wpify_woo_qr_payment_details', function( $details, $order ) {
    // Use custom meta as variable symbol
    $custom_vs = $order->get_meta( '_custom_variable_symbol' );
    if ( $custom_vs ) {
        $details['vs'] = $custom_vs;
    }
    return $details;
}, 10, 2 );

Example: Modifying Due Date

add_filter( 'wpify_woo_qr_payment_details', function( $details, $order ) {
    // Due date 14 days from order creation
    $due_date = new DateTime( $order->get_date_created()->format( 'Y-m-d' ) );
    $due_date->modify( '+14 days' );
    $details['due_date'] = $due_date->format( 'Y-m-d' );
    return $details;
}, 10, 2 );

---

wpify_woo_skip_qr_payment

Skips QR code rendering for a specific order/account.

apply_filters( 'wpify_woo_skip_qr_payment', bool $skip, WC_Order $order, array $account );

Parameters

Parameter	Type	Description
$skip	bool	Skip rendering (default: false)
$order	WC_Order	Order object
$account	array	Bank account data

Example: Do Not Display for Paid Orders

add_filter( 'wpify_woo_skip_qr_payment', function( $skip, $order, $account ) {
    if ( $order->is_paid() ) {
        return true;
    }
    return $skip;
}, 10, 3 );

Example: Do Not Display for Small Orders

add_filter( 'wpify_woo_skip_qr_payment', function( $skip, $order, $account ) {
    if ( $order->get_total() < 100 ) {
        return true;
    }
    return $skip;
}, 10, 3 );

---

wpify_woo_qr_account_data

Modifies bank account data after loading from BACS and before validation.

apply_filters( 'wpify_woo_qr_account_data', array $account, WC_Order $order );

Parameters

Parameter	Type	Description
$account	array	Account data (see below)
$order	WC_Order	Order object

Structure of $account

Key	Type	Description
source	string	Data source (BACS account index or empty)
iban	string	IBAN
number	string	Account number
bank_code	string	Bank code
bic	string	BIC/SWIFT
recipient_name	string	Recipient name
type	string	QR type (cz, sk, hu, epc)
enabled_currencies	array	Enabled currencies
enabled_countries	array	Enabled countries
label	string	Info label

Example: Dynamic Account Based on Amount

add_filter( 'wpify_woo_qr_account_data', function( $account, $order ) {
    // For orders over 10000 CZK use a different account
    if ( $order->get_total() > 10000 && $order->get_currency() === 'CZK' ) {
        $account['number'] = '123456789';
        $account['bank_code'] = '0100';
    }
    return $account;
}, 10, 2 );

Logging

The module logs errors when generating QR codes to a log available in the administration:

WPify Woo → WPify Logs

Logged Events

Event	Description
QR generation error	Failure when creating QR code (invalid data, library exception)
Unsupported currency	Order currency does not match QR standard

Log Example

[2024-01-15 10:30:45] ERROR: QR payment: error create QR code.
{
    "data": {
        "order_id": 1234,
        "message": "Invalid IBAN format",
        "payment_details": { ... }
    }
}

File Locations

File	Path
QR images	wp-content/uploads/qr-payment/
Logs	wp-content/uploads/logs/