Introducing the Better Auth Chargebee plugin: Use it to handle subscriptions, billing, and auth seamlessly.
Chargebeechargebee API
List of ErrorsThe gift card transaction was not tagged correctly. This can happen when the transaction is not marked as a gift card transaction, standard payment transaction types are used instead of dedicated gift card types, or the gateway configuration does not handle gift card transactions properly.

Recommended Customer Message

There was a problem with your Gift Card. Please try again, and if the issue persists, contact our customer service.

Root Cause

  • Incorrect transaction tagging: The transaction was not marked correctly as a gift card transaction, leading to processing failures.
  • Unsupported transaction types: Standard payment transaction types were used instead of dedicated gift card transaction types like giftCardCapture, giftCardCredit, or giftCardAuthReversal.
  • Gateway configuration issue: The gateway is not set up to automatically handle gift card transactions without explicit tagging.

Troubleshooting and Solutions

  • Verify that the payment integration properly tags gift card transactions during processing.
  • Retry the transaction after correcting the transaction type and tagging.
  • Contact the payment gateway support team if the issue persists despite correct tagging.
  • Clearly communicate to customers if there are any specific steps required when using gift cards for payments.
  • Reach out to Chargebee support if the payment gateway recommends any changes in the integrations to support gift cards specifically.