{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Error Codes","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"error-codes","__idx":0},"children":["Error Codes"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"gateway-response-errors","__idx":1},"children":["Gateway Response Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a transaction is unsuccessful, an error code from the table below is provided. Please note that the list of error codes can change over time."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The types of Gateway Response errors are:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Gateway Response Error Code"},"children":["Gateway Response Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ABORTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction aborted by payer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHENTICATION_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payer authentication failed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BALANCE_AVAILABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A balance amount is available for the card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BLOCKED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction blocked due to Risk or 3D Secure blocking rules"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DECLINED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The requested operation was not successful. Payment was declined by issuer or payer authentication unsuccessful"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DECLINED_AVS_CSC"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction declined due to address verification or card security code"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DECLINED_PIN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction declined due to invalid PIN"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DECLINED_PAYMENT_PLAN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction declined due to payment plan"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXCEEDED_RETRY_LIMIT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction retry limit exceeded"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPIRED_CARD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expired card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSUFFICIENT_FUNDS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Insufficient funds"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_ENROLLED_3D_SECURE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card holder is not enrolled in 3D Secure"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_BALANCE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A balance amount is not available for the card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction is pending"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SYSTEM_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal system error occurred processing the transaction"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNKNOWN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The transaction has been submitted to the acquirer but the gateway was not able to find out about the success or otherwise of the payment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GATEWAY_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gateway returned an unexpected error, please retry your payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SANDBOX_TEST_CARDS_ONLY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only Tyro test cards can be used for the sandbox environment!"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-gateway-response-error","__idx":2},"children":["Sample Gateway Response Error"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errorMessage\": \"Insufficient funds\",\n  \"errorCode\": \"INSUFFICIENT_FUNDS\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pay-request-errors","__idx":3},"children":["Pay Request Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The types of Pay Request errors are:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Pay Request Error Code"},"children":["Pay Request Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request not found"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_MISSING_ORDER"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request does not have an order"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_ALREADY_CAPTURED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request has already been captured"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_ALREADY_VOIDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request has already been voided"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_MUST_BE_AUTHORIZED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request must be AUTHORIZED"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_MUST_BE_AWAITING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can only update total when status is AWAITING_PAYMENT_INPUT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_MISSING_AUTHORIZATION"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request does not have an AUTHORIZATION transaction"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_CAPTURE_AMOUNT_EXCEEDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requested capture amount exceeds authorised amount"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_METHOD_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["payMethod supports the following combos (id, customerId) or (customerId, save=true) or (save=true). In addition, id and customerId are UUIDs provided by Tyro"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_CARD_TYPE_NOT_SUPPORTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request card type/brand/network is not supported"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_CARD_EXPIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card expired"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_CARD_NUMBER_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid card number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_TEST_CARDS_ONLY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request is currently in mode isLive=false and only testing card numbers are supported. Please refer to documentation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_ACTION_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["action must be SUBMIT and can only be used when payMethod.id & payMethod.customerId are specified"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_SECRET_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay-Secret header required"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_SECRET_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid Pay-Secret provided"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_SECRET_EXPIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay Secret is expired"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_GATEWAY_UNSUPPORTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment gateway not supported"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_PARTNER_NOT_CONFIGURED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Partner config is missing for partner: ${partnerId}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_MERCHANT_MAPPING_NOT_CONFIGURED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant Id mapping not found for locationId: ${locationId}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_INVALID_STATUS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay Request cannot be re-processed when the status is ${status}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_UPDATE_AUTHORISATION_NOT_SUPPORTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorisation update is not supported for this request. This may be due to the card scheme or because the feature is not enabled for your account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_UPDATE_AUTHORISATION_EXCEEDS_MAX_UPDATES"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorisation cannot be updated because the maximum number of allowed updates has been reached."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_UPDATE_AUTHORISATION_AMOUNT_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The updated authorisation amount must be greater than the original authorised amount."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_UPDATE_AUTHORISATION_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The request to update authorisation was not successful and the original authorisation is preserved."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-pay-request-error","__idx":4},"children":["Sample Pay Request Error"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"error\": \"Pay request not found\",\n  \"errorCode\": \"PAY_REQUEST_NOT_FOUND\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pay-method-errors","__idx":5},"children":["Pay Method Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The types of Pay Method errors are:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Pay Method Error Code"},"children":["Pay Method Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_METHOD_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay Method(s) not found for customerId"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_METHOD_PARTNER_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid partner, pay method Id combination"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_METHOD_CUSTOMER_PARTNER_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This customer does not belong to given partner"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_METHOD_CUSTOMER_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid customer"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-pay-method-error","__idx":6},"children":["Sample Pay Method Error"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"error\": \"Pay Method(s) not found for customerId\",\n  \"errorCode\": \"PAY_METHOD_NOT_FOUND\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pay-refund-errors","__idx":7},"children":["Pay Refund Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The types of Pay Refund errors are:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Pay Refund Error Code"},"children":["Pay Refund Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REFUND_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refund request not found"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REFUND_ALREADY_REFUNDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full amount already refunded"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REFUND_EXCEEDS_REFUNDABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requested refund amount exceeds refundable amount"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REFUND_REQUEST_NOT_CAPTURED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pay request must be captured before it can be refunded"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-pay-refund-error","__idx":8},"children":["Sample Pay Refund Error"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"error\": \"Refund request not found\",\n  \"errorCode\": \"PAY_REFUND_NOT_FOUND\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3d-secure-errors","__idx":9},"children":["3D Secure Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The types of 3D Secure errors are:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"3D Secure Error Code"},"children":["3D Secure Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THREED_SECURE_MERCHANT_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Could not find matching merchant token for merchantId: ${merchantId}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THREED_SECURE_PAY_REQUEST_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No Pay Request found for 3dsecure transaction id: ${transactionId}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THREED_SECURE_CARD_NOT_SUPPORTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card does not support 3ds: ${payRequestId}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THREED_SECURE_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3ds authentication failed for pay request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THREED_SECURE_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No 3ds transaction id for Pay Request: ${payRequestId}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THREED_SECURE_PAY_METHOD_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No payment method details for Pay Request: ${payRequestId}"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THREED_SECURE_CURRENCY_INVALID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid currency on Pay Request ${payRequestId}: ${currency}"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-3d-secure-error","__idx":10},"children":["Sample 3D Secure Error"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"error\": \"3ds authentication failed for pay request\",\n  \"errorCode\": \"THREED_SECURE_FAILED\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tyrosdk-errors","__idx":11},"children":["TyroSDK Errors"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"TyroSDK Error Code"},"children":["TyroSDK Error Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ENVIRONMENT_MISMATCH"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There is an environment mismatch. Check TyroProvider was initialised with the correct value for liveMode"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WALLET_INIT_FAILED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Something went wrong when trying to initialise wallet payments i.e. Apple Pay/GooglePay"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_INITIALISED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TyroProvider is not initialised. Check it is wrapping your checkout components"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MISSING_MERCHANT_CONFIG"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TyroProvider Failed to init due to missing Google and/or Apple Pay merchant details"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO_PAY_SECRET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Occurs when the pay secret has not been passed to the pay sheet."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_CARD_TYPE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card type not supported."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_CARD_DETAILS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card details provided are invalid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TIMEOUT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When polling for the pay request result with Tyro, the action timed out"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNKNOWN_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unknown error occurred"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED_TO_SUBMIT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Failed to submit the payment due to either network error or http error"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-tyrosdk-error","__idx":12},"children":["Sample TyroSDK Error"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"errorType\": \"CLIENT_INITIALISATION_ERROR\",\n  \"errorCode\": \"PAYSHEET_INIT_FAILED\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-types","__idx":13},"children":["Error types"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"common-error-types","__idx":14},"children":["Common error types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common Error Types that can be encountered with either Tyro.js or TyroSDK."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error type"},"children":["Error type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CARD_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Occurs when there is an issue with the card provided."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SERVER_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Occurs when there is an error on the server. This should rarely happen and should quickly resolve."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tyrojs","__idx":15},"children":["Tyro.js"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Error Types define the type of error to expect on the frontend when something goes wrong."," ","The following error types are returned:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Error type"},"children":["Error type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLIENT_VALIDATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Occurs when there is client validation error in the request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SERVER_VALIDATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Occurs when there is server validation error in the request."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tyrosdk-react-native","__idx":16},"children":["TyroSDK React Native"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the SDK encounters an error it will set tyroError.errorType to the corresponing error type seen below."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The types of errorTypes are:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"tyroError Error Types"},"children":["tyroError Error Types"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLIENT_INITIALISATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Occurs when the client failed to initialise"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAY_REQUEST_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Occurs when there is a problem with the pay request validation or payment fails"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"error-codes-1","__idx":17},"children":["Error Codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on the stage of the particular error, different error codes can be returned. Please refer to full list of supported ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/online-payments/pay-online/error-codes"},"children":["Error Codes"]},"."]}]},"headings":[{"value":"Error Codes","id":"error-codes","depth":1},{"value":"Gateway Response Errors","id":"gateway-response-errors","depth":2},{"value":"Sample Gateway Response Error","id":"sample-gateway-response-error","depth":3},{"value":"Pay Request Errors","id":"pay-request-errors","depth":2},{"value":"Sample Pay Request Error","id":"sample-pay-request-error","depth":3},{"value":"Pay Method Errors","id":"pay-method-errors","depth":2},{"value":"Sample Pay Method Error","id":"sample-pay-method-error","depth":3},{"value":"Pay Refund Errors","id":"pay-refund-errors","depth":2},{"value":"Sample Pay Refund Error","id":"sample-pay-refund-error","depth":3},{"value":"3D Secure Errors","id":"3d-secure-errors","depth":2},{"value":"Sample 3D Secure Error","id":"sample-3d-secure-error","depth":3},{"value":"TyroSDK Errors","id":"tyrosdk-errors","depth":2},{"value":"Sample TyroSDK Error","id":"sample-tyrosdk-error","depth":3},{"value":"Error types","id":"error-types","depth":2},{"value":"Common error types","id":"common-error-types","depth":3},{"value":"Tyro.js","id":"tyrojs","depth":2},{"value":"TyroSDK React Native","id":"tyrosdk-react-native","depth":2},{"value":"Error Codes","id":"error-codes-1","depth":1}],"frontmatter":{"seo":{"title":"Error Codes"}},"lastModified":"2026-09-01T06:34:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/online-payments/pay-online/error-codes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}