Error codes

461 error codes across 44 modules, generated from the platform source rather than maintained by hand.

The error reference is not available right now

This instance could not load its API specification, so there is nothing to list. The reference returns as soon as the specification is readable again.

This instance publishes no error reference

The API specification loaded, and it carries no error-code catalog. That is what an instance running a build from before the catalog was published looks like. The error envelope shapes below are accurate whether or not the catalog is present.

Error response shapes

Every failed request returns the same envelope: a single error object. Which of its fields are populated depends on why the request failed, so these are the four shapes a caller has to handle. The bodies are illustrative and carry no real data.

409 Business rule refused the request

The request was understood and rejected by a platform rule. This is the shape that carries a code from the catalog above, so branch on error.code rather than on the message text. The HTTP status is the one listed against the code.

{
  "error": {
    "code": "Transactions:00042",
    "message": "This transaction has already been settled and cannot be voided.",
    "details": null,
    "data": null,
    "validationErrors": null
  }
}

400 Request failed validation

One or more fields were rejected before any rule ran. error.code is null on the envelope and the causes are in validationErrors, one entry per failure. An entry carries code when the validator declared a publishable one, and memberPaths when the full path says more than members does (an element inside a collection, for example). Both keys are omitted when they would add nothing.

{
  "error": {
    "code": null,
    "message": "Your request is not valid!",
    "details": "The following errors were detected during validation.",
    "data": null,
    "validationErrors": [
      {
        "message": "'Amount' must be greater than 0.",
        "members": ["amount"]
      },
      {
        "message": "The currency code is not supported by this merchant.",
        "members": ["currency"],
        "code": "Transactions:00017"
      },
      {
        "message": "'Value' must not be empty.",
        "members": ["value"],
        "memberPaths": ["customFields[2].value"]
      }
    ]
  }
}

403 Caller is not authorized

The credential was accepted and does not carry what the operation requires. The code is the framework's, not a platform code, so it is worth matching on explicitly. Each operation page lists what it requires.

{
  "error": {
    "code": "Volo.Authorization:010001",
    "message": "Authorization failed! Given policy has not granted.",
    "details": null,
    "data": null,
    "validationErrors": null
  }
}

500 Unexpected server fault

Something failed that no rule anticipated. There is no code to branch on and the message is deliberately generic: the diagnostic detail stays in the platform's logs rather than going to the caller. Retrying an unsafe operation after this risks a duplicate, so reconcile before you retry.

{
  "error": {
    "code": null,
    "message": "An internal error occurred during your request!",
    "details": null,
    "data": null,
    "validationErrors": null
  }
}

Codes by module

error.code carries one of these values, so a caller can branch on the cause without parsing message text. The status column is what this instance returns when the code is raised. A code with no message defined is listed rather than hidden: it still reaches a caller over the wire.

Account

Code Status Message
AccountPro:0001 framework 403 No message defined.

Account Updater

Code Status Message
AccountUpdater:MerchantIdRequired framework 400 A merchant is required for account updater queries. No message defined.
AccountUpdater:RunsAreReadOnly framework 403 Account updater runs are read-only and cannot be created, changed, or deleted. No message defined.
AccountUpdater:SubmissionsAreReadOnly framework 403 Account updater submissions are read-only and cannot be created, changed, or deleted. No message defined.
AccountUpdater:UseContTokenPaging framework 400 This list must be paged with a continuation token. Use the continuation list endpoint. No message defined.

Accounting

Code Status Message
Accounting:ConnectionAlreadyExists framework 409 An accounting connection for this provider already exists for the merchant. No message defined.
Accounting:ConnectionNotFound framework 404 The requested accounting connection was not found. No message defined.
Accounting:DuplicateProviderKey framework 409 More than one accounting provider is registered for the same key. No message defined.
Accounting:InvalidOAuthState framework 400 The authorization response could not be validated. Please start the connection again. No message defined.
Accounting:NoActiveConnection framework 409 No active accounting connection is configured for this merchant. No message defined.
Accounting:OAuthExchangeFailed framework 429 Could not complete authorization with the accounting provider. No message defined.
Accounting:SyncRecordNotRetryable framework 409 This sync record is not in a state that can be retried. No message defined.
Accounting:UnknownProvider framework 400 No accounting provider is registered for the requested key. No message defined.

Announcements

Code Status Message
Announcements:00001 framework 400 The announcement title is required. No message defined.
Announcements:00002 framework 400 The announcement body is required. No message defined.
Announcements:00003 framework 400 Invalid scope configuration. Please verify the reseller or merchant selection. No message defined.
Announcements:00004 framework 400 Host-level announcements cannot have a tenant specified. No message defined.
Announcements:00005 framework 400 Reseller-scoped announcements require a reseller to be selected. No message defined.
Announcements:00006 framework 400 Merchant-scoped announcements require a merchant to be selected. No message defined.
Announcements:00007 framework 403 You do not have access to the specified scope. No message defined.
Announcements:00008 framework 403 You can only target resellers within your hierarchy. No message defined.
Announcements:00009 framework 404 The announcement was not found. No message defined.
Announcements:00010 framework 400 The start date must be before the end date. No message defined.
Announcements:00011 framework 400 Too many roles specified in the target audience. No message defined.
Announcements:00012 framework 400 Too many users specified in the target audience. No message defined.
Announcements:00013 framework 400 At least one role must be selected when targeting by roles. No message defined.
Announcements:00014 framework 400 At least one user must be selected when targeting by users. No message defined.
Announcements:00015 framework 404 User announcement state not found. No message defined.
Announcements:00016 framework 404 You do not have permission to modify this announcement. No message defined.

Api Key Authorization

Code Status Message
KEY_ENVIRONMENT_MISMATCH framework 403 No message defined.
KEY_EXPIRED framework 403 No message defined.
KEY_INVALID framework 403 No message defined.
KEY_REVOKED framework 403 No message defined.

Authorization

Code Status Message
Volo.Authorization:010001 framework 403 Authorization failed! Given policy has not granted. No message defined.
Volo.Authorization:010002 framework 403 Authorization failed! Given policy has not granted: {PolicyName} No message defined.
Volo.Authorization:010003 framework 403 Authorization failed! Given policy has not granted for given resource: {ResourceName} No message defined.
Volo.Authorization:010004 framework 403 Authorization failed! Given requirement has not granted for given resource: {ResourceName} No message defined.
Volo.Authorization:010005 framework 403 Authorization failed! Given requirements has not granted for given resource: {ResourceName} No message defined.

Core

Code Status Message
WinkPG:EntityLocked framework 409 This {EntityType} is locked and cannot be modified. Unlock it first to make changes. No message defined.
WinkPG:LockReasonTooLong framework 400 Lock reason cannot exceed {MaxLength} characters. No message defined.

Current User

Code Status Message
PGV2:010001 framework 409 You cannot change merchant while an operating context is active. Use the operating context to switch merchants. No message defined.

Customers

Code Status Message
Customers:00001 framework 404 The stored payment method on this contract could not be found. It may have been removed or invalidated. No message defined.
Customers:00002 framework 404 The stored payment method on this contract belongs to a merchant this customer cannot be charged under. No message defined.
Customers:RecurringBillingRunNotFound framework 404 The recurring billing run could not be found. No message defined.
Customers:RecurringBillingTriggerFailed framework 429 The recurring billing run could not be started. Please try again. No message defined.

Dashboards

