Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sp3ndpay.shop/llms.txt

Use this file to discover all available pages before exploring further.

Error Format

{
  "error": {
    "code": "error_code",
    "message": "Human-readable description",
    "request_id": "req_xxx"
  }
}

HTTP Status Codes

CodeMeaning
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Rate Limit
500Server Error

Authentication Errors

invalid_api_key (401)
{"error": {"code": "invalid_api_key", "message": "API key invalid or revoked"}}
missing_api_key (401)
{"error": {"code": "missing_api_key", "message": "No API key in header"}}
rate_limit_exceeded (429)
{"error": {"code": "rate_limit_exceeded", "message": "Rate limit exceeded"}}

Product Errors

invalid_url (400)
{"error": {"code": "invalid_url", "message": "Not valid Amazon or eBay link"}}
product_unavailable (404)
{"error": {"code": "product_unavailable", "message": "Product unavailable"}}
unsupported_marketplace (400)
{"error": {"code": "unsupported_marketplace", "message": "Marketplace not supported"}}

Cart Errors

cart_not_found (404)
{"error": {"code": "cart_not_found", "message": "Cart not found or expired"}}
cart_expired (400)
{"error": {"code": "cart_expired", "message": "Cart expired, create new"}}
shipping_unavailable (400)
{"error": {"code": "shipping_unavailable", "message": "Cannot ship to destination"}}

Order Errors

order_not_found (404)
{"error": {"code": "order_not_found", "message": "Order not found"}}
invalid_address (400)
{"error": {"code": "invalid_address", "message": "Address invalid or incomplete"}}
wallet_screening_failed (403)
{"error": {"code": "wallet_screening_failed", "message": "Wallet failed screening"}}

Best Practices

Retry Logic:
  • Retry 429 and 5xx errors with exponential backoff
  • Don’t retry 4xx errors (except 429)
Logging:
  • Always log request_id for support
User Messages:
  • Map error codes to user-friendly messages
  • Don’t expose technical details to users

Contact Support

Get help with errors