PROMO-1256: Added prefix, suffix and code_length fields for bulk coup…

[bc-anshumishra]

https://bigcommercecloud.atlassian.net/browse/PROMO-1256

What changed?

• Added prefix, suffix and code_length fields for bulk coupon api /v3/promotions/{promotion id}/codegen

Release notes draft

We're happy to announce new enhanced controls for bulk coupon code generation! This feature can help you organize and track your promotions better by allowing you to define a static prefix (e.g., HOLIDAY-) and a static suffix (e.g., -VIP) for all your codes. By controlling the code length and these static fields, you can generate clean, structured codes that are easy for both you and your customers to read.

Anything else?

We will merge it after turning on experiment PROJECT-5165.bulk_coupon_codegen_api_enhancements

ping @bc-anshumishra

[Copilot]

Pull Request Overview

This PR adds new bulk coupon code generation fields to the promotions API specification, providing enhanced control over generated coupon codes through customizable prefixes, suffixes, and code length parameters.

Key Changes

• Added three new optional fields to the bulk coupon generation API: prefix, suffix, and code_length
• Established validation patterns and constraints for consistent code formatting
• Enhanced API flexibility for organized coupon code management

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

The regex pattern '[A-Z0-9_-]' only matches a single character, but the field descriptions indicate these are for text/strings that can contain multiple characters. The pattern should be '[A-Z0-9_-]*' or '[A-Z0-9_-]+' to match zero or more, or one or more characters respectively.

Suggested change

	pattern: '[A-Z0-9_-]'
	type: string
	description: 'The fixed text or characters that will appear at the beginning of every generated coupon code. Only capital letters, numbers, underscores and hyphens are allowed.'
	example: PRE-
	maxLength: 20
	suffix:
	pattern: '[A-Z0-9_-]'
	pattern: '[A-Z0-9_-]*'
	type: string
	description: 'The fixed text or characters that will appear at the beginning of every generated coupon code. Only capital letters, numbers, underscores and hyphens are allowed.'
	example: PRE-
	maxLength: 20
	suffix:
	pattern: '[A-Z0-9_-]*'

[Copilot]

The regex pattern '[A-Z0-9_-]' only matches a single character, but the field descriptions indicate these are for text/strings that can contain multiple characters. The pattern should be '[A-Z0-9_-]*' or '[A-Z0-9_-]+' to match zero or more, or one or more characters respectively.

Suggested change

	pattern: '[A-Z0-9_-]'
	type: string
	description: 'The fixed text or characters that will appear at the beginning of every generated coupon code. Only capital letters, numbers, underscores and hyphens are allowed.'
	example: PRE-
	maxLength: 20
	suffix:
	pattern: '[A-Z0-9_-]'
	pattern: '[A-Z0-9_-]*'
	type: string
	description: 'The fixed text or characters that will appear at the beginning of every generated coupon code. Only capital letters, numbers, underscores and hyphens are allowed.'
	example: PRE-
	maxLength: 20
	suffix:
	pattern: '[A-Z0-9_-]*'

[YevenLourance]

do we want to indicate the default values for prefix, suffix and code_length if they are not set in the request?

[bc-anshumishra]

There is no default value for prefix and suffix.
The default value for code_length is 16. I have added it in description.