Code Status Message
Dashboards:010001 framework 404 The source dashboard view was not found or is not accessible. No message defined.
Dashboards:010002 framework 409 The default dashboard view cannot be deleted. No message defined.
Dashboards:010003 framework 403 You have reached the maximum number of dashboard views ({Max}). No message defined.
Dashboards:010004 framework 404 The dashboard view was not found or is not accessible. No message defined.

Favorites

Code Status Message
Favorites:00001 framework 400 The favorite entity type is required. No message defined.
Favorites:00002 framework 400 The favorite label is required. No message defined.
Favorites:00003 framework 400 The favorite route is required. No message defined.
Favorites:00004 framework 404 The favorite was not found. No message defined.
Favorites:00005 framework 403 Maximum number of favorites reached. No message defined.
Favorites:00006 framework 400 Unknown favorite entity type. No message defined.

Feature Management

Code Status Message
Volo.Abp.FeatureManagement:InvalidFeatureValue framework 403 {0} feature value is not valid! No message defined.

Features

Code Status Message
Volo.Feature:010001 framework 403 Feature is not enabled: {FeatureName} No message defined.
Volo.Feature:010002 framework 403 Required features are not enabled. All of these features must be enabled: {FeatureNames} No message defined.
Volo.Feature:010003 framework 403 Required features are not enabled. At least one of these features must be enabled: {FeatureNames} No message defined.

File Management

Code Status Message
FileManagement:0001 framework 403 '{DirectoryName}' is not a valid folder name for a folder. No message defined.
FileManagement:0002 framework 403 '{FileName}' is not a valid file name. No message defined.
FileManagement:0003 framework 403 Already exists a folder with the name '{DirectoryName}' No message defined.
FileManagement:0004 framework 403 You cannot move a folder to under to its child folder. No message defined.
FileManagement:0005 framework 403 Already exists a file with the name '{FileName}' No message defined.
FileManagement:0006 framework 403 Directory not found! No message defined.
FileManagement:0007 framework 403 Not enough storage size! Your total storage size is {StorageSize} and remaining {RemainingSize}. No message defined.

Gdpr

Code Status Message
Volo.Abp.Gdpr:010001 framework 403 You have previously requested to download personal data. Once the given request time period has passed, you can create a new one. No message defined.
Volo.Abp.Gdpr:010002 framework 403 Your personal data is still being prepared. You can download it at {GdprDataReadyTime}. No message defined.

Global Features

Code Status Message
Volo.GlobalFeature:010001 framework 403 The '{ServiceName}' service needs to enable '{GlobalFeatureName}' feature. No message defined.

Hosted Payment Page

Code Status Message
HostedPaymentPage:Ach:WebAuthorizationUnavailable framework 400 The bank debit authorization could not be recorded, so the payment was not submitted. Please try again. No message defined.
HostedPaymentPage:HppSession:AmountModeNotApplicable framework 400 An amount mode does not apply to a card-capture session. No message defined.
HostedPaymentPage:HppSession:BlockedField framework 403 The field '{fieldKey}' cannot be pre-filled for security reasons. No message defined.
HostedPaymentPage:HppSession:BoundCustomerRejected framework 400 The customer supplied for this session could not be used. No message defined.
HostedPaymentPage:HppSession:Cancelled framework 409 This payment session was cancelled. No message defined.
HostedPaymentPage:HppSession:CaptureModeNotApplicable framework 400 Authorize (delayed capture) is only available for a payment session, not for a Save Payment Method session. No message defined.
HostedPaymentPage:HppSession:ConfigInactive framework 409 The hosted payment page is not currently active. No message defined.
HostedPaymentPage:HppSession:ConfigNotFound framework 404 The hosted payment page was not found or is not available for the requesting merchant. Verify the page id and that the request was issued under the owning merchant's credentials. No message defined.
HostedPaymentPage:HppSession:ConsentCaptureBeforeConsume framework 409 Consent capture cannot run until the session's transaction has been consumed. No message defined.
HostedPaymentPage:HppSession:ConsentCaptureMismatch framework 400 Consent capture input does not match the session's recorded state. No message defined.
HostedPaymentPage:HppSession:ConsentCustomerUnresolvable framework 404 A customer could not be resolved for this session, so the payment method cannot be saved. No message defined.
HostedPaymentPage:HppSession:ConsentNotRequested framework 409 This payment session was not configured to capture stored-credential consent. No message defined.
HostedPaymentPage:HppSession:ConsentRequired framework 400 You must authorize future stored-credential charges before this payment can be processed. No message defined.
HostedPaymentPage:HppSession:Consumed framework 409 This payment session has already been used. No message defined.
HostedPaymentPage:HppSession:Disabled framework 403 HPP sessions are not enabled for this tenant. No message defined.
HostedPaymentPage:HppSession:Expired framework 409 This payment link has expired. Create a new payment session to send a fresh link. No message defined.
HostedPaymentPage:HppSession:ExpiryOutOfRange framework 400 The session expiry must be between {minSeconds} and {maxSeconds} seconds. No message defined.
HostedPaymentPage:HppSession:FieldValueInvalid framework 400 The value for field '{fieldKey}' exceeds the maximum allowed length. No message defined.
HostedPaymentPage:HppSession:InitialChargeRequiresCardOnlyPage framework 400 A Save Payment Method with Initial Charge session requires a page that accepts card only. No message defined.
HostedPaymentPage:HppSession:InvalidField framework 400 The field key '{fieldKey}' is not valid for this hosted payment page. No message defined.
HostedPaymentPage:HppSession:NotFound framework 404 The payment session was not found or has expired. No message defined.
HostedPaymentPage:HppSession:ParentOriginNotAllowed framework 403 The requested parent origin is not one of this page's allowed embedding domains. No message defined.
HostedPaymentPage:HppSession:PaymentLinkBaseUrlNotConfigured framework 403 Payment links cannot be sent because the application's public URL is not configured. Contact your administrator. No message defined.
HostedPaymentPage:HppSession:RecurringPlanNotApplicable framework 400 A recurring plan can only be supplied for a Save Payment Method with Initial Charge session. No message defined.
HostedPaymentPage:HppSession:RecurringPlanUnavailable framework 403 The recurring plan for this payment session is no longer available. No message defined.
HostedPaymentPage:HppSession:ReleaseNotAllowed framework 409 This payment session can no longer be released. No message defined.
HostedPaymentPage:HppSession:RequestedCredentialStorageInvalid framework 400 RequestedCredentialStorage contains undefined flag bits outside the valid mask. No message defined.
HostedPaymentPage:HppSession:ResellerHostedPageDisabled framework 403 Hosted payment pages are turned off for this reseller, so a new payment session cannot be started for this page. Turn on the Hosted Payment Page feature for the reseller and try again. No message defined.
HostedPaymentPage:HppSession:Revoked framework 409 This session has already been revoked. No message defined.
HostedPaymentPage:HppSession:SaveCardOnlyConflictsWithPagePurpose framework 400 This hosted payment page saves a card, so a session cannot ask for the save-card flow to be turned off. No message defined.
HostedPaymentPage:HppSession:SaveCardOnlyNotSupportedByProcessor framework 403 Save Payment Method (no-charge) sessions are not available for this page: none of its offered payment methods can be stored without a charge for this merchant. No message defined.
HostedPaymentPage:HppSession:SmsNotSupported framework 403 SMS delivery is not yet supported for payment links. No message defined.
HostedPaymentPage:Interaction:BeaconInvalid framework 400 The interaction event could not be recorded. No message defined.
HostedPaymentPage:ResellerHostedPageDisabled framework 403 Hosted payment pages are turned off for this reseller, so a page cannot be created for its merchants. Turn on the Hosted Payment Page feature for the reseller and try again. No message defined.
HostedPaymentPage:SaveCardPurposeNotSupportedByProcessor framework 403 This page cannot be set to save a card: the merchant's processor does not support zero-dollar card verification. No message defined.
Hpp:Webhook:BlockedIpRange framework 400 The webhook host '{Host}' resolves to an address range that is not allowed. No message defined.
Hpp:Webhook:HttpsOnly framework 400 The webhook URL must use HTTPS. No message defined.
Hpp:Webhook:InvalidUrl framework 400 The webhook URL is not a valid absolute URL. No message defined.
Hpp:Webhook:UnresolvableHost framework 400 The webhook host '{Host}' could not be resolved. No message defined.

