SDK Errors
Pay3 SDK provides error states that can be access from the Application.
Initialisation Errors
Code | Message | Description |
|---|---|---|
1001 | Failed to initialize | Error connecting with services while initializing the client-side wallet. Make sure the clientId is enabled and configured. |
1002 | Domain not whitelisted | To enable the wallet in a new domain, please contact us. |
1003 | Not initialized | This error can happen when the application uses SDK components and features before initialization. |
Transaction Errors
Code | Message | Description | |
|---|---|---|---|
7001 | Unable to fetch buy offer | Error fetching suitable offer while initialising the transaction. This can happen if the amount doesn't match limit checks, payment method and country not supported. | |
| | | |
8001 | KYC Under Review | Account held pending compliance review. | |
8001.1 | KYC Under Review | Possible match found in AML screening. | |
8001.2 | KYC Under Review | AML screening could not be completed, ask user to resubmit KYC to proceed. | |
| | | |
9002 | No route found for checkout | Currently there is no partner supporting the selected payment method. | |
| | | |
9003 | Payment Cancelled | Payment cancelled during the checkout process. | |
| | | |
9004 | Failure with partner | Error occurred while the payment was processed by the payment partner. | |
9004.1 | Failure with partner | User limit exceeded. | |
9004.2 | Failure with partner | Error trying to validate tax ID document. | |
9004.3 | Failure with partner | Invalid transaction ID. | |
9004.4 | Failure with partner | Transaction is invalid. | |
| | | |
9005 | Payment Declined | Downstream payment partner declined the transaction. | |
9005.1 | Payment Declined | TaxID doesn’t exist. | |
9005.2 | Payment Declined | CPF query for minors blocked in compliance with the General Data Protection Law - LGPD. | |
9005.3 | Payment Declined | TaxID pending regularisation. | |
9005.4 | Payment Declined | TaxID suspended. | |
9005.5 | Payment Declined | TaxID canceled by local authority. | |
9005.6 | Payment Declined | Impeached TaxID. | |
9005.7 | Payment Declined | Transaction declined for unknown reason. | |
9005.8 | Payment Declined | Payment rejected by risk analysis. | |
9005.9 | Payment Declined | Unauthorized. Invalid security code. | |
9005.10 | Payment Declined | Unauthorized. Restricted card. | |
9005.11 | Payment Declined | Unauthorized. Card expired. | |
9005.12 | Payment Declined | Unauthorized. The card does not belong to the payment network. | |
9005.13 | Payment Declined | Unauthorized. Check the situation of the store with the issuer. | |
9005.14 | Payment Declined | There is an issue with this card. Please contact the issuer. | |
9005.15 | Payment Declined | Transaction not authorized. Please try again. | |
9005.16 | Payment Declined | Invalid/Incorrect Destination Account. | |
9005.17 | Payment Declined | Insufficient funds in Payout account. | |
9005.18 | Payment Declined | User payment declined due to source account mismatch. | |
9005.19 | Payment Declined | Missing Destination Account. | |
9005.20 | Payment Declined | No Payin prior to Payout. | |
9005.21 | Payment Declined | Payment was not completed on time. | |
9005.22 | Payment Declined | Transaction failed at processor end due to risk control.Please try using a different payment method/card. | |
9005.23 | Payment Declined | Account is invalid or not active. | |
9005.24 | Payment Declined | User information entered is invalid. | |
9005.25 | Payment Declined | System is busy, please try again later. | |
9005.26 | Payment Declined | Request timed out. | |
9005.27 | Payment Declined | Unknown error. | |
9005.28 | Payment Declined | The signature verify failed. | |
9005.29 | Payment Declined | Invalid merchant. | |
9005.30 | Payment Declined | Invalid merchant APP. | |
9005.31 | Payment Declined | Invalid parameter - input parameter field length does not meet the requirement. | |
9005.32 | Payment Declined | Amount is incorrect. | |
9005.33 | Payment Declined | Invalid country, please refer to Supported Country/Region and Currency. | |
9005.34 | Payment Declined | Invalid currency, please refer to Supported Country/Region and Currency. | |
9005.35 | Payment Declined | Invalid contract, please check contract validity. | |
9005.36 | Payment Declined | The payment method does not exist; please change to other payment methods. | |
9005.37 | Payment Declined | The payment method is temporarily unavailable; please change to another payment method. | |
9005.38 | Payment Declined | Maximum amount limit. | |
9005.39 | Payment Declined | Amount limit. | |
9005.40 | Payment Declined | Duplicate order. | |
9005.41 | Payment Declined | The merchant is not onboarded; please complete merchant onboarding | |
9005.42 | Payment Declined | Payment is being processed; please try again later. | |
9005.43 | Payment Declined | Invalid ledger participant. | |
9005.44 | Payment Declined | Order closed. | |
9005.45 | Payment Declined | Insufficient Balance. | |
9005.46 | Payment Declined | OTP verification exceeds limit. | |
9005.47 | Payment Declined | OTP verification failed. | |
9005.48 | Payment Declined | Verification times exceeded. | |
9005.49 | Payment Declined | Barcode refresh limit. | |
9005.50 | Payment Declined | Barcode refresh failed. | |
9005.51 | Payment Declined | Invalid card number. | |
9005.52 | Payment Declined | Invalid card number validity period. | |
9005.53 | Payment Declined | Invalid cardholder name. | |
9005.54 | Payment Declined | Invalid CVV. | |
9005.55 | Payment Declined | Unsupported card. | |
9005.56 | Payment Declined | Invalid phone number. | |
9005.57 | Payment Declined | Invalid UPI. | |
9005.58 | Payment Declined | Pin verification exceeds limit. | |
9005.59 | Payment Declined | Invalid PIN. | |
9005.60 | Payment Declined | Invalid bank card number. | |
9005.61 | Payment Declined | Invalid ID number. | |
9005.62 | Payment Declined | Invalid Email. | |
9005.63 | Payment Declined | Invalid document. | |
9005.64 | Payment Declined | Invalid TC Kimlik No. | |
9005.65 | Payment Declined | Invalid date format. | |
9005.66 | Payment Declined | Invalid payee name. | |
9005.67 | Payment Declined | Invalid remark. | |
9005.68 | Payment Declined | Invalid CNIC. | |
9005.69 | Payment Declined | Payment Failed. | |
9005.70 | Payment Declined | Account locked/frozen. | |
9005.71 | Payment Declined | User canceled third-party payment. | |
9005.72 | Payment Declined | Your payment was declined due to authentication failure. Please try using a different card or contact your issuer for more detail. | |
9005.73 | Payment Declined | Authorization expired. | |
9005.74 | Payment Declined | Authorization failed or does not exist. | |
9005.75 | Payment Declined | Merchant blacklist blocking. | |
9005.76 | Payment Declined | Request rejected by third party. | |
9005.77 | Payment Declined | The order does not exist. | |
9005.78 | Payment Declined | Refund failed; the payment method does not support refund. | |
9005.79 | Payment Declined | Invalid refund order number. | |
9005.80 | Payment Declined | The customer bank account has been closed. | |
9005.81 | Payment Declined | The country of the business address provided does not match the account country. | |
9005.82 | Payment Declined | Account country change requires additional steps. | |
9005.83 | Payment Declined | Some account information mismatches with one another. | |
9005.84 | Payment Declined | The bank account number provided is invalid. | |
9005.85 | Payment Declined | The specified amount is greater than the minimum amount allowed | |
9005.86 | Payment Declined | The specified amount is less than the minimum amount allowed | |
9005.87 | Payment Declined | The bank account provided cannot be used to charge. | |
9005.88 | Payment Declined | The customer account cannot be used with the payment method | |
9005.89 | Payment Declined | This card has been declined too many times. | |
9005.90 | Payment Declined | The customer account has insufficient funds to cover this payment. | |
9005.91 | Payment Declined | An error occurred when processing the card. | |
9005.92 | Payment Declined | Too many requests hit the API too quickly. | |
9005.93 | Payment Declined | The bank routing number provided is invalid. | |
9005.94 | Payment Declined | The shipping address information cannot be used to accurately determine tax rates. | |
9005.95 | Payment Declined | Customer's payment instrument is inactive. | |
9005.96 | Payment Declined | Customer's payment instrument was blocked by the network | |
9005.97 | Payment Declined | Request session is timed out. Kindly retry after sometime. | |
9005.98 | Payment Declined | A network infrastructure error was detected | |
9005.99 | Payment Declined | Transaction declined due to invalid issuer. | |
9005.100 | Payment Declined | Transaction failed due to host timeout. | |
9005.101 | Payment Declined | There is some temporary issue from the bank side. | |
9005.102 | Payment Declined | Transaction failed due to system error. | |
9005.103 | Payment Declined | System error was detected at payment processor end | |
9005.104 | Payment Declined | Transaction failed due to unknown error. | |
9005.105 | Payment Declined | Problem occurred while getting terminal | |
9005.106 | Payment Declined | Transaction failed due to acquirer not participating. | |
9005.107 | Payment Declined | Transaction failed due to invalid card type. | |
9005.108 | Payment Declined | The server encountered an unexpected error while processing the request. | |
9005.109 | Payment Declined | Transaction rejected at NPCI. Please contact the acquirer. | |
9005.110 | Payment Declined | There is some network issue from the bank side. | |
9005.111 | Payment Declined | Invalid card status for the provided card details. | |
9005.112 | Payment Declined | Transaction declined because service is not available. | |
9005.113 | Payment Declined | Issuer bank did not respond on time. | |
9005.114 | Payment Declined | Issuer bank or payment service provider declined the transaction. | |
9005.115 | Payment Declined | Payment service provider declined the transaction | |
9005.116 | Payment Declined | Customer has exceeded the withdrawal amount limit. | |
9005.117 | Payment Declined | Card is restricted or not valid. | |
9005.118 | Payment Declined | Transaction declined because of violation of law. | |
9005.119 | Payment Declined | Transaction is not captured. | |
9005.120 | Payment Declined | Transaction failed due to various reasons (invalid mpin, user connectivity issue). | |
9005.121 | Payment Declined | Transaction declined because of suspected fraud. | |
9005.122 | Payment Declined | User has exceeded daily limit of transferring funds. | |
9005.123 | Payment Declined | Transaction declined because of blocked account. | |
9005.124 | Payment Declined | Transaction failed as the authentication failed at bank end. | |
9005.125 | Payment Declined | The request the client made is incorrect or corrupt. | |
9005.126 | Payment Declined | Bank unable to authorize the transaction. | |
9005.127 | Payment Declined | Customer has exceeded the withdrawal count limit. | |
9005.128 | Payment Declined | Transaction declined as the session got expired for this transaction. | |
9005.129 | Payment Declined | Transaction declined due to risk. | |
9005.130 | Payment Declined | Customer account is closed. | |
9005.131 | Payment Declined | Transaction declined as the card is expired or incorrect expiry date. | |
9005.132 | Payment Declined | Transaction not permitted to cardholder. | |
9005.133 | Payment Declined | Amount exceeded the authorized merchant limit. | |
9005.134 | Payment Declined | Inactive card or card not authorized for card not present transaction. | |
9005.135 | Payment Declined | Transaction not permitted to cardholder. | |
9005.136 | Payment Declined | Customer has exceeded the withdrawal frequency limit. | |
9005.137 | Payment Declined | Transaction declined because of blocked account/card. | |
9005.138 | Payment Declined | Transaction daily limit exceeded. | |
9005.139 | Payment Declined | This transaction has been declined/canceled by the user. | |
9005.140 | Payment Declined | Transaction exceeds credit card limit. | |
9005.141 | Payment Declined | PSP/Bank server downtime. Kindly retry after sometime. | |
9005.142 | Payment Declined | User is not authorized to perform this action. Reach out to issuer bank. | |
9005.143 | Payment Declined | Transaction declined because it exceeds risk threshold. | |
9005.144 | Payment Declined | Customer entered incorrect card number details. | |
9005.145 | Payment Declined | Retry the transaction. | |
9005.146 | Payment Declined | This PSP is not allowed to initiate this payment. | |
9005.147 | Payment Declined | Transaction amount limit exceeded. | |
9005.148 | Payment Declined | Some of the details related to the transaction are missing. | |
9005.149 | Payment Declined | Transaction is not allowed by bank. | |
9005.150 | Payment Declined | PSP server downtime. Kindly retry after sometime. | |
9005.151 | Payment Declined | User's phone number is not registered to the bank. | |
9005.152 | Payment Declined | Invalid Request. | |
9005.153 | Payment Declined | Transaction cost or currency not supplied. | |
9005.154 | Payment Declined | Cart ID not set. | |
9005.155 | Payment Declined | Invalid store ID. | |
9005.156 | Payment Declined | Invalid transaction mode. | |
9005.157 | Payment Declined | Card expiry not supplied. | |
9005.158 | Payment Declined | Card start date not supplied. | |
9005.159 | Payment Declined | Card issue number not supplied. | |
9005.160 | Payment Declined | Card number not supplied. | |
9005.161 | Payment Declined | Invalid card security code (CVV). | |
9005.162 | Payment Declined | Card security code (CVV) not supplied. | |
9005.163 | Payment Declined | Name not valid/not supplied. | |
9005.164 | Payment Declined | Address not valid/not supplied. | |
9005.165 | Payment Declined | Country not valid/not supplied. | |
9005.166 | Payment Declined | IP address not valid/not supplied. | |
9005.167 | Payment Declined | Card/Currency/Class combination not supported. | |
9005.168 | Payment Declined | Invalid transaction reference. | |
9005.169 | Payment Declined | Amount differs from original. | |
9005.170 | Payment Declined | Currency differs from original. | |
9005.171 | Payment Declined | Original transaction not authorised. | |
9005.172 | Payment Declined | Original transaction already voided. | |
9005.173 | Payment Declined | Original transaction mismatch. | |
9005.174 | Payment Declined | Invalid start date. | |
9005.175 | Payment Declined | Card details differ from original. | |
9005.176 | Payment Declined | Not authorised. | |
9005.177 | Payment Declined | Original transaction cannot be voided. | |
9005.178 | Payment Declined | Cancelled. | |
9005.179 | Payment Declined | No response. | |
9005.180 | Payment Declined | Unable to refund. | |
9005.181 | Payment Declined | Previous transaction is on hold. | |
9005.182 | Payment Declined | Invalid transaction class. | |
9005.183 | Payment Declined | Invalid transaction type. | |
9005.184 | Payment Declined | Email not valid/not supplied. | |
9005.185 | Payment Declined | Phone number not valid/not supplied. | |
9005.186 | Payment Declined | Transaction mode differs from original. | |
9005.187 | Payment Declined | 3DSecure authentication not available for this card. | |
9005.188 | Payment Declined | 3DSecure authentication rejected. | |
9005.189 | Payment Declined | Description not set. | |
9005.190 | Payment Declined | Sold Out. | |
9005.191 | Payment Declined | Card is for ATM use only. | |
9005.192 | Payment Declined | Invalid transaction Method. | |
9005.193 | Payment Declined | Transaction part not specified. | |
9005.194 | Payment Declined | Unable to access transaction part. | |
9005.195 | Payment Declined | Error connecting to service provider. | |
9005.196 | Payment Declined | Request aborted. | |
9005.197 | Payment Declined | Verification failed. | |
9005.198 | Payment Declined | Refer to card issuer. | |
9005.199 | Payment Declined | Do not honor. | |
9005.200 | Payment Declined | Address verification (AVS) mismatch. | |
9005.201 | Payment Declined | Card security code (CVV) and address (AVS) mismatch. | |
9005.202 | Payment Declined | Card is not enabled for e-commerce. | |
9005.203 | Payment Declined | Card cancelled. | |
9005.204 | Payment Declined | No/invalid account. | |
9005.205 | Payment Declined | Invalid Terminal configurations. | |
9005.206 | Payment Declined | Invalid value for split parameter. | |
9005.207 | Payment Declined | Split payment not enabled for the store. | |
9005.208 | Payment Declined | Card token validation failed. | |
9005.209 | Payment Declined | STCPay order creation falied. | |
9005.210 | Payment Declined | Paypal order creation falied. | |
9005.211 | Payment Declined | Problem with Cybersource configurations. | |
9005.212 | Payment Declined | Anti-fraud pre-auth. | |
9005.213 | Payment Declined | Anti-fraud post-auth. | |
9005.214 | Payment Declined | Card limits exceeded. | |
9005.215 | Payment Declined | Terminal limits. | |
9005.216 | Payment Declined | Fraud deteted by the acquirer. | |
9005.217 | Payment Declined | Multiple email used with the same card. | |
9005.218 | Payment Declined | Internal system error. | |
9005.219 | Payment Declined | Invalid end date. | |
9005.220 | Payment Declined | Limit value should be less than or equal to 4000. | |
9005.221 | Payment Declined | The date range exceeds seven days. | |
9005.222 | Payment Declined | Invalid or less parameters in URL. | |
9005.223 | Payment Declined | From date can not be grater than to date. | |
9005.224 | Payment Declined | Transaction is already captured. | |
9005.225 | Payment Declined | Invalid path parameter. | |
9005.226 | Payment Declined | Acquirer system error. | |
9005.227 | Payment Declined | Invalid issuer. | |
9005.228 | Payment Declined | Restricted. | |
9005.229 | Payment Declined | Closed card/account. | |
9005.230 | Payment Declined | Authorisation revoked. | |
9005.231 | Payment Declined | Fraud suspected by issuer. | |
9005.232 | Payment Declined | Fraud suspected by scheme. | |
9005.233 | Payment Declined | Scheme lifecycle/policy. | |
9005.234 | Payment Declined | Unable to route. | |
9005.235 | Payment Declined | OTP Limit exceeded. | |
9005.236 | Payment Declined | Already paid. | |
9005.237 | Payment Declined | Payment expired. | |
9005.238 | Payment Declined | Coupon expired or invalid – cannot apply to subscription. | |
9005.239 | Payment Declined | Payment mandate invalid or expired – re-auth needed. | |
9005.240 | Payment Declined | Invoice locked/finalized – cannot modify. | |
9005.241 | Payment Declined | Payment requires customer authentication (3DS/SCA). | |
9005.242 | Payment Declined | Authentication required – ask user to complete 3DS or update payment method | |
9005.243 | Payment Declined | Payment declined – ask user to try another card or update default payment method | |
9005.244 | Payment Declined | Bank account blocked – ask user to add another account or payment method | |
9005.245 | Payment Declined | Payment method not available – ask user to select another method | |
9005.246 | Payment Declined | Authentication failed – ask user to retry or update payment method | |
9005.247 | Payment Declined | Payment attempt failed – ask user to retry or change method | |
9005.248 | Payment Declined | Payment expired – ask user to retry or update payment method | |
9005.249 | Payment Declined | Card expired – ask user to update card or provide a new one"). | |
9005.250 | Payment Declined | Card declined – ask user to try another card. | |
9005.251 | Payment Declined | Address mismatch – ask user to correct billing address. | |
9005.252 | Payment Declined | Invalid CVC – ask user to re-enter or use a different card. | |
9005.253 | Payment Declined | Invalid card number – ask user to correct it. | |
9005.254 | Payment Declined | Postal code mismatch – ask user to correct ZIP. | |
9005.255 | Payment Declined | Invalid CVC – ask user to correct or use another card. | |
9005.256 | Payment Declined | Invalid expiry month – ask user to update details. | |
9005.257 | Payment Declined | Invalid expiry year – ask user to update details. | |
9005.258 | Payment Declined | Invalid field format. | |
9005.259 | Payment Declined | Invalid mandatory field. | |
9005.260 | Payment Declined | Unauthorized. | |
9005.261 | Payment Declined | Feature not allowed. | |
9005.262 | Payment Declined | Invalid transaction status. | |
9005.263 | Payment Declined | Invalid routing. | |
9005.264 | Payment Declined | Bank not supported. | |
9005.265 | Payment Declined | Invalid Card/Account/Virtual Account/Customer info. | |
9005.266 | Payment Declined | Bill blocked or not found. | |
9005.267 | Payment Declined | Bill expired. | |
9005.268 | Payment Declined | Invalid Product ID. | |
9005.269 | Payment Declined | Invalid Transaction Invoice. | |
9005.270 | Payment Declined | Invalid Seller Or Acquiring Bank Code. | |
9005.271 | Payment Declined | Invalid amount. | |
9005.272 | Payment Declined | Invalid Buyer Account. | |
9005.273 | Payment Declined | Invalid Bank | |
9005.274 | Payment Declined | Invalid Seller Exchange Or Seller. | |
9005.275 | Payment Declined | Maximum Transaction Limit Exceeded. | |
9005.276 | Payment Declined | Invalid Seller for Merchant Specific Limit | |
9005.277 | Payment Declined | Transaction Not Permitted | |
9005.278 | Payment Declined | Transaction To Merchant Not Permitted | |
9005.279 | Payment Declined | Invalid Buyer Name Or Buyer ID | |
9005.280 | Payment Declined | Blocked Bank | |
9005.281 | Payment Declined | Invalid Transaction setup. | |
9005.282 | Payment Declined | Cardholder is not enrolled in 3D Secure | |
9005.283 | Payment Declined | Transaction retry limit exceeded | |
9005.284 | Payment Declined | Authentication is not currently available | |
9005.285 | Payment Declined | KYC document expired | |
9005.286 | Payment Declined | KYC document image not detected | |
9005.287 | Payment Declined | KYC document blocklisted | |
9005.288 | Payment Declined | KYC minimum age not met | |
9005.289 | Payment Declined | KYC maximum age exceeded | |
9005.290 | Payment Declined | KYC name not detected | |
9005.291 | Payment Declined | KYC date of birth not detected | |
9005.292 | Payment Declined | KYC document number not detected | |
9005.293 | Payment Declined | KYC document has invalid date | |
9005.294 | Payment Declined | KYC name mismatch | |
9005.295 | Payment Declined | KYC date of birth mismatch | |
9005.296 | Payment Declined | KYC gender mismatch | |
9005.297 | Payment Declined | KYC country mismatch | |
9005.298 | Payment Declined | KYC nationality mismatch | |
9005.299 | Payment Declined | KYC ID number mismatch | |
9005.300 | Payment Declined | KYC image portrait manipulation detected | |
9005.301 | Payment Declined | KYC poor face match similarity | |
9005.302 | Payment Declined | KYC QR/barcode validation failed | |
9005.303 | Payment Declined | KYC data inconsistent across sources | |
9005.304 | Payment Declined | KYC document expiration date not detected | |
9005.305 | Payment Declined | KYC document/personal number invalid format | |
9005.306 | Payment Declined | KYC poor image quality | |
9005.307 | Payment Declined | KYC address could not be parsed | |
9005.308 | Payment Declined | KYC device integrity check failed | Payment Declined |
9005.309 | Payment Declined | KYC face/age not detected | |
9005.310 | Payment Declined | KYC face blocklisted | |
9005.311 | Payment Declined | KYC duplicate/multiple faces detected | |
9005.312 | Payment Declined | KYC capture spoofing detected | |
9005.313 | Payment Declined | KYC face match could not be performed | |
9005.314 | Payment Declined | The transaction exceeded the applicable risk threshold | |
9005.315 | Payment Declined | The transaction did not meet the applicable transaction screening requirements | |
9005.316 | Payment Declined | The transaction was declined following a compliance review | |
9005.317 | Payment Declined | The required compliance action was not completed by the user | |
9005.318 | Payment Declined | The transaction matched a potential sanctions-related risk | |
9005.319 | Payment Declined | The transaction was declined due to blocklist restrictions | |
| | | |
9006.1 | Refund Failed | There was an issue with Refund transaction. | |
9006.2 | Refund Failed | Invalid Refund Amount | |
9006.3 | Refund Failed | Invalid Refund Parent Order | |
9006.4 | Refund Failed | Refund needs to be completed manually by the bank. | |
9006.5 | Refund Failed | Currently refund cannot be processed, please reach out to client experience. | |
| | | |
9007 | Under Paid | Crypto amount received is less than expected order amount. | |
| | | |
9008.1 | Settlement Failed | Settlement can't be processed for the given order. | |
9008.2 | Settlement Under Review | Review details are already submitted | |
9008.3 | Settlement Failed | Invalid request id | |
9008.4 | Settlement Under Review | Retry limit reached | |
9008.5 | Settlement Under Review | Processing issue | |
9008.6 | Settlement Under Review | System error | |
9008.7 | Settlement Under Review | Confirmation timeout | |