Card Status and Error Codes

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