Identity

Code Status Message
Volo.Abp.Identity:010001 framework 403 You can not delete your own account! No message defined.
Volo.Abp.Identity:010002 framework 403 Can not set more than {MaxUserMembershipCount} organization unit for a user! No message defined.
Volo.Abp.Identity:010003 framework 403 Can not change password of an externally logged in user! No message defined.
Volo.Abp.Identity:010004 framework 403 There is already an organization unit with name {0}. Two units with same name can not be created in same level. No message defined.
Volo.Abp.Identity:010005 framework 403 Static roles can not be renamed. No message defined.
Volo.Abp.Identity:010006 framework 403 Static roles can not be deleted. No message defined.
Volo.Abp.Identity:010007 framework 403 You can't change your two factor setting. No message defined.
Volo.Abp.Identity:010008 framework 403 It's not allowed to change two factor setting. No message defined.
Volo.Abp.Identity:010009 framework 403 You can not delegate yourself. No message defined.
Volo.Abp.Identity:010010 framework 403 Invalid external login provider No message defined.
Volo.Abp.Identity:010011 framework 403 External login provider authenticate failed No message defined.
Volo.Abp.Identity:010012 framework 403 Local user already exists No message defined.
Volo.Abp.Identity:010013 framework 403 No user found in the file. No message defined.
Volo.Abp.Identity:010014 framework 403 Invalid import file format. No message defined.
Volo.Abp.Identity:010015 framework 403 Reached maximum allowed user count! This tenant is allowed to have a maximum of {MaxUserCount} users. No message defined.
Volo.Abp.Identity:010021 framework 403 Name exist: '{0}'. No message defined.

Invoicing

Code Status Message
Invoicing:Biller:ForeignBillerNotAllowed framework 404 You cannot act as this biller. Choose a biller you have access to. No message defined.
Invoicing:CreditNote:AlreadyApplied framework 409 This credit note has already been applied to an invoice. No message defined.
Invoicing:CreditNote:ExceedsBalance framework 409 The credit note amount is greater than the balance due on the invoice. No message defined.
Invoicing:CreditNote:InvalidInvoiceStatus framework 409 A credit note cannot be applied to an invoice in its current status. No message defined.
Invoicing:CreditNote:NotEditable framework 409 A credit note in {status} status cannot be edited. No message defined.
Invoicing:CreditNote:NotFound framework 404 The credit note could not be found. No message defined.
Invoicing:Deposit:DueDateAfterBalanceDueDate framework 400 The deposit due date ({depositDueDate}) cannot be later than the balance due date ({balanceDueDate}). No message defined.
Invoicing:Deposit:ExceedsTotal framework 400 The deposit amount ({depositAmount}) cannot be greater than the invoice total ({total}). No message defined.
Invoicing:Deposit:MustBePositive framework 400 The deposit amount must be greater than zero. No message defined.
Invoicing:Deposit:PaymentRequired framework 400 This invoice requires its deposit of {requiredAmount} to be paid first. The amount supplied was {providedAmount}. No message defined.
Invoicing:Export:RowLimitExceeded framework 400 The export exceeds the maximum of {MaxRowCount} rows. Narrow the filters and try again. No message defined.
Invoicing:Feature:NotEnabled framework 403 Invoicing is not enabled for this merchant. No message defined.
Invoicing:Invoice:AlreadySent framework 409 This invoice has already been sent. No message defined.
Invoicing:Invoice:CannotCancelNonDraft framework 409 Only a draft invoice can be cancelled. No message defined.
Invoicing:Invoice:CannotEditLocked framework 409 A locked invoice cannot be edited. Unlock it first, then try again. No message defined.
Invoicing:Invoice:InvalidStatusTransition framework 409 An invoice cannot move from {currentStatus} to {targetStatus}. No message defined.
Invoicing:Invoice:IsLocked framework 409 This invoice is locked and cannot be changed. No message defined.
Invoicing:Invoice:NotFound framework 404 The invoice could not be found. No message defined.
Invoicing:Invoice:PossibleDuplicate framework 409 An invoice with the same customer, amount, and date already exists. Confirm this is not a duplicate before sending it. No message defined.
Invoicing:Limit:MonthlyInvoiceLimitReached framework 403 The monthly invoice limit for this plan has been reached. No message defined.
Invoicing:LineItem:InvalidQuantity framework 400 The line item quantity must be greater than zero. No message defined.
Invoicing:LineItem:InvalidUnitPrice framework 400 The line item unit price cannot be negative. No message defined.
Invoicing:LineItem:MaxExceeded framework 400 This invoice has reached the maximum number of line items. No message defined.
Invoicing:LineItem:NotFound framework 404 The line item could not be found on this invoice. No message defined.
Invoicing:Number:Conflict framework 409 A unique invoice number could not be generated after {MaxAttempts} attempts. Please try again. No message defined.
Invoicing:Number:SequenceNotFound framework 404 The invoice number sequence for this biller could not be found. No message defined.
Invoicing:Payment:BelowMinimum framework 400 The payment amount is below the minimum this invoice accepts. No message defined.
Invoicing:Payment:ExceedsBalance framework 409 The payment amount is greater than the balance due on this invoice. No message defined.
Invoicing:Payment:InvoiceAlreadyPaid framework 409 This invoice is already paid in full. No message defined.
Invoicing:Payment:PartialNotAllowed framework 403 This invoice does not accept partial payments. Pay the full balance due. No message defined.
Invoicing:PaymentPlan:AlreadyExists framework 409 This invoice already has a payment plan. No message defined.
Invoicing:PaymentPlan:AutoCollectRequiresToken framework 400 Automatic collection requires a stored payment method on the payment plan. No message defined.
Invoicing:PaymentPlan:InstallmentNotFound framework 404 The installment could not be found on this payment plan. No message defined.
Invoicing:PaymentPlan:InstallmentsMustSumToBalance framework 400 The installment amounts must add up to the invoice balance due. No message defined.
Invoicing:PaymentPlan:InvalidInstallmentCount framework 400 A payment plan must have between {min} and {max} installments, but {count} were requested. No message defined.
Invoicing:PaymentPlan:InvalidInvoiceStatus framework 409 A payment plan cannot be created for an invoice in {status} status. No message defined.
Invoicing:PaymentPlan:NoBalance framework 409 This invoice has no outstanding balance to schedule. No message defined.
Invoicing:PaymentPlan:NotFound framework 404 The payment plan could not be found. No message defined.
Invoicing:Portal:NotAuthenticated framework 403 Your invoice portal session is no longer valid. Open the invoice link again to continue. No message defined.
Invoicing:Product:NotFound framework 404 The product could not be found. No message defined.
Invoicing:RecurringSchedule:InvalidBiller framework 400 The selected biller is not valid for this recurring invoice schedule. No message defined.
Invoicing:RecurringSchedule:InvalidStatusTransition framework 409 A recurring invoice schedule cannot move from {from} to {to}. No message defined.
Invoicing:RecurringSchedule:NoLineItems framework 400 A recurring invoice schedule needs at least one line item. No message defined.
Invoicing:RecurringSchedule:NoRecurrence framework 400 A recurring invoice schedule needs a recurrence pattern. No message defined.
Invoicing:RecurringSchedule:NotFound framework 404 The recurring invoice schedule could not be found. No message defined.
Invoicing:Report:RowLimitExceeded framework 400 The report exceeds the maximum of {MaxRowCount} rows. Narrow the filters and try again. No message defined.
Invoicing:TaxRate:NotFound framework 404 The tax rate could not be found. No message defined.
Invoicing:Template:CannotDeleteDefault framework 409 The default invoice template cannot be deleted. Make another template the default first. No message defined.
Invoicing:Template:NotFound framework 404 The invoice template could not be found. No message defined.

