Manually applying a gift card in an uncaptured order triggers a Level 3 invalid pricing error

[pierorocca]

Describe the bug

As reported by a top WooPayments client, on Dec 9th they manually applied a gift card to an uncaptured order and the encountered a Level 3 invalid pricing error.

Level 3 data submission requires that each line items, totals, discounts, etc. net out perfectly. We recently resolved an issue with gift cards and Level 3, however, that may not have been applied to manual application from the Orders screen. #9053

To Reproduce

1. Set store to capture manually
2. Shop and place an order with multiple simple products
3. Setup a gift card for $20 using the WooCommerce Gift Card plugin (I have not verified this is the plugin they're using)
4. Apply the gift card manually in the Orders screen
5. Observe the Level 3: Invalid Pricing error

[pierorocca]

@peterfabian do you think my hypothesis above is plausible or likely?

[peterfabian]

Hi @pierorocca .

I'm not totally sure how the payment is captured here. Does it happen in the context of WP Admin?

I'm not aware of a way how to trigger the payment via Woo Payments from WP Admin.

I've tried creating the order from the backend, adding a gift card code and then going to customer's payment page to pay for the order, but that one was processed correctly.

Either way, the WC Gift Card solution is hooked to Level3Service::get_data_from_order, which is afaik WooPayment's solution to get the level 3 data based on the given order. Whenever this is called, it should trigger Level 3 data update. If this method is skipped during any of the flows that submit Level 3 data, then the L3 data would be incorrect.

[pierorocca]

Hey @peterfabian the account first needs to change to manual capture in the WooPayments settings page.

Then purchase a few products from the front-end including a gift card so you can use the code.

Then in the admin, find the order and you'll see a button for an Admin to apply the gift card.

Apply it, hit recalc, then Update the order. I believe it's here where the Level 3 error occurred or when they then tried to capture the transaction in the Transactions page. I just tested it and I cannot replicate the error. Would you mind trying as well?

[dmvrtx]

I've tried to reproduce it, but when I add a gift card on the Order screen, as a merchant, and then capture a payment, Level 3 data contains information about the gift card:

2025-02-27T14:25:32+00:00 Debug 67c075dcad1a1-0002           array (
2025-02-27T14:25:32+00:00 Debug 67c075dcad1a1-0002             'discount_amount' => 1900,
2025-02-27T14:25:32+00:00 Debug 67c075dcad1a1-0002             'product_code' => '1',
2025-02-27T14:25:32+00:00 Debug 67c075dcad1a1-0002             'product_description' => 'WCGC 73',
2025-02-27T14:25:32+00:00 Debug 67c075dcad1a1-0002             'quantity' => 1,
2025-02-27T14:25:32+00:00 Debug 67c075dcad1a1-0002             'tax_amount' => 0,
2025-02-27T14:25:32+00:00 Debug 67c075dcad1a1-0002             'unit_cost' => 0,
2025-02-27T14:25:32+00:00 Debug 67c075dcad1a1-0002           ),

The relevant change was added to the WooCommerce Gift Cards plugin in July 2024.

Naturally, if any other Gift Cards plugin is being used, which doesn't intervene with updating Level 3 data, when the error would occur, but in this case it should be probably fixed by vendor.

@aheckler, I wonder if it is worth mentioning somewhere, how to achieve this compatibility for other vendors. There is a filter they can hook into to update Level 3 information in this way.

[aheckler]

@dmvrtx We usually try to keep the merchant-facing docs free of any developer-level / integration guidance. @brentmackinnon and the rest of the Dev Advocacy team might know of a better place for that kind of info.

[dmvrtx]

@pierorocca , I'm closing this one as it was fixed in our own plugins and for other vendors there is a way to hook in the Level3 data if there are merchant reports.