---
title: "List of response codes"
slug: "list-of-response-codes"
updated: 2026-06-30T10:48:08Z
published: 2026-06-30T10:48:08Z
canonical: "docs.monri.com/list-of-response-codes"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monri.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List of response codes

## General list

Here is the list of the **all response codes** from Monri WebPay and their description:

- 0000 - Approved
- 1001 - Card expired
- 1002 - Card suspicious
- 1003 - Card suspended
- 1004 - Card stolen
- 1005 - Card lost
- 1011 - Card not found
- 1012 - Cardholder not found
- 1014 - Account not found
- 1015 - Invalid request
- 1016 - Not sufficient funds
- 1017 - Previously reversed
- 1018 - Previously reversed
- 1019 - Further activity prevents reversal
- 1020 - Further activity prevents void
- 1021 - Original transaction has been voided
- 1022 - Preauthorization is not allowed for this card
- 1023 - Only full 3D authentication is allowed for this card
- 1024 - Installments are not allowed for this card
- 1025 - Transaction with installments can not be send as preauthorization
- 1026 - Installments are not allowed for non ZABA cards
- 1050 - Transaction declined
- 1054 - Transaction declined by issuer
- 1802 - Missing fields
- 1803 - Extra fields exist
- 1804 - Invalid card number
- 1806 - Card not active
- 1808 - Card not configured
- 1810 - Invalid amount
- 1811 - System error - database
- 1812 - System error - transaction
- 1813 - Cardholder not active
- 1814 - Cardholder not configured
- 1815 - Cardholder expired
- 1816 - Original not found
- 1817 - Usage limit reached
- 1818 - Configuration error
- 1819 - Invalid terminal
- 1820 - Inactive terminal
- 1821 - Invalid merchant
- 1822 - Duplicate entity
- 1823 - Invalid acquirer
- 2000 - Internal error - host down
- 2001 - Internal error - host timeout
- 2002 - Internal error - invalid message
- 2003 - Internal error - message format error
- 2013 - 3D Secure error - invalid request
- 3000 - Time expired
- 3100 - Function not supported
- 3200 - Timeout
- 3201 - Authorization host not active
- 3202 - System not ready
- 4001 - 3D Secure error - ECI 7
- 4002 - 3D Secure error - not 3D Secure, store policy
- 4003 - 3D secure error - not authenticated
- 5000 - Request in progress
- 5018 - RISK: Minimum amount per transaction
- 5019 - RISK: Maximum amount per transaction
- 5001 - RISK: Number of repeats per PAN
- 5020 - RISK: Number of approved transactions per PAN
- 5003 - RISK: Number of repeats per BIN
- 5016 - RISK: Total sum on amount
- 5021 - RISK: Sum on amount of approved transactions per PAN
- 5022 - RISK: Sum on amount of approved transactions per BIN
- 5005 - RISK: Percentage of declined transactions
- 5009 - RISK: Number of chargebacks
- 5010 - RISK: Sum on amount of chargebacks
- 5006 - RISK: Number of refunded transactions
- 5007 - RISK: Percentage increment of sum on amount of refunded transactions
- 5023 - RISK: Number of approved transactions per PAN and MCC on amount
- 5011 - RISK: Number of retrieval requests
- 5012 - RISK: Sum on amount of retrieval requests
- 5013 - RISK: Average amount per transaction
- 5014 - RISK: Percentage increment of average amount per transaction
- 5015 - RISK: Percentage increment of number of transactions
- 5017 - RISK: Percentage increment of total sum on amount
- 5050 - RISK: Number of repeats per IP
- 5051 - RISK: Number of repeats per cardholder name
- 5052 - RISK: Number of repeats per cardholder e-mail
- 6000 - Systan mismatch

## For automation purposes

These status codes can be used to automate the handling of declined transactions via the **Monri WebHook** feature (no PCI DSS needed) or in direct integration type (PCI DSS needed). For more details, refer to the Monri WebHook documentation in [Responses And Notifications](/v1/docs/notifications-1).

| **Status Code** | **Decline Reason** | **Action To Consider** |
| --- | --- | --- |
| **1050** | Generic acquirer decline | Check with Monri Helpdesk or acquiring bank |
| **1054** | Generic issuer decline | Helps identify whether the rejection originates from the acquiring or issuing side. Check with Monri Helpdesk or the acquiring bank. |
| **1001–1016** | Card or cardholder issues | Suggest trying a different card |
| **1017–1018** | Already reversed | Verify with acquiring bank |
| **1019–1020** | Requires verification with acquiring bank | Check with acquiring bank |
| **1021** | Transaction voided | Consider initiating a refund |
| **1022** | Preauthorization not allowed | Try a purchase transaction if possible |
| **1023** | 3DS authentication required | Force 3DS (if possible) |
| **1024** | Installments not allowed for this card | Try single/one-off payment or a different card |
| **1025** | Installments not allowed by this card issuer | Suggest trying a different card |
| **1026** | Installments not allowed with preauthorization | Try a purchase transaction |
| **1802–3202** | Issue in Monri-to-acquirer request | Contact Monri Helpdesk |
| **4001–4004** | 3DS authentication issues | Retry within the same session |
| **5000** | Timeout with external services | Contact Monri Helpdesk |
| **5001–5901** | Declined by risk engine | Notify bank and merchant if risk engine is active |
| **6000** | Transaction identifiers issue | Contact Monri Helpdesk |
| **6001–6004** | BIN/PAN/IP/Country blacklisted (only with merchant approval) | No action unless merchant requested or approved blacklist |