B2B Mobile Transaction API - Status Codes Last updated: May 21, 2026
The White Label Wallet (WLW) platform Status Codes communicate the status of a given transaction at a specific point in its lifecycle. The codes are grouped into two categories, based on whether the status relays information about whether a call was able to reach its intended recipient versus the outcome of the call's intended operation.
WLW's Response Status Codes relay information about the state of the transmission of the call.
When any request is submitted to WLW through one of its exposed endpoints, the response always includes the status attribute using the following convention:
... status ":{ " statusCode ":" FAILED ", " statusDescription ":" Tender not supported ", " statusDetails ":[ { " statusCode ":" 370 ", " statusDescription ":" Tender not supported ", " statusType ":" PLATFORM " } ] }, ...
Depending on the originating call, the statusDetails message can provide context-specific details instead of the generic messages described here.
See Response Status Codes and their endpoints for a list of statusDetail response status codes and the endpoints that use them.
The documentation for each individual method includes the specific response status codes used by that endpoint.
Payment status codes are listed after the response codes and endpoints table. The following table lists the response status codes and the endpoints that use them. See the individual method descriptions to see the response codes grouped by endpoint.
WLW's Payment status codes relay information about the current state of the payment.
Payment status codes are grouped into the following general categories:
Note: Codes within each range have been reserved for use by the type specified for that range. However, there is not necessarily a status assigned to every code within the range.
The specific payment status codes are listed here by the type of failure they represent, such as Refund or Schedule.
Code, Status Message, Description Code Status Message Description 200APPROVEDPayment for the transaction has been approved. 201DECLINEDPayment for the transaction has been declined. 202SETTLEMENT_FAILEDThe transaction is authorized, but the settlement failed. 203INSUFFICIENT_FUNDSThe account from which the payment is being drawn does not have enough money to cover the amount due. 204PARTIAL_PAYMENT_SUCCESSA payment has been approved, but a balance remains. 205FORCED_DEPOSIT_SUCCESSThe ATM deposit cancelation failed and the deposit was processed.
Code, Status Message, Description Code Status Message Description 210AUTH_APPROVEDPre-authorization is approved. 211AUTH_FAILEDPre-authorization failed. 212PARTIAL_PRE_AUTH_SUCCESSPre-authorization is approved for a lesser amount than requested.
Code, Status Message, Description Code Status Message Description 220APPROVED_AND_SCHEDULEDThe payment authorization is approved and has been scheduled for processing. 221SCHEDULEDThe payment is scheduled for processing.
Code, Status Message, Description Code Status Message Description 230REFUND_APPROVEDThe credit transaction is accepted. 231REFUND_ON_HOLDThe transaction is awaiting settlement and cannot be refunded at this time. 232REFUND_FAILEDThe credit transaction is declined. 235REFUND_NOT_POSSIBLERefunds are not permitted for this transaction. 236REFUND_TRANSACTION_DATA_MISMATCHThe data input for the refund transaction does not match that of the original purchase. 237REFUND_TRANSACTION_AMOUNT_EXCEEDThe refund transaction amount is in excess of the original purchase.
Code, Status Message, Description Code Status Message Description 240DUPLICATE_TRANSACTIONA duplicate transaction has been submitted. 241PROCESSING_ERRORAn error occurred during processing. Wait 5 minutes before retrying. 242GATEWAY_PROCESSING_ERRORAn error occurred at the gateway. Wait 5 minutes before retrying. 243TRANSACTION_NOT_ALLOWEDThe transaction is not supported at this financial institution. 244TRANSACTION_UNDER_REVIEWThe transaction is being evaluated. 245TRANSACTION_NOT_SUPPORTEDThe transaction is not supported by the wallet integration. 246OPERATION_TIMEOUTThe transaction was not completed in the allotted time.
Code, Status Message, Description Code Status Message Description 250INVALID_INPUTSThe request contains one or more invalid parameter entries. 251INVALID_AMOUNTThe amount entered is not a valid format (for example, multiple decimal points can have been entered). 252INVALID_CARD_NUMBERThe credit card number entered is not valid (e.g., too many or too few digits). 253INVALID_EXPIRY_DATEThe credit card expiration date is not a valid date. 254EXPIRED_CARDThe credit card expiration date has already passed. 255INVALID_ABAThe routing number for the payment account is not valid. 256INVALID_ACCOUNT_NUMBERThe account number is invalid. 257AVS_MISMATCHThe transaction resulted in an AVS mismatch. The address provided does not match billing address of card holder. 258INVALID_CARD_CODEThe card code (CVV2/CVC2/CID) is invalid.
Code, Status Message, Description Code Status Message Description 340SuccessThe CRUD (Create/Read/Update/Delete) operation was successful. 341CRUD_NOT_POSSIBLEThe CRUD operation cannot be completed. Wait five minutes before retrying. 349ENTITY_IS_DELETEDThe referenced entity has been removed and cannot be retrieved.
Code, Status Message, Description Code Status Message Description 350ENTITY_NOT_EXISTINGThe referenced entity does not exist in the system. Recheck the ID or URI used to retrieve. 351DUPLICATES_NOT_ALLOWEDThe URI provided results in a duplicate record if created. Update the existing record instead. 352EMPTY_PARTNER_URIPartner URI is required. 353EMPTY_TENANT_URIA valid tenant URI is required. 354EMPTY_MERCHANT_URIA valid Merchant URI is required. 355EMPTY_USER_PROFILE_URIA valid user profile URI is required. 356EMPTY_CURRENCY_URIA valid currency URI is required. 357EMPTY_FINANCIAL_INSTITUTE_URIA valid financial institution URI is required. 358EMPTY_WALLET_ACCOUNT_URIA valid wallet account URI is required. 359EMPTY_PAYMENT_PROCESSOR_URIA valid payment processor URI is required. 360INVALID_PARTNER_URIPartner URI is not valid. 361INVALID_TENANT_URITenant URI is not valid. 362INVALID_MERCHANT_URIMerchant URI is not valid. 363INVALID_USER_PROFILE_URIUser profile URI is not valid. 364INVALID_CURRENCY_URICurrency URI is not valid. 365INVALID_FINANCIAL_INSTITUTE_URIFinancial institution URI is not valid. 366INVALID_WALLET_ACCOUNT_URIWallet account URI is not valid. 367INVALID_PAYMENT_PROCESSOR_URIPayment processor URI is not valid. 368INVALID_PAYMENT_IMAGE_CATEGORY_URIPayment image category URI is not valid. 369INVALID_PAYMENT_IMAGE_URIThe payment image URI is not valid.
Code, Status Message, Description Code Status Message Description 370BALANCE_INQUIRY_SUCCESSThe account balance was successfully retrieved. 371BALANCE_INQUIRY_FAILEDThe account balance could not be retrieved. 372BALANCE_TEMP_UNAVAILABLEThe account balance is temporarily unavailable. 373BALANCE_NOT_SUPPORTEDBalance retrieval is not supported for the account. 374INVALID_BALANCE_AMOUNTThe account balance returned is not a valid amount. 375INVALID_BALANCE_REQUESTThe operation failed due to one or more invalid parameters in the request.
Code, Status Message, Description Code Status Message Description 380VERIFICATION_SUCCESSThe account has been successfully verified. 381VERIFICATION_FAILEDThe account could not be verified due to an unknown error. 382VERIFICATION_AMOUNT_MISMATCHThe amount provided does not match the account verification. 383VERIFICATION_PERIOD_EXPIREDThe time allowed to complete the verification has expired. 384VERIFICATION_NOT_SUPPORTEDDeposit verification is not supported for this account. 385VERIFICATION_TEMP_NOT_AVAILABLEThe verification service is temporarily unavailable. 386INVALID_VERIFICATION_REQUESTThe operation failed due to one or more invalid parameters in the request. 387VERIFICATION_INITIATEDVerification amounts have been deposited, but no match has been submitted. 388UNSUPPORTED_IINThe Issuer Identification number provided is not in the supported range for verification.
Deprecated: Loyalty processing is deprecated and is no longer available.
Code, Status Message, Description Code Status Message Description 400ALLOWED_LOYALTY_CARD_LIMIT_EXCEEDEDThe number of loyalty cards permitted per user or per type is full.
Deprecated: Loyalty processing is deprecated and is no longer available.
Code, Status Message, Description Code Status Message Description 700ADD_LOYALTY_POINTS_SUCCESSLoyalty program points were awarded for the transaction. 701ADD_LOYALTY_POINTS_FAILEDLoyalty program points were not awarded. 702ADD_LOYALTY_POINTS_NOT_SUPPORTEDAwarding loyalty points is not a supported operation for the account. 703INVALID_POINTS_AMOUNTThe number of points provided is not a valid points award. 704SUBTRACT_LOYALTY_POINTS_FOR_REFUND_SUCCESSPreviously awarded loyalty points were subtracted in conjunction with a refund. 705SUBTRACT_LOYALTY_POINTS_FOR_REFUND_FAILEDPreviously awarded loyalty points could not be subtracted in conjunction with a refund. 706SUBTRACT_LOYALTY_POINTS_FOR_REFUND_NOT_SUPPORTEDSubtracting loyalty points for a refund is not supported. 707SUBTRACT_LOYALTY_PONTS_SUCCESSPoints were subtracted successfully. 708SUBTRACT_LOYALTY_POINTS_FAILEDPoints were not subtracted. 709SUBTRACT_LOYALTY_POINTS_NOT_SUPPORTEDSubtracting loyalty points operation is not supported. 710ADD_LOYALTY_POINTS_FOR_SALE_SUCCESSLoyalty program points were awarded for the sales transaction.
Code, Status Message, Description Code Status Message Description 500INVALID_TRANSACTIONThe transaction request is not valid; contact Issuer. 501SUSPECTED_FRAUDA fraudulent transaction is suspected; contact Issuer. 503SERVICE_FAULTThe Issuer service is temporarily unavailable due to maintenance.
Code, Status Message, Description Code Status Message Description 550MERCHANT_ERRORAn error has occurred at the POS terminal.
Code, Status Message, Description Code Status Message Description 600FULL_REVERSAL_SUCCESSThe transaction was successfully reversed and refunded. 601FULL_REVERSAL_DENIEDReversal of the transaction is not permitted. 602FULL_REVERSAL_EXT_SYSTEM_FAILEDAn external system failure prevented the reversal. 603FULL_REVERSAL_SYSTEM_FAILEDA system failure prevented the reversal. 604FULL_REVERSAL_NOT_POSSIBLEThe transaction could not be reversed, possibly because the reversal is not supported or the transaction has already been reversed. 605TRANSACTION_NOT_FOUND_FOR_REVERSALThe referenced transaction could not be found.
Code, Status Message, Description Code Status Message Description 620VOID_SUCCESSThe transaction was successfully voided and refunded. 621VOID_DENIEDVoiding the transaction is not permitted. 622VOID_EXT_SYSTEM_FAILEDAn external system failure prevented the void. 623VOID_SYSTEM_FAILEDA system failure prevented the void. 624VOID_NOT_POSSIBLEThe transaction could not be voided, possibly because the transaction has already been canceled or voided or cannot be located.
Code, Status Message, Description Code Status Message Description 750ADD_VALUE_SUCCESSCard balance was successfully loaded or reloaded. 751ADD_VALUE_FAILEDCard balance was not loaded. 752ADD_VALUE_NOT_SUPPORTEDCard balance loading or reloading is not supported in the wallet. 753MAX_VALUE_EXCEEDEDThe card balance load amount is too high. 754MAX_BALALNCE_EXCEEDEDThe load amount will make the total card balance too high.
Code, Status Message, Description Code Status Message Description 760CARD_PROVISIONING_SUCCESSThe card was added as a payment account in the wallet. 761CARD_PROVISIONING_FAILEDThe card was not added as a payment account in the wallet. 762CARD_PROVISIONING_NOT_SUPPORTEDThe wallet is not configured for card provisioning. 763CARD_PROVISIONING_LIMIT_EXCEEDEDThe wallet already has the maximum number of provisioned payment accounts. 764CARD_PROVISIONING_DECLINEDProvisioning of the card was not authorized.
Code, Status Message, Description Code Status Message Description 780IDP_AUTHENTICATION_SUCCESSThe credentials were authenticated by the identity processor. 781IDP_AUTHENTICATION_FAILEDThe credentials failed authentication by the identity processor. 782IDP_PROCESSING_ERRORAn error occurred during processing. 783IDP_EXTERNAL_PROCESSING_ERRORAn external error occurred during processing.
Code, Status Message, Description Code Status Message Description 790PAYMENT_ACCOUNT_ENROLLMENT_SUCCESSFULThe payment account was successfully enrolled in the wallet. 791PAYMENT_ACCOUNT_ENROLLMENT_FAILEDThe payment account could not be enrolled in the wallet. 792PAYMENT_ACCOUNT_ENROLLMENT_CANCELLEDThe payment account enrollment was canceled. 793PAYMENT_ACCOUNT_ENROLLMENT_EXPIREDThe allowed time to complete the payment account enrollment has passed. 794PAYMENT_ACCOUNT_ENROLLMENT_CARD_PROVISIONING_LIMIT_EXCEEDEDThe wallet already contains the maximum number of enrolled payment accounts. 795PAYMENT_ACCOUNT_ENROLLMENT_CARD_PROVISIONING_DECLINEDThe external processor did not authorize the enrollment. 796PAYMENT_ACCOUNT_ENROLLMENT_CARD_PROVISIONING_NOT_SUPPORTEDThe issuing partner is not configured for provisioning. 797PAYMENT_ACCOUNT_ENROLLMENT_CRUD_NOT_POSSIBLERead/Write access of the payment account was prohibited. 798PAYMENT_ACCOUNT_ENROLLMENT_DUPLICATES_NOT_ALLOWEDThe payment account is already enrolled. 799PAYMENT_ACCOUNT_ENROLLMENT_VERIFICATION_AMOUNT_MISMATCHThe deposit amounts entered do not match the verification amounts. 800PAYMENT_ACCOUNT_ENROLLMENT_VERIFICATION_NOT_SUPPORTEDThe payment account does not support double deposit verification. 801PAYMENT_ACCOUNT_ENROLLMENT_VERIFICATION_TEMP_NOT_AVAILABLEThe double deposit data is not yet available for verification. 802PAYMENT_ACCOUNT_ENROLLMENT_INVALID_VERIFICATION_REQUESTThe verification request contains invalid values. 803PAYMENT_ACCOUNT_ENROLLMENT_VERIFICATION_INITIATEDThe system is waiting for the user to provide verification amounts. 804COMPLETED_PAYMENT_ACCOUNT_ENROLLMENT_CANCELLATION_NOT_POSSIBLEThe payment account has already been added to the wallet. To remove, use deleteCustomerCardInfo . 805PAYMENT_ACCOUNT_ENROLLMENT_ALREADY_CANCELLEDThe payment account has already been canceled. 806PAYMENT_ACCOUNT_ENROLLMENT_CONTINUATION_NOT_POSSIBLEContinuation of the enrollment failed, possibly because the enrollment completed, was canceled, or expired. 807PAYMENT_ACCOUNT_ENROLLMENT_SUSPECTED_FRAUDThe enrollment triggered a fraud alert. Contact the issuer.
Code, Status Message, Description Code Status Message Description 810EXT_SYSTEM_INVOICE_NOT_FOUNDThe referenced invoice was not located in the external system. 811EXT_SYSTEM_INVOICE_LOCKED_OR_CLOSEDThe referenced invoice is locked or closed to updates. 812EXT_SYSTEM_INVOICE_ITEM_NOT_FOUNDA referenced item on the invoice was not located in the external system. 813EXT_SYSTEM_INVOICE_LOCKEDThe referenced invoice is locked against updates. 814EXT_SYSTEM_INVOICE_CLOSEDThe referenced invoice is already closed out. 815EXT_SYSTEM_INVALID_OFFERThe referenced offer is not valid in the external system. 816EXT_SYSTEM_INVALID_PAYMENT_TENDERThe submitted payment account is not a valid tender in the external system. 817EXT_SYSTEM_INVALID_INVOICE_REVISIONAn update to the invoice is not valid. 818EXT_SYSTEM_ACCEPTANCE_LOCATION_NOT_FOUNDThe referenced acceptance location was not located in the external system. 819EXT_SYSTEM_ACCEPTANCE_LOCATION_OFFLINEThe referenced acceptance location is offline and cannot process the operation. 820EXT_SYSTEM_MESSAGE_VALIDATION_FAILEDThe message to the external system failed validation.
Code, Status Message, Description Code Status Message Description 830ADDITIONAL_PROCESSING_SUCCESSThe supplementary transaction operation was successful. 831ADDITIONAL_PROCESSING_FAILEDThe supplementary transaction operation failed.