Skip to content
GiftUdevelopers
GuidesAPI referencev1.0.1

Get started / GiftU Partner API

Testing your integration

Exercise success, pending fulfillment, and recovery using a TEST key before requesting LIVE activation.

Choose a TEST scenario

TEST-SUCCESS: returns synthetic credentials. TEST-PENDING: keeps fulfillment unresolved for polling and review scenarios. TEST-FAIL: produces a definitive failure for OneCard products, while final-sale GiftU products remain unresolved for review. Append a unique suffix to each intentional test purchase.

Choose a TEST scenario
TEST-SUCCESS:your-order-001
TEST-PENDING:your-order-002
TEST-FAIL:your-order-003

Prove retry behavior

Send the exact purchase body twice and confirm the same order identity. Reuse the reference with a different SKU and verify conflict handling. Simulate a lost response and recover the order by reference without generating another purchase.

Move to LIVE with GiftU

Verify authentication failures, insufficient purchasing capacity, pagination, nullable fields, and PROCESSING polling. Coordinate LIVE access, funding or credit terms, and any egress allowlist with GiftU. Use the LIVE collection and a separate private environment for its key.

Up nextErrors & rate limits
Need help with your integration?Talk to the GiftU team