--- title: Card Status and Error Codes slug: card-status-and-error-codes docTags: createdAt: 2024-07-25T00:51:05.594Z --- This page lists all possible status and error codes for card transactions. It's recommended to handle 400 and 500 response codes generally and search this page when an unknown error is encountered, rather than handling every possible error individually. ## Status Codes Interim and Final statuses are returned as a card transaction is processed. Once a transaction reaches a Final state it will not be updated further. | **Status** | **Description** | **Status Type** | | ---------------------- | ---------------------------------------------------------------------------------------------- | --------------- | | Initiated | A client session has been created but the payment has not been attempted | Interim | | Pending | The payment has been created but is not yet authorised | Interim | | Authorized | The payment has been authorised by the card issuer | Interim | | Pending Settlement | The payment has been authorised and is awaiting settlement. This may occur when funds are held | Interim | | Settlement In Progress | The payment is being loaded to your account | Interim | | Settlement Complete | The payment has been loaded to your account | Final | | Failed | The payment failed to be authorised | Final | | Declined | The payment was declined by the card issuer | Final | | Cancelled | The payment authorisation has been cancelled | Final | ## Error Codes | **HTTP Status** | **Error Code** | **Meaning** | | --------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | | 400 | CCM\_ACCTID\_REQUIRED | mAccount is required | | 400 | CCM\_ACC\_DISABLED\_ERROR | Card transactions disabled for accountId \{0} | | 400 | CCM\_ACC\_EXISTS | Failed to create account - account already exists | | 400 | CCM\_ACC\_LIMIT\_REACHED | transaction amount \{0} plus existing transactions \{1} exceeds limit \{2} | | 400 | CCM\_ACC\_NOT\_FOUND\_ERROR | account not found for accountId \{0} | | 400 | CCM\_ACC\_UID\_NOT\_UNIQUE | More than one account \{0} is found | | 400 | CCM\_ACC\_UPDATE\_ERROR | Documents modified \{0}. Expected exactly 1 account updated. | | 400 | CCM\_AMOUNT\_INVALID | \{0} must be between 0 and \{1} | | 400 | CCM\_AMOUNT\_REQUIRED | \{0}.currencyAmount required | | 400 | CCM\_BILLADDR\_REQUIRED | \{0}.billingAddress required | | 400 | CCM\_BUSINESS\_RULE\_ERROR | startdate invalid | | 400 | CCM\_CARDTYPE\_REQUIRED | \{0}.cardType required | | 400 | CCM\_CC\_GATEWAY\_ERROR | Error returned from CC gateway - \{0} | | 400 | CCM\_CC\_GWM\_ERROR | Error returned from CC Gateway Manager - \{0} | | 400 | CCM\_COUNTRY\_INVALID | \{0}.countryCode must be valid ISO 2 character code | | 400 | CCM\_COUNTRY\_REQUIRED | \{0}.countryCode required | | 400 | CCM\_CRTD\_ENDDATE\_INVALID | createdEndDate must be later than createdStartDate | | 400 | CCM\_CRTD\_STARTDATE\_INVALID | createdStartDate must be past time | | 400 | CCM\_CRTD\_STARTDATE\_REQUIRED | createdStartDate is mandatory | | 400 | CCM\_CUSTOMER\_REQUIRED | customer required | | 400 | CCM\_DESC\_INVALID | \{0}.description \[\{PropertyValue}] must match \{RegularExpression} | | 400 | CCM\_DESC\_LENGTH | \{0}.description must not exceed \{MaxLength} | | 400 | CCM\_DESC\_REQUIRED | \{0}.description required | | 400 | CCM\_DETAILS\_REQUIRED | paymentDetails required | | 400 | CCM\_EMAIL\_INVALID | \{0}.emailAddress \[\{PropertyValue}] must be valid email address | | 400 | CCM\_EMAIL\_MAXLEN | \{0}.emailAddress cannot exceed \{MaxLength} | | 400 | CCM\_EMAIL\_REQUIRED | \{0}.emailAddress required | | 400 | CCM\_EMPTY\_BATCH\_ID | Empty BatchId. | | 400 | CCM\_EMPTY\_SETTLEMENTS\_LIST | Empty settlements list. | | 400 | CCM\_EMPTY\_SETTLEMENT\_DUPLICATE | Empty settlement duplicate. | | 400 | CCM\_EMPTY\_SETTLEMENT\_ORIGINAL | Empty settlement original. | | 400 | CCM\_EMPTY\_TRANSACTION\_UNIQUE\_REFERENCE | Empty TransactionUniqueReference. | | 400 | CCM\_FIRSTNAME\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_FIRSTNAME\_LENGTH | \{0}.firstName must not exceed \{MaxLength} | | 400 | CCM\_FIRSTNAME\_REQUIRED | \{0}.firstName required | | 400 | CCM\_FUNDS\_DECLINED | Funds reservation failed | | 400 | CCM\_JOBID\_INVALID | Async Job Id is not valid Guid - must use the UniqueRequestId returned by the originating call | | 400 | CCM\_JOB\_EXISTS | Failed to create AsyncJob - request already exists | | 400 | CCM\_JOB\_EXPIRED | Async job failed to complete within a reasonable time | | 400 | CCM\_LASTNAME\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_LASTNAME\_LENGTH | \{0}.lastName must not exceed \{MaxLength} | | 400 | CCM\_LASTNAME\_REQUIRED | \{0}.lastName required | | 400 | CCM\_MAPPING\_ERROR | Internal error - property \{0} value \{1} is invalid - expected one of \[\{2}]. Please contact Monoova support. | | 400 | CCM\_MRCH\_ADDR\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_CAT\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_MRCH\_CAT\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_COUNTRY\_NOTFOUND | \{0}.\{PropertyName} '\{PropertyValue}' is not valid | | 400 | CCM\_MRCH\_COUNTRY\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_EMAIL\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' must match \{RegularExpression} | | 400 | CCM\_MRCH\_EMAIL\_LENGTH | \{0}.\{PropertyName} '\{PropertyValue}' must not exceed \{MaxLength} | | 400 | CCM\_MRCH\_EMAIL\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_IND\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_NAME\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_MRCH\_NAME\_LENGTH | \{0}.\{PropertyName} must not exceed \{MaxLength} | | 400 | CCM\_MRCH\_NAME\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_PHONE\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' must match \{RegularExpression} | | 400 | CCM\_MRCH\_PHONE\_LENGTH | \{0}.\{PropertyName} '\{PropertyValue}' must not exceed \{MaxLength} | | 400 | CCM\_MRCH\_POSTCODE\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_MRCH\_POSTCODE\_NOTFOUND | \{0}.PostalCode is not defined for specified country | | 400 | CCM\_MRCH\_POSTCODE\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_STATE\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_MRCH\_STATE\_NOTFOUND | \{0}.State is not defined for specified country | | 400 | CCM\_MRCH\_STATE\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_STREET\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_MRCH\_STREET\_LENGTH | \{0}.\{PropertyName} must not exceed \{MaxLength} | | 400 | CCM\_MRCH\_STREET\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_MRCH\_SUBURB\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_MRCH\_SUBURB\_LENGTH | \{0}.\{PropertyName} must not exceed \{MaxLength} | | 400 | CCM\_MRCH\_SUBURB\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_PARENTUID\_INVALID | \{0}.clientParentTransactionUniqueReference \{PropertyValue} must match \{RegularExpression} | | 400 | CCM\_PARENTUID\_REQUIRED | \{0}.clientParentTransactionUniqueReference required | | 400 | CCM\_PCT\_PREPAID\_INVALID | \{0}.\{PropertyName} value \{PropertyValue} must be between \{From} and \{To} | | 400 | CCM\_PCT\_PREPAID\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_PG\_NUM\_INVALID | pageNumber must be greater than zero | | 400 | CCM\_PG\_SZ\_INVALID | pageSize must be between 1 and \{0} | | 400 | CCM\_POSTCODE\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_POSTCODE\_LENGTH | \{0}.postalCode must not exceed \{MaxLength} | | 400 | CCM\_POSTCODE\_REQUIRED | \{0}.postalCode required | | 400 | CCM\_PPDAYS\_INVALID | \{0}.\{PropertyName} value \{PropertyValue} cannot be less than \{ComparisonValue} | | 400 | CCM\_PPDAYS\_REQUIRED | \{0}.\{PropertyName} required | | 400 | CCM\_REASON\_INVALID | \{0}.refundReason \[\{PropertyValue}] must match \{RegularExpression} | | 400 | CCM\_REFUND\_LIMIT\_EXCEEDED | refundAmount \{0} exceeds available amount \{1} | | 400 | CCM\_REFUND\_REJECTED | "Refund rejected by payment processor 400,CCM\_REF\_EXISTING,existing refund status \{0} is not yet finalised""" | | 400 | CCM\_REF\_INVALID\_STATUS | parent transaction status \{0} invalid for refund | | 400 | CCM\_REF\_TOO\_LATE | the allowable refund period has expired for this transaction | | 400 | CCM\_REQUEST\_EMPTY | request payload is empty | | 400 | CCM\_REQ\_BODY\_INVALID | Error parsing badly formed request message - \{0} | | 400 | CCM\_STATE\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_STATE\_LENGTH | \{0}.state must not exceed \{MaxLength} | | 400 | CCM\_STATE\_REQUIRED | \{0}.state required | | 400 | CCM\_STATUS\_INVALID | Status \{PropertyValue} is invalid - must be one of \[\{0}] | | 400 | CCM\_STREET\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_STREET\_LENGTH | \{0}.street must not exceed maximum length 37 for Amex or 60 for Visa/Mastercard | | 400 | CCM\_STREET\_MAX\_LINES | \{0}.street cannot exceed 2 lines | | 400 | CCM\_STREET\_MIN\_LINES | \{0}.street must contain at least 1 line | | 400 | CCM\_STREET\_REQUIRED | \{0}.street required | | 400 | CCM\_SUBURB\_INVALID | \{0}.\{PropertyName} '\{PropertyValue}' invalid. Must match \{RegularExpression} | | 400 | CCM\_SUBURB\_LENGTH | \{0}.suburb must not exceed \{MaxLength} | | 400 | CCM\_SUBURB\_REQUIRED | \{0}.suburb required | | 400 | CCM\_TRN\_EXISTS | Failed to create CreditCardTransaction - transaction already exists | | 400 | CCM\_UID\_INVALID | \{0}.clientTransactionUniqueReference \{PropertyValue} must match \{RegularExpression} | | 400 | CCM\_UID\_REQUIRED | \{0}.clientTransactionUniqueReference required | | 400 | CCM\_VALIDATION\_ERROR | Error validating request message - \{0} | | 404 | CCM\_ACC\_NOT\_FOUND\_ERROR | account not found for accountId \{0} | | 404 | CCM\_JOB\_NOT\_FOUND\_ERROR | AsyncJob with RequestId \{0} not found | | 404 | CCM\_LINK\_NOT\_FOUND\_ERROR | CreditCardTransaction not found for PaymentGateway \{0} / GatewayTransactionId \{1} | | 404 | CCM\_TRNUID\_NOT\_FOUND\_ERROR | CreditCardTransaction not found for TransactionUniqueReference \{0} | | 404 | CCM\_TRN\_NOT\_FOUND\_ERROR | CreditCardTransaction not found for Account \{0} / clientTransactionUniqueReference \{1} | | 500 | CCM\_ACC\_CREATE\_ERROR | Failed to create account in repository | | 500 | CCM\_DUPLICATED\_SETTLEMENT\_CREATE\_ERROR | Failed to create duplicated settlement in repository | | 500 | CCM\_FAILED\_TRANSACTION\_CREATE\_ERROR | Failed to create failed transaction in repository | | 500 | CCM\_INVALID\_DATE\_ONLY\_STRING | \{0} Invalid DateOnly string \{1}. Expected yyyy-MM-dd | | 500 | CCM\_JOB\_CREATE\_ERROR | Failed to create AsyncJob in repository | | 500 | CCM\_JOB\_UPDATE\_ERROR | Documents modified \{0}. Expected exactly 1 AsyncJob updated. | | 500 | CCM\_TRNUID\_NOT\_UNIQUE | More than one TransactionUniqueReference \{0} is found | | 500 | CCM\_TRN\_CREATE\_ERROR | Failed to create transaction in repository | | 500 | CCM\_TRN\_NOT\_UNIQUE | More than one AccountId \{0} / clientTransactionUniqueReference \{1} is found | | 500 | CCM\_TRN\_UPDATE\_ERROR | Documents modified \{0}. Expected exactly 1 CreditCardTransaction updated. | | 500 | CCM\_UID\_CREATE\_ERROR | Failed to allocate transaactionUniqueReference | | 500 | CCM\_UNEXPECTED\_ERROR | Internal server error. Please contact Monoova support. | | 504 | CCM\_CC\_GATEWAY\_TIMEOUT | Timeout from CC gateway | | 504 | CCM\_CC\_GWM\_TIMEOUT | Timeout from CC Gateway Manager |