Shopify storefront engineering · field note

Ask HN: Feedback on our API?

A working diagnosis of this problem and the sequence that actually resolves it, written from the operational side rather than the marketing side.

Reported context: SupportBee is a single page backbone.js app and as a result we have been building out a robust API. We believe that a good API plays a major role in developer adoption which ultimately leads to a more useful product. Therefore we would love to get your feedback on our API. We have built some small apps based on the API and webhooks. Checkout a campfire notifier - https://github.com/avinasha/marvin and a sms notifier

What is actually going on

Checkout failures are usually caused by a carrier rate mismatch, a conflicting discount script, or a payment gateway that does not support the buyer's currency or region.

Cart recovery leaks happen when the recovery email fires before the buyer's session expires, or when the discount code in the email has already expired by the time it is opened.

The sequence that works

  1. Reproduce the failure in a clean browser with a real destination address and a real payment method in test mode. Log the exact gateway response code.
  2. Disable all discount scripts, then re-enable one at a time to isolate the conflict.
  3. Rebuild cart recovery timing: first touch at 1 hour, second at 24 hours, third at 72 hours with a freshly minted code, each with a distinct message angle.
  4. Audit every app for where it injects assets. Move non-critical scripts to deferred loading and remove apps that duplicate native functionality.
  5. Measure again with field data, not lab data — lab scores on fast hardware hide the real mobile experience.

Where people lose time

Verify before you trust it

Run the checks above against your own data instead of adopting them at face value. The failure modes are specific enough that a single afternoon of measurement will either confirm this diagnosis or rule it out — both outcomes are useful, and guessing is not.

Automation Workflow Pack
A ready-to-use package for exactly this workflow — $27.55, delivered immediately.
Get Automation Workflow Pack · $27.55
Sold via Gumroad, which acts as merchant of record and handles payment and applicable taxes. All sales are final; see the return policy before purchase.