Find out what is accepted
Rather than guessing at values, ask:400 with INVALID_PARAMETER.
The fields
Pattern and shape
Pattern and shape
Colours
Colours
background_style and background_color_secondary. For no background at all, is_transparent_background=true — useful over a printed design, risky over a busy one.Centre logo
Centre logo
center_logo_text.Frame and caption
Frame and caption
Staying scannable
QR codes tolerate damage, which is what lets you put a logo in the middle. That tolerance is finite, and three things spend it:Contrast is not optional
Contrast is not optional
The pattern must be substantially darker than the background. Light grey on white looks refined and fails in poor lighting, which is most of the places a QR code gets scanned.Dark pattern on light background. Inverting — light pattern on dark — is rejected outright by some scanners.
Keep the logo small
Keep the logo small
Around 3rem is a reasonable ceiling. A logo past that eats the error correction budget, and the first thing to fail is a code that is slightly dirty, slightly creased, or scanned at an angle — in other words, a real one.
Longer URLs make denser codes
Longer URLs make denser codes
The destination is encoded in the pattern, so a long URL means finer detail, which means a larger print size to stay readable. A short back half is not just tidier, it is a smaller printable code.