Language Management

Code Status Message
Volo.Abp.LanguageManagement:010001 framework 403 Culture name {CultureName} already exists. No message defined.

Merchant Billing

Code Status Message
MerchantBilling:BillingRunAlreadyRunning framework 409 A billing run is already in progress for this reseller. No message defined.
MerchantBilling:ContractCancelled framework 409 This recurring billing contract has been cancelled and can no longer be charged. No message defined.
MerchantBilling:DuplicateBillingRunForPeriod framework 409 A completed billing run already exists for reseller '{0}' in period '{1}'. No message defined.
MerchantBilling:DuplicateGroupInPlan framework 400 SKU group '{0}' already has a rate entry in this price plan. No message defined.
MerchantBilling:DuplicateSkuInPlan framework 400 SKU '{0}' already exists in this price plan. No message defined.
MerchantBilling:InvalidSkuCode framework 400 SKU code '{0}' is not a valid registered SKU. No message defined.
MerchantBilling:InvalidSkuGroupCode framework 400 SKU group '{0}' is not a recognized billing group. No message defined.
MerchantBilling:MerchantAlreadyHasActivePlan framework 409 Merchant '{0}' already has an active price plan assignment. No message defined.
MerchantBilling:PaymentMethodCallbackKindFieldMissing framework 400 A '{0}' payment method requires field '{1}' on the capture callback. No message defined.
MerchantBilling:PaymentMethodCaptureIntentCancelled framework 409 The capture link was cancelled and can no longer be completed. Send a new link from the merchant's payment-method page. No message defined.
MerchantBilling:PaymentMethodCaptureIntentConsumed framework 409 The capture-intent token has already been used. Restart the capture from the merchant's payment-method page. No message defined.
MerchantBilling:PaymentMethodCaptureIntentExpired framework 409 The capture-intent token has expired. Restart the capture from the merchant's payment-method page. No message defined.
MerchantBilling:PaymentMethodCaptureIntentInvalid framework 400 The capture-intent token is not recognized. Restart the capture from the merchant's payment-method page. No message defined.
MerchantBilling:PaymentMethodCaptureIntentMismatch framework 400 The capture-intent token does not match this capture request. Restart the capture from the merchant's payment-method page. No message defined.
MerchantBilling:PaymentMethodCaptureIntentRequired framework 400 The capture callback is missing its capture-intent token. Restart the capture from the merchant's payment-method page. No message defined.
MerchantBilling:PaymentMethodCaptureLinkNotFound framework 404 There is no capture link to resend for this merchant. Send a new link first. No message defined.
MerchantBilling:PaymentMethodCaptureNotCompleted framework 409 The payment capture has not completed yet. Finish entering the payment details on the hosted page, then try again. No message defined.
MerchantBilling:PaymentMethodCollectionMerchantMismatch framework 400 The supplied payment-method collection merchant does not match the reseller's configured collection merchant. No message defined.
MerchantBilling:PaymentMethodKindNotAllowed framework 403 The reseller's billing preferences do not permit '{0}' payment methods. No message defined.
MerchantBilling:PaymentMethodMissingCollectionMerchant framework 400 Configure a collection merchant on the reseller's billing preferences before capturing a payment method. No message defined.
MerchantBilling:PaymentMethodMissingHpp framework 400 Configure a card capture Hosted Payment Page on the reseller's billing preferences before capturing a payment method. No message defined.
MerchantBilling:PaymentMethodNotFound framework 404 No active stored payment method exists for this merchant. No message defined.
MerchantBilling:PaymentMethodTokenNotFound framework 404 The payment token referenced by the capture callback could not be resolved. No message defined.
MerchantBilling:PaymentMethodTokenVaultMismatch framework 400 The payment token is not vaulted under the expected collection merchant. No message defined.
MerchantBilling:PricePlanInUse framework 409 Cannot delete price plan '{0}' because it is assigned to one or more merchants. No message defined.
MerchantBilling:PricePlanNameAlreadyExists framework 409 A price plan with name '{0}' already exists for this reseller. No message defined.
MerchantBilling:PricePlanNotFound framework 404 Price plan not found. No message defined.
MerchantBilling:PricingStrategyNotAllowedForSku framework 400 Pricing strategy '{0}' is not allowed for SKU '{1}'. No message defined.
MerchantBilling:RateEntryTargetAmbiguous framework 400 A rate entry cannot target both a SKU and a SKU group. No message defined.
MerchantBilling:RateEntryTargetRequired framework 400 Each rate entry must target a SKU or a SKU group. No message defined.
MerchantBilling:ResellerMerchantBillingDisabled framework 403 Merchant billing is turned off for this reseller, so a price plan cannot be created for it. Turn on the Merchant Billing feature for the reseller and try again. No message defined.
MerchantBilling:TiersNotContiguous framework 400 Pricing tiers must be contiguous and non-overlapping. No message defined.
MerchantBilling:TiersRequiredForTieredPricing framework 400 At least one pricing tier is required when using Tiered pricing strategy. No message defined.

Merchants

Code Status Message
Merchants:000001 framework 409 This processor account cannot be deactivated while it still has unsettled transactions. No message defined.
Merchants:000002 framework 409 This processor account cannot be deleted while it still has unsettled transactions. No message defined.
Merchants:000003 framework 409 This is the last active profile for its payment type. Deactivating it would leave the merchant unable to process that payment type. No message defined.
Merchants:CustomFieldsNotEnabled framework 403 Custom field configuration is not enabled for this merchant. No message defined.
Merchants:NoCurrentMerchant framework 400 No merchant is associated with the current user. No message defined.
Merchants:OrderDataDefaultsNotEnabled framework 403 Order data defaults are not enabled for this merchant. No message defined.
Merchants:TenderDisabledByMerchant framework 403 This tender is not enabled for this merchant. No message defined.
Merchants:TenderDisabledByReseller framework 403 This tender is not enabled by the reseller. No message defined.
Merchants:TenderDisabledByTenant framework 403 This tender is turned off platform-wide. No message defined.
Merchants:TenderNotSupportedByProcessorAccount framework 403 The selected processor account does not support this tender. No message defined.

Mfa

