# Error code

<table data-full-width="true"><thead><tr><th align="center">Code</th><th align="center">Textual description of the error code</th><th align="center">HTTP status</th></tr></thead><tbody><tr><td align="center">1021</td><td align="center">request validation error</td><td align="center">400</td></tr><tr><td align="center">5102</td><td align="center">undefined transaction type</td><td align="center">404</td></tr><tr><td align="center">8301</td><td align="center">unexpected db error</td><td align="center">500</td></tr><tr><td align="center">5400</td><td align="center">couldn't receive project data</td><td align="center">500</td></tr><tr><td align="center">5406</td><td align="center">invalid project secret</td><td align="center">400</td></tr><tr><td align="center">8008</td><td align="center">project doesn't exist</td><td align="center">404</td></tr><tr><td align="center">5000</td><td align="center">transaction already exists</td><td align="center">400</td></tr><tr><td align="center">5101</td><td align="center">undefined transaction status</td><td align="center">404</td></tr><tr><td align="center">5107</td><td align="center">transaction limit doesn't exist</td><td align="center">404</td></tr><tr><td align="center">5006</td><td align="center">transaction amount limit is over</td><td align="center">400</td></tr><tr><td align="center">5003</td><td align="center">an error occurred while creating transaction</td><td align="center">500</td></tr><tr><td align="center">5202</td><td align="center">request failed</td><td align="center">500</td></tr><tr><td align="center">1022</td><td align="center">couldn't parse response body</td><td align="center">500</td></tr><tr><td align="center">5205</td><td align="center">unavailable project server</td><td align="center">500</td></tr><tr><td align="center">3108</td><td align="center">card doesn't exist </td><td align="center">500</td></tr><tr><td align="center">3010</td><td align="center">inoperable transaction status for this method</td><td align="center">400</td></tr></tbody></table>

**Provider error codes**

Errors describing the reason of payment decline are transmitted with status “failed”. Such errors are reported as additional value parameters in:

* Webhook on payment status
* When requesting for a transaction status
* In One-click to pay in without a payment page

<table data-full-width="true"><thead><tr><th>Error code</th><th>Close caption</th></tr></thead><tbody><tr><td>100</td><td>undefined error</td></tr><tr><td>101</td><td>3DS authentication failed</td></tr><tr><td>102</td><td>invalid card</td></tr><tr><td>103</td><td>exceeds amount limit</td></tr><tr><td>104</td><td>exceeds transaction frequency limit</td></tr><tr><td>105</td><td>transaction declined by an issuer</td></tr><tr><td>106</td><td>transaction declined by an acquirer</td></tr><tr><td>107</td><td>unavailable issuer</td></tr><tr><td>108</td><td>unavailable acquirer</td></tr><tr><td>109</td><td>payment is forbidden for the merchant</td></tr><tr><td>110</td><td>stolen card</td></tr><tr><td>111</td><td>blocked card</td></tr><tr><td>112</td><td>non existent card</td></tr><tr><td>113</td><td>lost card</td></tr><tr><td>114</td><td>card has expired</td></tr><tr><td>115</td><td>incorrect CVV/CVC</td></tr><tr><td>116</td><td>incorrect card number</td></tr><tr><td>117</td><td>incorrect card expiration date</td></tr><tr><td>118</td><td>insufficient funds</td></tr><tr><td>119</td><td>suspicious client</td></tr><tr><td>120</td><td>user did not pay</td></tr><tr><td>121</td><td>invalid threeD secure parameters</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tarlanpayments.kz/eng/acquiring/error-code.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
