This section summarizes generated errors in PB APIs (v1.1 and v1.2) into two tables.
The first shows the message and html codes of errors generated per API and path, while the second matches each message error code-description with the corresponding html error-description.
Table 1: Expected Error Codes per API & Path
API | Path | Error Codes |
Assets/Accounts | / | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Assets/Accounts | /{accountId}/details | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Assets/Accounts | /{accountId}/transactions | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-008 (412) api-026 (501) |
Assets/Accounts | /{iban}/info | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Assets/Cards | /list | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Assets/Cards | /credit/list | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Assets/Cards | /debit/list | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Assets/Cards | /prepaid/list | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Assets/Cards | /{cardId}/details | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) api-029 (412) |
Assets/Cards | /{cardId}/transactions | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) api-029 (412) |
Assets/Cards | /credit/{cardId}/details | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) api-029 (412) |
Assets/Cards | /credit/{cardId}/transactions | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) api-029 (412) |
Assets/Cards | /credit/{cardId}/statements | api-027 (501) |
Assets/Cards | /debit/{cardId}/details | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) api-029 (412) |
Assets/Cards | /debit/{cardId}/transactions | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) api-029 (412) |
Assets/Cards | /prepaid/{cardId}/details | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) api-029 (412) |
Assets/Cards | /prepaid/{cardId}/transactions | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) api-029 (412) |
Customer | /info | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-010 (412) api-026 (501) |
Lookups | /toiban/{accountnumber} | api-001 (400) |
Lookups | /verifyiban/{iban} | api-001 (400) |
Lookups | /pop/list | api-001 (400) |
Lookups | /pop/{pointtypename}/list | api-001 (400) api-024 (412) |
Lookups | /countries/list | api-001 (400) api-002 (401) |
Security | /{tokentype}/generate/force | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-014 (401) api-017 (412) api-019 (403) api-026 (501) |
Security | /{tokentype}/generate | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-014 (401) api-017 (412) api-019 (403) api-026 (501) |
Security | /token/validate/{tokenvalue} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-015 (412) api-017 (412) api-018 (401) api-019 (403) api-020 (403) api-021 (403) api-022 (401) api-023 (403) api-025 (412) api-026 (501) |
Security | /{tokentype}/validate/{tokenvalue} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-015 (412) api-017 (412) api-018 (401) api-019 (403) api-020 (403) api-021 (403) api-022 (401) api-023 (403) api-025 (412) api-026 (501) |
Security/Approvals | / | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-019 (403) |
Security/Approvals | /count | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-019 (403) |
Security/Approvals | /{approvalKey} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-019 (403) |
Transactions | /payroll | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-013 (404) api-016 (412) api-019 (403) api-026 (501) api-028 (412) |
Transactions | /payroll/validate | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-016 (412) api-019 (403) api-026 (501) api-028 (412) |
Transactions | /payroll/execute/{SessionKey} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-013 (404) api-016 (412) api-019 (403) api-026 (501) |
Transactions | /payroll/history | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) |
Transactions | /payroll/{PaymentCode}/details | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions | /bulkPayment | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-013 (404) api-016 (412) api-019 (403) api-026 (501) api-028 (412) |
Transactions | /bulkPayment/validate | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-016 (412) api-019 (403) api-026 (501) api-028 (412) |
Transactions | /bulkPayment/execute/{SessionKey} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-013 (404) api-016 (412) api-019 (403) api-026 (501) |
Transactions | /bulkPayment/history | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) |
Transactions | /bulkPayment/{PaymentCode}/details | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions | /transferToIban | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-013 (404) api-016 (412) api-019 (403) api-026 (501) |
Transactions | /transferToIban/validate | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-016 (412) api-019 (403) api-026 (501) |
Transactions | /transferToIban/execute/{SessionKey} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-013 (404) api-016 (412) api-019 (403) api-026 (501) |
Transactions | /history/{input_filter} | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) |
Transactions | /{input_filter} | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) |
Transactions | / | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) |
Transactions | /{paymentOrderId}/details | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions | /{paymentOrderId}/history | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions | /creditTransfer | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-013 (404) api-016 (412) api-019 (403) api-026 (501) |
Transactions | /creditTransfer/validate | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-016 (412) api-019 (403) api-026 (501) |
Transactions | /creditTransfer/execute/{SessionKey} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-013 (404) api-016 (412) api-019 (403) api-026 (501) |
Transactions | /bulkPayment/prepare | api-002 (401) |
Transactions/Payments | /instant/{BeneficiaryAlias} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-019 (403) api-026 (501) api-030 (412) |
Transactions/Payments | /instant/validate/{BeneficiaryAlias} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-019 (403) api-026 (501) api-030 (412) |
Transactions/Payments | /instant/execute/{SessionKey} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-011 (401) api-019 (403) api-026 (501) api-030 (412) |
Transactions/Payments | /{input_filter} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions/Payments | /codes | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions/Payments | /codes/{paymentCode} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions/Payments | /{paymentCode} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) api-031 (412) |
Transactions/Payments | /{paymentCode}/validate | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) api-031 (412) |
Transactions/Payments | /{paymentCode}/execute/{SessionKey} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions/Remittances | / | api-001 (400) api-002 (401) api-003 (412) api-004 (412) api-005 (412) api-006 (440) api-007 (404) api-026 (501) |
Transactions/Remittances | /history/{input_filter} | api-002 (401) api-026 (501) |
Transactions/Remittances | /delete/{Reference} | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-013 (404) api-026 (501) |
Transactions/Remittances | /delete/{Reference}/validate | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-026 (501) |
Transactions/Remittances | /delete/{Reference}/execute | api-001 (400) api-002 (401) api-006 (440) api-007 (404) api-013 (404) api-026 (501) |
Transactions/Remittances | /advice | api-002 (401) api-027 (501) |
Transactions/Remittances | /confirmation | api-002 (401) api-027 (501) |
Table 2: Message & HTML Error Codes/Descriptions
Message Error Code | Message Error Description | Http Error Code | Http Error Description |
api-001 | 400 | Bad Request | |
api-002 | […] . Please get authorized first. | 401 | Unauthorized |
api-003 | Invalid fromDate | 412 | Precondition Failed |
api-004 | Invalid toDate | 412 | Precondition Failed |
api-005 | toDate Smaller Than fromDate | 412 | Precondition Failed |
api-006 | 440 | Login Time-Out | |
api-007 | 404 | Not Found | |
api-008 | Maximum page size is […], but […] was requested | 412 | Precondition Failed |
api-009 | 400 | Bad Request | |
api-010 | 412 | Precondition Failed | |
api-011 | Second factor authentication needed | 401 | Unauthorized |
api-012 | Second factor authentication, not required right now | 400 | Bad Request |
api-013 | Path […] not found | 404 | Not Found |
api-014 | Otp cannot be generated from api | 400 | Bad Request |
api-015 | Extrapin validation failed | 412 | Precondition Failed |
api-016 | Missing mass payment/payroll payload File upload, failed |
412 | Precondition Failed |
api-017 | Invalid token type: […] | 412 | Precondition Failed |
api-018 | 401 | Unauthorized | |
api-019 | User does not have second factor authentication mechanism configured | 403 | Forbidden |
api-020 | User doesnt have extrapin token type | 403 | Forbidden |
api-021 | User doesnt have OTP token type | 403 | Forbidden |
api-022 | OTP validation failed | 401 | Unauthorized |
api-023 | Otp validation failed. Reason: Pin Change Needed | 403 | Forbidden |
api-024 | Unknown point type […] | 412 | Precondition Failed |
api-025 | Extrapin validation failed. Error: Unknown validation result | 412 | Precondition Failed |
api-026 | 501 | Not Implemented | |
api-027 | This api, is not implemented in this version | 501 | No Permission Found For Route |
api-028 | 412 | Precondition Failed | |
api-029 | cardId not found | 412 | Precondition Failed |
api-030 | Customer is not registered for instant payment (Iris24/7) | 412 | Precondition Failed |
api-031 | Payment code […] is not valid. | 412 | Precondition Failed |
api-999 | [default] | 400 | Bad Request |