Code Status Message
Mfa:CannotDisableSoleMethod framework 409 Cannot disable the only enabled MFA method when MFA is required. No message defined.
Mfa:ChallengeExpired framework 409 Your verification session has expired. Please sign in again. No message defined.
Mfa:InvalidVerificationCode framework 400 The verification code is invalid. Please try again. No message defined.
Mfa:PasswordIncorrect framework 403 The password provided is incorrect. No message defined.
Mfa:PasswordRequired framework 400 Password confirmation is required for this action. No message defined.
Mfa:RecoveryCodeInvalid framework 400 The recovery code is invalid or has already been used. No message defined.
Mfa:SetupRequired framework 403 Multi-factor authentication setup is required before you can continue. No message defined.
Mfa:TotpAlreadyEnabled framework 409 TOTP authenticator is already enabled for this account. No message defined.
Mfa:TotpNotEnabled framework 409 TOTP authenticator is not enabled for this account. No message defined.

Multi Merchant

Code Status Message
MultiMerchant:010001 framework 404 Merchant not found! No message defined.
MultiMerchant:010002 framework 409 Merchant is not active! No message defined.

Notifications

Code Status Message
Notifications:00001 framework 409 A subscription with this name already exists in this scope. No message defined.
Notifications:00002 framework 400 A merchant is required when the subscription scope is Merchant. No message defined.
Notifications:00003 framework 400 A reseller is required when the subscription scope is Reseller. No message defined.
Notifications:00004 framework 400 At least one event type is required. No message defined.
Notifications:00006 framework 400 The filter expression is not valid. No message defined.
Notifications:00007 framework 400 The destination configuration is not valid. No message defined.
Notifications:00008 framework 403 You do not have access to the selected scope. No message defined.
Notifications:00009 framework 400 The filter expression is nested too deeply. No message defined.
Notifications:00010 framework 400 The filter expression has too many conditions. No message defined.
Notifications:00011 framework 400 The event type '{eventType}' is not in the event registry. No message defined.
Notifications:00012 framework 404 The delivery record could not be found. No message defined.
Notifications:00013 framework 404 The subscription behind this delivery could not be found, so it cannot be retried. No message defined.
Notifications:00014 framework 400 This destination type is not supported yet. No message defined.
Notifications:00015 framework 404 The destination could not be found. No message defined.
Notifications:00016 framework 409 This destination cannot be deleted while these channels use it: {channelNames}. No message defined.
Notifications:00017 framework 404 The channel could not be found. No message defined.
Notifications:00018 framework 409 This channel cannot be deleted while these subscriptions use it: {subscriptionNames}. No message defined.
Notifications:00019 framework 403 The destination's scope is not compatible with the scope of the record referencing it. No message defined.
Notifications:00020 framework 403 The channel's scope is not compatible with the subscription's scope. No message defined.
Notifications:00021 framework 409 A destination with this name already exists in this scope. No message defined.
Notifications:00022 framework 409 A channel with this name already exists in this scope. No message defined.
Notifications:00023 framework 400 At least one channel is required on a subscription. No message defined.
Notifications:00024 framework 400 A subscription can have at most {max} channels. No message defined.
Notifications:00025 framework 400 A subscription can have at most {max} event types. No message defined.
Notifications:00026 framework 409 A quick-setup subscription already exists for this item. No message defined.
Notifications:00027 framework 400 The unsubscribe request could not be processed. Please try again. No message defined.
Notifications:00028 framework 400 The quick-setup filter does not pin the subscription to the item its context key names. No message defined.
Notifications:00029 framework 403 One or more of the selected event types cannot be delivered, so the subscription would never fire. No message defined.
Notifications:00030 framework 409 This delivery cannot be retried from its current status ({Status}). No message defined.

Operating Context

Code Status Message
WinkPG.OperatingContext:InvalidMerchant framework 404 The target merchant does not exist, or its ownership chain is not valid. No message defined.
WinkPG.OperatingContext:InvalidReseller framework 404 The target reseller does not exist, or it does not belong to the specified tenant. No message defined.

Payment

Code Status Message
Volo.Payment:010001 framework 403 No message defined.

Payment Tokenization

Code Status Message
PaymentTokenization:DomainAlreadyExists framework 409 Domain '{domain}' already exists for this wallet provider. No message defined.
PaymentTokenization:DomainNotFound framework 404 The specified domain was not found in this wallet provider registration. No message defined.
PaymentTokenization:InternalTokenNotDecryptable framework 400 Internal stored tokens are resolved through the stored payment method, not the wallet decryption path. No message defined.
PaymentTokenization:MetadataNotFound framework 404 The specified provider metadata key '{key}' was not found. No message defined.
PaymentTokenization:PazeCertificateNoPendingRequest framework 409 There is no pending {environment} certificate request to merge. Generate a CSR first. No message defined.
PaymentTokenization:PazeCertificateNotReady framework 409 The {environment} Paze certificate hasn't been generated yet. Generate it on the Settings page first. No message defined.
PaymentTokenization:PazeCertificateOperationInProgress framework 409 A {environment} certificate request is already in progress. Download and merge the pending CSR, or cancel it, then try again. If you just started it, wait a moment and retry. No message defined.
PaymentTokenization:PazeSignedCertificateInvalid framework 400 The uploaded file isn't a valid signed certificate. Upload the CA-signed certificate as a PEM, base64, or DER (.cer) file. No message defined.
PaymentTokenization:ProviderNotRecognized framework 400 The submitted token provider does not correspond to a supported wallet provider. No message defined.
PaymentTokenization:ProviderNotRegistered framework 409 The selected wallet provider is not configured or does not support this operation. No message defined.
PaymentTokenization:ProviderRegistrationFailed framework 429 The wallet provider could not complete the merchant registration. Please verify the details and try again. No message defined.
PaymentTokenization:ProviderSessionFailed framework 429 The wallet provider could not start a payment session. Please try again. No message defined.
PaymentTokenization:ProviderUnregisterFailed framework 429 The wallet provider could not remove the requested domain(s). Please try again. No message defined.
PaymentTokenization:WalletDomainAlreadyRegistered framework 409 Domain '{0}' is already registered on another Paze registration in this environment. Each domain can belong to only one Paze registration per environment. No message defined.
PaymentTokenization:WalletMerchantNameAlreadyRegistered framework 409 Merchant name '{0}' is already used by another registration for this wallet in this environment. Each merchant name must be unique per environment. No message defined.
PaymentTokenization:WalletProviderAlreadyExists framework 409 Wallet provider is already registered for this merchant. No message defined.
PaymentTokenization:WalletProviderNotFound framework 404 Wallet provider registration was not found for the specified merchant and provider. No message defined.

Payment Tokenization Apple Pay

