Troubleshooting
Quick reference for common integration issues.
Authentication
| Issue | Solution |
|---|---|
401 Unauthorized | Check API key is correct and included in XApiKey header |
| Key not working | Generate a new key in Creditor Portal → API Keys |
See Authentication for setup details.
Case Creation
| Issue | Solution |
|---|---|
400 validation error | Check required fields — see Create a Case |
422 business error | Inspect the response shape. Typed businessErrors[] entries may include a solutionUrl for contract signing; field-keyed validation responses do not. |
"Must be unique" error | Your creditorReference already exists — use unique values |
See Create a Case — Error Handling for all error types.
Webhooks
| Issue | Solution |
|---|---|
| Not receiving events | Verify endpoint is HTTPS with valid certificate |
| Signature verification fails | Use raw body (not parsed JSON) and Base64-decode the secret |
| Webhook disabled | Check disabledReason and re-enable with "isActive": true |
See Webhooks — Troubleshooting for details.
Error Reference
For complete error handling across all APIs, see Error Handling.