Get started / GiftU Partner API
Errors & rate limits
Use HTTP status and error.code together. Preserve requestId so GiftU can trace a failed request.
Common errors
400 / 6205 — invalid input. 401 / 6200 — authentication failed. 404 / 6207 — product unavailable. 404 / 6211 — order not found. 404 / 6216 — statement not found. Resources outside your partner or mode are indistinguishable from unknown resources.
409 / 6209 — insufficient prepaid balance. 409 / 6210 — credit limit exceeded. 409 / 6220 — reference reused with a different purchase payload. 503 / 6206 — catalog temporarily unavailable. 503 / 6201 — new purchases disabled. 500 / 6227 — unexpected failure.
Respect rate limits
HTTP 429 / code 6218 includes Retry-After in seconds. Wait at least that long before retrying, and use backoff with jitter. Limits can apply to both client IP and authenticated partner traffic; the quota is deployment-specific.
Retry with the same purchase identity
Fix validation and authentication errors before resending. For ambiguous purchase failures, reconcile by the existing partnerReference and keep the same body for any replay. Never rotate the reference just to get past an error.