Code Status Message
PaymentTokenization:ApplePay:CertificateRenewalFailed framework 429 The Apple Pay certificate renewal could not be started. Please try again, or use the manual certificate signing request flow. No message defined.
PaymentTokenization:ApplePay:ConnectionTestFailed framework 429 The connection test to Apple Pay failed. Please verify the credentials and certificates, then try again. No message defined.
PaymentTokenization:ApplePay:DeactivationFailed framework 429 Apple Pay could not deactivate the merchant registration. Please try again. No message defined.
PaymentTokenization:ApplePay:DomainVerificationUnsupported framework 400 Apple Pay does not offer a standalone domain verification call. Domains are verified when the merchant is registered. No message defined.
PaymentTokenization:ApplePay:MerchantIdOidMissing framework 403 The Apple Pay payment processing certificate is missing the Apple merchant identifier extension. Re-run the payment processing certificate flow for this Platform Integrator. No message defined.
PaymentTokenization:ApplePay:PayloadFieldsMissing framework 400 The Apple Pay payment token decrypted successfully but was missing required card details, so no usable payment credential could be produced. No message defined.
PaymentTokenization:ApplePay:PaymentSessionFailed framework 429 Apple Pay could not start a payment session. Please try again. No message defined.
PaymentTokenization:ApplePay:PlatformIntegratorIdentifierNotConfigured framework 403 The Apple Pay Platform Integrator identifier is not configured. Set it on the Payment Tokenization settings page before registering merchants. No message defined.
PaymentTokenization:ApplePay:PublicKeyHashMismatch framework 400 The Apple Pay token was encrypted for a different payment processing certificate. This usually means a certificate renewal is in flight or the environment does not match. No message defined.
PaymentTokenization:ApplePay:RegistrationFailed framework 429 Apple Pay could not complete the merchant registration. Please verify the merchant name, URL, and domains, then try again. No message defined.
PaymentTokenization:ApplePay:SignatureVerificationFailed framework 400 The Apple Pay payment token signature could not be verified. No message defined.
PaymentTokenization:ApplePay:TokenDecryptionFailed framework 400 The Apple Pay payment token could not be decrypted. No message defined.

Payment Tokenization Paze

Code Status Message
PaymentTokenization:Paze:ConnectionTestFailed framework 429 The connection test to Paze failed. Please verify the credentials and certificates, then try again. No message defined.
PaymentTokenization:Paze:DeactivationFailed framework 429 Paze could not deactivate the merchant registration. Please try again. No message defined.
PaymentTokenization:Paze:JweDecryptionFailed framework 400 The Paze secured payload could not be decrypted. No message defined.
PaymentTokenization:Paze:OAuthFailed framework 429 Paze rejected the authentication request. Please verify the OAuth settings and the environment certificate, then try again. No message defined.
PaymentTokenization:Paze:PartnerNotConfigured framework 403 The Paze partner details are not configured. Set the partner identifier and key alias on the Payment Tokenization settings page. No message defined.
PaymentTokenization:Paze:PayloadFieldsMissing framework 400 The Paze payload decrypted successfully but was missing required card details, so no usable payment credential could be produced. No message defined.
PaymentTokenization:Paze:PrivateKeyNotConfigured framework 403 The Paze certificate for this environment has not been generated yet. Generate it on the Settings page first. No message defined.
PaymentTokenization:Paze:RegistrationFailed framework 429 Paze could not complete the merchant onboarding. Please verify the merchant details and try again. No message defined.
PaymentTokenization:Paze:SecuredPayloadMissing framework 400 The Paze response did not include a secured payload, so no payment credential could be read. No message defined.
PaymentTokenization:Paze:SignatureVerificationFailed framework 400 The Paze payload signature could not be verified. No message defined.
PaymentTokenization:Paze:TokenDecryptionFailed framework 400 The Paze payment token could not be decrypted. No message defined.

Phoeni X Gate V2

Code Status Message
PhoeniXGate:Data:ConcurrencyConflict framework 409 This record was changed by someone else while you were editing it. Reload it and try again. No message defined.
PhoeniXGateV2:InvalidLandingPageUrl framework 400 The landing page URL must be a valid relative path (e.g. /Dashboard/Merchant). No message defined.
PhoeniXGateV2:TooManyShortcuts framework 403 You can pin at most {max} shortcuts ({count} were submitted). No message defined.
Volo.Account:PhoneNumberConfirmationDisabled framework 403 Phone number confirmation is disabled! No message defined.
Volo.Account:PhoneNumberEmpty framework 400 Phone number is empty! No message defined.

Rate Limiting

Code Status Message
RateLimiting:ProfileNameAlreadyExists framework 409 A rate limit profile named '{name}' already exists. No message defined.
RateLimiting:ProfileNotFound framework 404 The selected rate limit profile does not exist. No message defined.
RateLimiting:RuleAlreadyExistsForLimiter framework 409 This profile already has a rule for the limiter '{limiterName}'. No message defined.

Referential Integrity

Code Status Message
WinkPG.ReferentialIntegrity:Blocked framework 409 This record is still referenced by other records, so it cannot be changed or removed. No message defined.

Saas

Code Status Message
Saas:Edition:0001 framework 403 Edition doesn't have a plan! No message defined.
Saas:Edition:0002 framework 403 Unable to delete {EditionName}, It is in use by tenants. No message defined.

Scoped Settings

Code Status Message
WinkPG.ScopedSettings:001 framework 403 This setting cannot be overridden at the requested scope. No message defined.
WinkPG.ScopedSettings:002 framework 403 No reseller or merchant scope is available to save this setting against. No message defined.
WinkPG.ScopedSettings:003 framework 400 The target reseller or merchant is not valid. No message defined.
WinkPG.ScopedSettings:004 framework 403 This setting cannot be saved at the requested scope: its definition does not allow the scoped provider, so the value would never be read back. No message defined.

Security Posture

Code Status Message
Sbom:Error:InvalidBuildId framework 400 Invalid SBOM build identifier. No message defined.
Sbom:Error:InvalidComponentName framework 400 Invalid SBOM component name. No message defined.
Sbom:Error:NotConfigured framework 403 The SBOM archive is not configured for this deployment. Set WinkPG:SecurityPosture:SbomStorage in configuration to enable it. No message defined.

Shared Models

Code Status Message
CardData:00001 framework 400 Manual entry cannot be combined with encrypted track data. No message defined.
CardData:00002 framework 400 Manual entry requires a card number. No message defined.
CardData:00003 framework 400 Manual entry requires a card expiration date. No message defined.
CardData:00004 framework 400 Encrypted track data is not allowed on a manual-entry request. No message defined.
CardData:00005 framework 400 Track data is not allowed on a manual-entry request. No message defined.
CardData:00006 framework 400 An encrypted card-reader swipe requires encrypted track data. No message defined.
CardData:00007 framework 400 An unencrypted card-reader swipe requires track or EMV data. No message defined.
CardData:00008 framework 400 Unencrypted track data is not allowed on an encrypted card-reader swipe. No message defined.
CardData:00009 framework 400 Encrypted track data is not allowed on an unencrypted card-reader swipe. No message defined.
CardData:00010 framework 400 A chip or contactless transaction requires EMV data. No message defined.
CardData:00011 framework 400 Encrypted track data is not allowed on an unencrypted chip or contactless transaction. No message defined.
CardData:00012 framework 400 No card data was supplied. No message defined.
CardData:00013 framework 400 The card number must be 13 to 19 digits. No message defined.
CardData:00014 framework 400 The card number is not valid. No message defined.
CardData:00015 framework 400 The card has expired. No message defined.
CardData:00016 framework 400 The card security code must be 3 or 4 digits. No message defined.
CardData:00017 framework 400 A card security code was supplied, but the card verification indicator says none was collected. No message defined.
CardData:00018 framework 400 The card verification indicator says a card security code was collected, but none was supplied. No message defined.
DeviceData:00001 framework 400 The encryption key variant is not recognized. Use Data or Pin. No message defined.

Stored Credential Consents

Code Status Message
stored_credential_consent_input_invalid framework 400 No message defined.
stored_credential_consent_required framework 400 No message defined.
stored_credential_consent_text_version_retracted framework 409 No message defined.
stored_credential_consent_text_version_unknown framework 400 No message defined.

