Complete list of error codes from the SDK, shared package, and API.
SDK errors
| Code |
Class |
Description |
sdk_error |
SDKError |
Missing chain/wallet, auth failures, wallet mismatch |
api_error |
APIError |
Non-OK HTTP response |
payment_required |
PaymentRequiredSDKError |
Payment rejected after retry |
Payment errors
| Code |
Description |
payment_required |
No valid X-PAYMENT header |
payment_validation_error |
Invalid payment proof format |
payment_verification_failed |
On-chain verification failed |
payment_expired |
Requirement past expiresAt |
payment_reused |
Transaction already used |
payment_replay |
Nonce or hash replay detected |
unsupported_chain |
Chain not in accepts array |
insufficient_amount |
Paid amount below required |
Execution errors
| Code |
HTTP |
Description |
endpoint_unavailable |
503 |
Endpoint disabled or unhealthy |
execution_failed_after_payment |
502 |
Upstream failed after capture; refund may be recommended to the API provider |
refund_recommended |
502 |
Galliun recorded a refund recommendation — the provider refunds from their wallet |
Auth errors
| Code |
Description |
unauthorized |
Missing or invalid bearer token |
forbidden |
Insufficient permissions |
not_found |
Resource not found |
Refund recommendation statuses
Galliun does not issue on-chain refunds. When execution fails after payment, the platform may create a refund recommendation for the API provider to action.
| Status |
Description |
recommended |
Refund recommended to the API provider |
provider_notified |
Provider has been notified |
provider_refunded |
Provider confirmed refund (manual tx tracking) |
provider_declined |
Provider declined to refund |
closed |
Recommendation closed |
Next steps