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": {
"code": "error_code",
"message": "Human-readable description",
"request_id": "req_xxx"
}
}
HTTP Status Codes
| Code | Meaning |
|---|
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 429 | Rate Limit |
| 500 | Server 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