Surcharging

Code Status Message
Surcharging:001 framework 400 The surcharge rate exceeds the maximum permitted rate. No message defined.
Surcharging:002 framework 409 Surcharging cannot start yet: the required notice waiting period has not elapsed. No message defined.
Surcharging:003 framework 409 Re-enabling under a different processor requires filing a new surcharge notice. No message defined.
Surcharging:004 framework 400 A surcharge notice must be filed before surcharging can be activated. No message defined.
Surcharging:005 framework 400 The surcharge rate is invalid. No message defined.
Surcharging:006 framework 409 A surcharge configuration already exists for this merchant. No message defined.
Surcharging:007 framework 409 Surcharging cannot start: no filed notice applies to the currently allowed networks. No message defined.
Surcharging:008 framework 409 Surcharging can only be re-enabled from a disabled state. No message defined.
Surcharging:009 framework 400 The same state code appears more than once in the state policy list. No message defined.
Surcharging:010 framework 429 Too many surcharge-quote requests. Please slow down and try again shortly. No message defined.

Transaction Manager

Code Status Message
TransactionManager:NoAuthorizationContributorRegistered framework 403 No payment processor integration is registered for processor '{ProcessorKey}'. Please contact support. No message defined.

Transactions

Code Status Message
OPERATION_IDEMPOTENCY_KEY_CONFLICT framework 409 No message defined.
OPERATION_IDEMPOTENCY_STORE_UNAVAILABLE framework 429 No message defined.
OPERATION_IN_PROGRESS framework 409 No message defined.
OPERATION_NOT_ALLOWED_IN_STATE framework 409 No message defined.
REVERSAL_AMOUNT_EXCEEDS_REMAINING framework 409 No message defined.
REVERSAL_FULLY_CONSUMED framework 409 No message defined.
Transactions:00001 framework 400 A merchant is required for this request. No message defined.
Transactions:00002 framework 404 The merchant could not be found, or you do not have access to it. No message defined.
Transactions:00003 framework 403 Your account has no merchants associated with it. No message defined.
Transactions:00004 framework 403 Your user context could not be determined, so the merchant could not be validated. Sign in again and retry. No message defined.
Transactions:00005 framework 400 The stored card expiration on this contract is missing or unreadable. Update the contract's payment method. No message defined.
Transactions:00006 framework 400 The stored card payment method on this contract could not be resolved. Update the contract's payment method. No message defined.
Transactions:00007 framework 429 Transaction Manager is temporarily unavailable. Please try again shortly. No message defined.
Transactions:00008 framework 403 Processor certification overrides are not permitted for this merchant or processor profile. No message defined.
Transactions:00009 framework 409 This recurring contract has no usable payment method. Add a card or bank account to the contract. No message defined.
Transactions:00010 framework 400 This tender requires the cardholder PIN. No message defined.
Transactions:00011 framework 400 This tender requires a card-present entry mode. No message defined.
Transactions:00012 framework 400 This operation is not permitted for the selected tender. No message defined.
Transactions:00013 framework 400 The entry mode could not be determined, and this tender requires a valid card-present entry mode. No message defined.
Transactions:00014 framework 409 The tender type cannot change on a follow-up transaction. Omit it, or send the same value as the original. No message defined.
Transactions:00015 framework 400 The stored bank account on this contract could not be resolved. Update the contract's payment method. No message defined.
Transactions:00020 framework 400 EBT and eWIC tenders cannot be used with a stored payment method. No message defined.
Transactions:00021 framework 400 EBT and eWIC tenders cannot be used for recurring billing. No message defined.
Transactions:00022 framework 400 EBT and eWIC tenders cannot be used with a digital wallet. No message defined.
Transactions:00023 framework 400 A surcharge cannot be charged on an EBT or eWIC tender. No message defined.
Transactions:00024 framework 400 A tip cannot be added to an EBT or eWIC tender. No message defined.
Transactions:00025 framework 400 Cashback is available on EBT Cash only. No message defined.
Transactions:00026 framework 400 A convenience fee cannot be charged on an EBT or eWIC tender. No message defined.
Transactions:00030 framework 400 This payment session could not be verified. Start the payment again. No message defined.
Transactions:00031 framework 400 This transaction type cannot be submitted from a hosted payment page. No message defined.
Transactions:00032 framework 429 The card capture session is no longer available. Start the capture again. No message defined.
Transactions:00033 framework 429 The bank account could not be saved for this session. Confirm the account holder details, then start the capture again. No message defined.
Transactions:00034 framework 403 This merchant cannot accept eCheck (ACH) payments. No active ACH processor is configured for the merchant. No message defined.
Transactions:00035 framework 400 This ACH payment needs an authorization on file. Choose how the account holder authorized the debit (phone or signed form) and confirm you obtained it before submitting. No message defined.
Transactions:00036 framework 403 Surcharging is not enabled for this merchant. Remove the surcharge amount from the request, or enable surcharging before submitting a transaction that includes one. No message defined.
Transactions:00037 framework 400 A merchant-initiated charge against a stored payment method requires a customer. Re-submit with the customer that owns the stored payment method. No message defined.
Transactions:00038 framework 429 The operation completed, but the transaction could not be read back to build the response. Re-read the transaction rather than submitting it again. No message defined.
Transactions:00039 framework 400 A void or return needs either the original transaction id or the merchant transaction id. No message defined.
Transactions:00040 framework 400 The original transaction id is not a valid identifier. No message defined.
Transactions:00041 framework 400 A force needs an original transaction id, a merchant transaction id, or an auth code, and the two gateway identifiers cannot both be supplied. No message defined.
Transactions:00042 framework 400 The auth code must be 1 to 20 alphanumeric characters. No message defined.
Transactions:00043 framework 400 A voice-authorization force needs the card data supplied with the request. No message defined.
Transactions:00044 framework 403 A voice-authorization force cannot carry check data. Voice approval codes apply to card transactions only. No message defined.
Transactions:00045 framework 400 The original transaction belongs to a different merchant. No message defined.
Transactions:00046 framework 409 A force can only be applied to an authorization. No message defined.
Transactions:00047 framework 400 The card number does not match the original authorization. No message defined.
Transactions:00048 framework 400 The card expiration does not match the original authorization. No message defined.
Transactions:00049 framework 409 The refund amount is greater than the amount still refundable on this transaction. No message defined.
Transactions:00050 framework 409 The reversal amount is greater than the amount still reversible on this transaction. No message defined.
Transactions:00051 framework 409 A transaction with this idempotency key is still being processed. Retry shortly with the same key to receive the recorded outcome. No message defined.
Transactions:00052 framework 429 The idempotency check could not be completed, so the transaction was not submitted. Retry the request with the same key. No message defined.
Transactions:00053 framework 400 A voucher clear applies to EBT SNAP and eWIC tenders only. No message defined.
Transactions:00054 framework 400 A voucher clear needs the paper voucher number. No message defined.
Transactions:00055 framework 400 A voucher clear needs the voucher approval code obtained by phone. No message defined.
Transactions:00056 framework 403 Digital wallet payments are not supported on this merchant's processor profile, which is configured for card-present processing. No message defined.
Transactions:00057 framework 403 This digital wallet is not currently enabled on the platform. No message defined.
Transactions:00058 framework 403 This merchant's processor requires card data captured by a reader, so a manually keyed card cannot be charged. No message defined.
Transactions:00059 framework 400 A transaction that charges a convenience fee must record when and where the fee was disclosed and accepted. Send convenienceFeeDisclosureAcknowledgedAt (the UTC time the payer accepted the disclosed fee) and convenienceFeeDisclosureChannel (one of: VirtualTerminal, HostedPaymentPage, Api). No message defined.
Transactions:00060 framework 400 A payment method is required. Provide cardData, checkData, or tokenData. This merchant is not configured to accept cash payments. No message defined.
Transactions:00061 framework 400 A surcharge was submitted without a disclosure acknowledgment. Confirm the surcharge was disclosed to and accepted by the cardholder (set the surcharge disclosure acknowledgment) before submitting. No message defined.
Transactions:00062 framework 400 The submitted surcharge cannot be applied to this card. The gateway re-evaluated eligibility and found this transaction is not surchargeable. Remove the surcharge and resubmit. No message defined.
Transactions:00063 framework 400 The submitted surcharge exceeds the maximum permitted for this card. Request a surcharge quote and submit the returned amount, or reduce the surcharge, before resubmitting. No message defined.
Transactions:00064 framework 403 Convenience fees are not currently enabled. Remove the convenience amount from the request, or ask an administrator to enable convenience fees before submitting a transaction that includes one. No message defined.
Transactions:CaptureNotAllowedOnZeroAuth framework 409 Capture is not allowed on a zero-amount authorization. Zero-dollar authorizations verify the card only and cannot be captured or settled. No message defined.
Transactions:OperationNotAllowed framework 409 The operation '{requestedOperation}' is not allowed on a {originalTransactionType} transaction with result '{result}' and settlement state '{settlementState}'. No message defined.
Transactions:ReceiptMerchantMismatch framework 404 This receipt belongs to a different merchant. No message defined.
Transactions:ReceiptNoEmailAddress framework 400 No email address is available for this receipt. Supply one with the request. No message defined.
Transactions:SettlementBatchNotBlocking framework 409 This settlement batch is no longer blocking a new run: it is already in {Status} status. No message defined.
Transactions:SettlementBatchNotFound framework 404 The settlement batch could not be found for this merchant. No message defined.
Transactions:SettlementOverride:InvalidTarget framework 403 No message defined.
Transactions:SettlementOverride:NoOp framework 403 No message defined.
Transactions:SettlementOverride:NotEligible framework 403 No message defined.
Transactions:SettlementOverride:ReasonRequired framework 403 No message defined.
Transactions:SettlementOverride:SystemOnlyTarget framework 403 No message defined.
Transactions:SettlementProcessorKeyNotActive framework 403 The processor '{ProcessorKey}' is not active for this merchant. No message defined.
Transactions:SettlementTriggerFailed framework 429 The settlement run could not be started. Please try again. No message defined.
Transactions:TokenMintTenderMissing framework 400 This transaction has no stored card or bank account to tokenize. Tokens can only be minted from transactions that captured a reusable card or check. No message defined.
Transactions:TokenRegenerationFailed framework 429 The payment token could not be regenerated. Please try again shortly. No message defined.
VOID_NOT_APPLICABLE_ZERO_DOLLAR_VERIFICATION framework 409 No message defined.
initiation_type_required framework 400 No message defined.
mit_reason_required framework 400 No message defined.
original_transaction_not_resubmittable framework 409 No message defined.
resubmission_amount_mismatch framework 400 No message defined.
resubmission_limit_exceeded framework 409 No message defined.

