Skip to content
Search Articles/

less than a minute read • Updated 39 minutes ago

Set a custom receipt display ID

How to enable a sequential, customizable receipt display ID — with a starting value, minimum length, prefix, and suffix — in place of the default global transaction ID.

By default, Foxy assigns each transaction a unique numerical global transaction ID, which won’t necessarily be sequential within your store. You can enable a custom ID instead, which is sequential and can be customized with a specific start number, length, and prefix/suffix.

Steps

  1. 1

    Go to the Foxy admin.

  2. 2

    Go to Settings > Receipts.

  3. 3

    Under the Web receipt section enable the Customize Transaction ID option.

  4. 4

    Configure the options that appear:

    • Start Value — the starting number for the next transaction’s custom ID. Setting this to 1 makes the next transaction’s custom display ID 1. Default: 1.

    • Minimum Length — the minimum total length of the auto-incrementing part of the ID. Shorter numbers are padded with leading zeros. For example, a length of 8 turns a first ID of 1 into 00000001. Default: 1.

    • Prefix — a value added to the start of the ID. For example, a prefix of inv- produces an ID like inv-1.

    • Suffix — a value added to the end of the ID. For example, a suffix of _2017 produces an ID like 1_2017.

Notes

  • Enabling a custom display ID only applies to new transactions placed after it’s turned on. Transactions placed before it was enabled keep their original global transaction ID.

  • Once you start using a custom display ID, you can only raise the start value — you can’t set it lower than the last custom display ID already used on your store.

  • Custom IDs may skip numbers and aren’t guaranteed to be perfectly sequential. This can happen because an ID sometimes needs to be reserved before it’s submitted to the payment gateway, or because some gateways won’t accept the same ID twice on a payment retry.

  • To find transactions by custom ID, use the Display Id filter in the admin’s transactions report, or filter by display_id in the API.

Need Help?

Did this article answer your questions? Need help with anything? Please click below to contact us.