Skip to content

Convera API Error Codes Documentation

The Convera API Suite uses standardized error codes to diagnose issues from data validation to payment processing. This document organizes those error codes into categories for clarity and ease of troubleshooting.


1102 - Invalid Quote

Error Description: Quote not generated for order commit.
Conditions: Quote ID not generated before attempting to commit an order.
Actions to Take: - Establish a valid Quote ID before attempting to commit an order. - Additional Note: There may be an issue with the transaction needing to be quoted. Set the status to "ToBeQuoted".


1236 - Duplicate Payment ID in Batch

Error Description: The payment ID is duplicated in the batch.
Conditions: A duplicate payment ID exists in the batch commit request.
Actions to Take: - Ensure the payment ID is unique across the batch. - Additional Note: The payment ID has been duplicated within the batch. Please check the batch for duplicates and adjust accordingly.

General API Error Codes

Error Code Error Description Conditions Actions to Take
1000 Generic web service error An unhandled exception has occurred Retry 2–3 times over 5 minutes. Contact support if it persists.
1001 Access denied Invalid client certificate or API token Ensure proper authorization or request access.
1003 Required field validation error Missing required field Populate the missing field (e.g. 1003: paymentMethod).
1004 Conditional field validation error Conditional field missing or empty Refer to API Reference for conditional field requirements.
1005 Input field value validation error Syntax or format is invalid Review expected datatype and syntax.
1006 Unexpected field submitted Field not part of API model Remove unsupported fields from the request.
1007 Defined limit exceeded Exceeded max resource limit (e.g., webhook endpoints) Update or delete existing resources.
1100 Generic web service error Unhandled exception Retry. Contact support if needed.
1101 Resource not found Resource does not exist Ensure resource is created before using.
1102 Invalid quote Missing quote for order commit Generate a valid Quote ID.
1103 Quote expired Quote expired before commit Regenerate quote ID.
1104 Payment update not supported Payment already created Delete and recreate the payment.
1105 Payment cannot be cancelled Payment in workflow or irrevocable Contact support.
1107 Customer not found Invalid or unregistered customer ID Register or correct the customer ID.
1108 Duplicate settlement currency Same currency used multiple times in batch Remove duplicate currency entries.
1109 Settlement currency not determined Missing default or specified currency Provide default or specify in request.
1110 Extra settlement currency provided Currency not in original batch Match payment and batch currencies.
1111 Insufficient holding balance Not enough funds for transaction Add funds or change settlement method.
1112 Currency not supported Unsupported currency Use a supported currency.
1113 Payments added to committed/deleted batch Batch is not modifiable Create a new batch.
1114 Duplicate currency pair Duplicate currency pair in quote request Ensure each pair is unique.
1115 Unsupported currency + payment method Combination not supported Use a supported combination.
1116 Invalid payment method Not recognized or unsupported Use a valid payment method.
1117 Invalid remittance type Unsupported remittance type Specify a valid remittance type.
1118 Remittance type mismatch Not valid for the given context Verify remittance type for region/currency/etc.
1120 Primary webhook cannot be deleted Multiple webhooks exist Delete secondary webhooks first.
1206 Empty batch No payments in batch Add valid payment before quoting/committing.
1207 Inconsistent fixed amount One payment differs in fixed amount Standardize fixed amount for currency pair.
1209 Exceeds debit limit Order exceeds debit limit Adjust amount or settlement method.
1210 Settlement method not configured Method not set up for customer Contact support or use a different method.
1211 Below minimum amount Amount too small Increase amount or use a different currency.
1212 Exceeds maximum amount Amount too large Adjust payment method, amount, or currency.
1213 Currency not holding-enabled Currency not eligible Use a different currency.
1217–1219 Instruction/commit errors Instruction generation failed Contact Convera support.
1222 FAB validation failed FAB service input error Review and correct input fields.
1223 Invalid country code Not ISO 3166 alpha-2 or unsupported Provide a valid code.
1224 Multiple payments in restricted batch Not allowed (e.g., Dodd-Frank) Create a new batch.
1225 Non-Dodd-Frank payment in disclosure Disclosure request invalid Submit a Dodd-Frank payment first.
1226 Invalid SWIFT format SWIFT code must be 8 or 11 alphanumeric Correct format.
1229 PO boxes not allowed For Canadian addresses Remove PO boxes.
1230 Duplicate batch Batch ID already used Submit a unique batch ID.
1236 Duplicate Payment in Batch The payment id is duplicated in the batch

Find-A-Bank Error Codes

Error Code Description
Err1011 Invalid country (code/name)
Err1012 Invalid IBAN
Err1018 Mandatory fields missing
Err1019 Missing SWIFT/Routing Code, bank name + city required
Err1020–Err1022 IBAN country mismatch
Err1024 Invalid IBAN length
Err1026 Invalid checksum
Err1029 Invalid IBAN account number
Err1031 IBAN not supported by specified bank country
Err1032 Invalid currency
Err1033 Unauthorized request
Err1034 Bank branch not found in database
Err1035 Missing required bank identification
Err1036 Invalid search parameters
Err1037 Authorization connection failure
Exp1000 Exception occurred – contact support
War1014 Too many results – refine search
War1015 No matching records found

Notice of Change (NOC) Codes

NOC Code Description
C01 Incorrect bank account number
C02 Incorrect routing number
C03 Incorrect routing + account number
C05 Incorrect payment code (e.g., savings vs demand)
C06 Incorrect account + transit code
C07 Incorrect account, routing, and payment code

Rejection Codes

Error Code Description Action
ER001–ER007 Missing/invalid fields like country, type, tax ID Provide correct data
ER008–ER039 SWIFT/MT103 format or field errors Contact Convera or validate values
ER041 Beneficiary street address missing Supply address
ER995 Rejected by GPG See attached reason
ER997–ER998 GPG configuration errors Contact Convera
SWF_ERROR: T28–T29 Invalid SWIFT destination Fix SWIFT BIC code
NARR Custom bank message Follow bank’s instructions

Return Codes

Return Code Description
RTN01–RTN05 Account closed/invalid, mismatched data
RTN06–RTN07 Beneficiary unresponsive
RTN08–RTN12 Invalid/incomplete payment details
RTN13 Rejected due to compliance
RTN14 Returned per recall request
RTN15 Missing bank endorsement (drafts)
RTN16–RTN19 Insufficient info or explanation
RTN20–RTN24 Internal bank policies or duplicate
RTN25–RTN26 Duplicate or FX compliance
RTN27–RTN28 Missing/invalid intermediary bank info
RTN29–RTN30 SEPA only or overpayment
RTN31–RTN34 Beneficiary-related or refund
RTN35 Stale dated draft

Note: For any unresolved or unclear errors, please contact the Convera Customer Support Team for further assistance.