Twilio

Code Status Message
Twilio:ApiKeyRequiredForWebhookRegistration framework 400 Set the SendGrid API key before registering the webhook; the gateway needs it to call the SendGrid configuration API. No message defined.
Twilio:SendGridApiKeyNotConfigured framework 403 The message was not sent because no SendGrid API key is configured. Set the SendGrid API key, then retry. No message defined.
Twilio:SendGridFromAddressMissing framework 403 The message was not sent because it had no sender address and no default from-address is configured. Set a default from-address, then retry. No message defined.
Twilio:SendGridReturnedEmptyPublicKey framework 429 SendGrid accepted the webhook configuration but returned an empty signed-events public key. Try again, or configure signed events manually in the SendGrid dashboard. No message defined.
Twilio:SmsComplianceScopeUnresolved framework 400 The message was not sent because the merchant could not be determined, so the recipient's opt-out status could not be checked. Try again, or specify the merchant explicitly. No message defined.
Twilio:SmsDisallowedLinkDomain framework 400 The message was not sent because its body links to a web address the messaging policy does not permit. Use a platform-branded link; public link shorteners are blocked by mobile carriers. No message defined.
Twilio:SmsNotConfigured framework 403 SMS sending is not configured. Configure the Twilio SMS settings (Account SID, Auth Token, and either a Messaging Service SID or a From Phone Number) in the settings panel. No message defined.
Twilio:SmsQuietHoursBlocked framework 429 The message was not sent because it falls outside the permitted sending window for marketing and reminder messages. Schedule it inside the window, or send it as part of a live customer interaction. No message defined.
Twilio:SmsRecipientOptedOut framework 403 This recipient has opted out of SMS messages from this merchant. The message was not sent. The recipient must opt back in before SMS can resume. No message defined.
Twilio:SmsSendFailed framework 429 Failed to send SMS via Twilio. Please check your Twilio configuration and try again. No message defined.
Twilio:SmsSettingsAreHostOnly framework 403 Twilio SMS settings are platform-wide and can only be changed from the host context. Sign in to the host to configure them. No message defined.
Twilio:WebhookBaseUrlMustBeHttps framework 400 The public webhook base URL must be HTTPS. SendGrid will not accept HTTP for signed events. No message defined.
Twilio:WebhookRegistrationIsHostOnly framework 403 Registering the SendGrid signed event webhook is a host-only operation. Sign in to the host context to configure the gateway-wide webhook key. No message defined.

Usage

Code Status Message
Usage:ConcurrencyConflict framework 409 A concurrency conflict occurred while updating usage aggregates. Please retry. No message defined.
Usage:ExceedsResellerEntitlement framework 403 Requested quantity ({RequestedQuantity}) exceeds the reseller's entitlement for SKU '{SkuCode}' (limit: {ResellerLimit}). No message defined.
Usage:InvalidScope framework 400 The supplied entitlement scope value is not valid. No message defined.
Usage:MerchantAndResellerIdRequired framework 400 ResellerId and MerchantId are both required for the {Scope} scope. No message defined.
Usage:PrerequisiteNotMet framework 409 SKU '{SkuCode}' requires prerequisite SKU '{PrerequisiteSkuCode}', which is not entitled at the caller's scope. No message defined.
Usage:ResellerIdRequired framework 400 ResellerId is required for the {Scope} scope. No message defined.
Usage:ScopeNotPermitted framework 403 The requested reseller/merchant scope is not accessible from your operating context. No message defined.
Usage:SkuDisabled framework 403 SKU '{SkuCode}' is disabled for this scope. No message defined.
Usage:SkuNotFound framework 404 SKU '{SkuCode}' is not registered. No message defined.
Usage:UsageLimitExceeded framework 403 Usage limit exceeded for SKU '{SkuCode}'. Current: {CurrentUsage}, Limit: {Limit}. No message defined.

User Settings Admin

Code Status Message
WinkPG.UserSettingsAdmin:001 framework 403 The setting '{settingName}' cannot be reset by an administrator. No message defined.
WinkPG.UserSettingsAdmin:002 framework 400 A valid target user is required. No message defined.