Job Stuck via the API
Getting Started
This article explains why an API-submitted job may appear stuck or not moving through production, and how you can resolve and prevent this issue.
In This Article
- Common Reasons Jobs Get Stuck
- Resume Jobs Stopped by Test Mode
- Resume Jobs Awaiting Payment
- Why This Process Works This Way
- Tips to Prevent Future Issues
Common Reasons Jobs Get Stuck
There are two main reasons an API job may appear stuck:
Test Mode
Your API may be in Test Mode. When in test mode, jobs will not proceed through production.
Insufficient Funds
If you submit a job without enough funds in your account to cover the cost, the job will enter the system but await payment.
Resume Jobs Stopped by Test Mode
To process jobs stopped by Test Mode:
- Check if Your Account is in Test Mode
- An API account in Test Mode will have "Account in Test Mode" highlighted in yellow at the top of the web page.
- Disable Test Mode
- Visit the API Information page under My Account.
- Approve Pending Jobs
- Any jobs that need to be sent will need to be approved to continue
Note: Make sure you fully understand the implications before switching out of Test Mode, as this can have unintended consequences.
Resume Jobs Awaiting Payment
To process jobs that are awaiting payment:
- Add Funds to Your Account
- Go to the Billing Information page to add funds to your PrePay Balance
- Complete the Checkout Process
- Simply adding funds does not automatically release jobs from the shopping cart.
- Go to the Shopping Cart to finalize payment and release the job into production.
Why This Process Works This Way
Some customers use both the website manually and through the API. If adding funds automatically pushed all pending jobs through checkout, you might accidentally mail jobs that are not yet approved or intended for production.
Tips to Prevent Future Issues
- Maintain Adequate Funds
- Keep your account properly funded to avoid delays.
- Set Up Low Balance Alerts
- Go to the Billing Information page.
- Enter your email address and specify a low balance threshold.
- You will receive a notification when your balance drops below the set amount.