When a request to the Zinc API fails, you’ll receive a structured error response.

​
Example Error Response

{
  "_type": "error",
  "code": "product_unavailable",
  "message": "One of the products you selected is unavailable.",
  "data": { "product_id": "018293801" }
}
Every error object contains:
  • code: A short, unique error code describing the error.
  • message: A human-readable message for developers (not end users).
  • data: Additional information about the error (e.g., product ID, max quantity, etc.).

​
Zinc Error Codes

Error CodeMeaning
account_lockedThe retailer asked for additional information to verify your account.
account_locked_verification_requiredThe retailer emailed you a code which you must supply to continue ordering. More Info
account_login_failedWe were unable to log in to the retailer with the provided username and password.
add_on_itemAdd-on items cannot be ordered individually.
additional_information_requiredRetailer asked for additional account verification questions. If using the API, please add a field phone_number in the billing address that matches your billing telephone number.
billing_address_refusedThe billing address you provided was refused by the retailer.
brand_not_acceptedYour credit card brand is not accepted with this merchant.
cannot_schedule_deliveryItem requires scheduled delivery options that Zinc does not support.
credit_card_declinedThe credit card you entered was declined.
duplicate_orderThis order is a duplicate.
expired_product_idThe product_id you used is no longer supported by the retailer.
incomplete_account_setupYou attempted to place an order with an account that has not been fully set up.
insufficient_zma_balanceInsufficient funds in your Managed Account Balance to complete the order.
insufficient_variantsYou did not select all required variants for a product.
internal_errorZinc or the retailer is experiencing outages. Try again or contact support if it persists.
invalid_addressThe provided address was incomplete or could not be parsed. Try providing an address in canonical Zinc format rather than free-form text.
invalid_card_numberThe credit card number you entered is not valid.
invalid_client_tokenYour client token is invalid.
invalid_expiration_dateThe expiration date on your credit card is not valid.
invalid_gift_optionsThe gift options you provided were rejected by the retailer.
invalid_jsonThe JSON in your request could not be parsed.
invalid_login_credentialsThe email and password you entered were incorrect.
invalid_payment_methodThe payment method provided is not available on the retailer.
invalid_promo_codeOne of the promotion codes you entered was not valid.
invalid_quantityThe quantity for one of the products does not match the one available on the retailer.
invalid_requestValidation failed on the request.
invalid_request_idThe provided request_id is invalid.
invalid_security_codeThe security code you entered was declined.
invalid_shipping_methodThe shipping method you selected was not valid.
invalid_variantOne of the product variants you provided was not valid.
item_not_supportedThe item is not supported via the buyapi (likely a digital or handmade item).
manual_review_requiredThis order is under manual review by Zinc. please check back later for the status of this order.
max_price_exceededThe retailer’s final price exceeds the maximum price.
max_quantity_exceededYou have exceeded the maximum quantity available for a specific product.
max_delivery_days_exceededThe retailer’s estimated delivery date exceeds the max_delivery_days parameter.
mismatching_retailerProduct URLs were provided for multiple retailers, or an explicit retailer was provided, but it did not match the provided URLs. Try again using only products from a single retailer.
no_free_shippingFree shipping is not available for the item(s) you selected.
no_gift_shippingNo gift shipping was available on this order.
no_two_day_shippingTwo day shipping (or faster) is not available for the item(s) you selected.
order_probably_placedOrder likely placed, but merchantorder IDs couldn’t be retrieved. Check the retailer site; if placed, cancel before retrying.
payment_info_problemThere was a problem with your payment information.
prime_pantry_not_supportedPurchasing Prime Pantry items is not supported by the Zinc API.
product_unavailableOne of the products you selected is not available on the retailer. Either seller selection criteria did not match any available offers or the product is out of stock.
request_processingRequest is currently processing and will complete soon.
shipping_address_refusedThe shipping address you provided was refused by the retailer.
shipping_address_unavailableThe item(s) cannot be shipped to the selected shipping address.
shipping_method_unavailableThe selected shipping_method is not available for the selected shipping_address.
unauthorized_accessYou are not authorized to make this API call. Please contact support@zinc.io.
unknown_retailerThe provided product URLs did not correspond to a known supported retailer.
unsupported_product_idThe item product_id is not specific enough. Choose a specific product_id to order.
zma_temporarily_overloadedThe ZMA system was unable to place your order within 4 hours.Try again later, or check your parameters.
If you are still having issues, contact support@zinc.io.