LogoLogo
API ReferencesGithubSupport CenterStatus pageBecome a Partner
  • Getting Started
    • Welcome
    • Our Products
  • Integration Process
  • Devices
    • Dejavoo
    • PAX
    • ID TECH
  • Become a Partner
  • Developer Resources
    • Overview
    • Sandbox & Production Environments
  • Testing Integration
    • Test Cards & ACH Accounts
    • Onboarding API Result Codes
    • Transaction Error Generation Data
    • Card Response & Result Codes
      • Card Error Response Codes
      • Card Transaction Result Codes
      • CSC Response Codes
      • AVS Response Codes
      • Duplicate Transaction Settings
    • ACH Request Validation & Return Codes
      • ACH Request Validation Codes
      • ACH Return Codes
  • API Catalog
    • Merchant Onboarding APIs
    • Transaction (Quest) APIs
    • Automated Merchant Onboarding Setup API
    • Reporting API
  • Webhooks
    • Prerequisites
    • Transaction Webhook
    • Onboarding Webhooks
      • Application Status
      • Application Fixes
      • Equipment Tracking & Activation
        • Equipment Tracking
        • Equipment Activation
  • Merchant Onboarding
    • Overview
  • Automated Merchant Onboarding
    • Prerequisites
    • Working with Automated Merchant Onboarding
      • Generating a Merchant Application
      • Completing the Application
      • Modifying Default Merchant Pricing
        • Retrieving Existing Pricing Templates
        • Modifying Pricing Fees & Completing Merchant Application Record
    • Merchant Onboarding Status Webhooks
    • Configuring Automated Merchant Onboarding
  • Merchant Onboarding via Partner Portal
    • Starting New Application
    • Adding Hierarchy & Compensation Details
    • Entering Business Information
    • Entering Profile Details
    • Conducting the Site Survey
    • Configuring Pricing Details
    • Adding Banking Information
    • Adding Equipment
    • Submitting Signature
    • Reviewing & Submitting Application
    • Viewing Application Summary
  • Merchant Onboarding via API
    • Prerequisites
    • Understanding Integration
    • Working with Merchant Onboarding API
      • Creating a Merchant Profile
      • Completing the Merchant Application
        • Gathering Merchant Demographics
        • Configuring Merchant Pricing
        • Ordering and Setting Up Equipment
      • Submitting the Signature
      • Submitting the Application
  • Payment Processing Solutions
    • Overview
    • Cloud EMV
      • Working with Cloud EMV
        • Direct Data Transfer to Clearent's Cloud
        • Payment Authorization Process via Clearent's Quest Payment Gateway
    • JavaScript SDK
      • Prerequisites
        • Browser Support
      • Working with JavaScript SDK
        • Adding the Payment Form
        • Formatting the Payment Form
        • Processing the Payment
        • Using Apple Pay for Web
        • Using Google Pay for Web
        • Using IDTech VP8300
      • Card Validations
        • Card Number Validation
        • Card Expiration Date Validation
        • Card CSC/CVC Validation
      • Configuring with JavaScript SDK
        • Using Members
        • Using Methods
  • Hosted Payments
    • Prerequisites
      • Browser Support
    • Working with Hosted Payments
      • Configuring the Pay Now Button
      • Configuring Payment Page with an Amount Field
      • Configuring Payment Page with an Optional Billing Address and Headline Text
      • Configuring Payment Page with the Save Card Option
      • Configuring the Add Payment Method Button
      • Styling Your Brand on the Payment Page
      • Configuring Apple Pay for Web
      • Configuring Hosted Payment Page Using Members
      • Configuring Hosted Payment Page Using Methods
      • Configuring Hosted Payment Page Using Functions
    • Transaction Responses
      • Successful Transaction Response
      • Successful Transaction Response for a Billing Address
      • Failed Transaction Response
      • Unauthorized Request Response
      • Successful Transaction Response for a Token
      • Successful Token Request Response
    • Response Validations
      • Successful Transaction Response Validation
      • Failed Transaction Response Validation
    • Card Validations
  • Mobile EMV SDK
    • Working with Mobile Card Reader
    • Working with iOS Framework for IDTech VP3300
      • Processing Payments for iOS Applications
        • Pairing the VP3300 Card Reader with Your iOS Phone or Tablet
        • Charging the VP3300 Card Reader
        • Reading the Card Data Using the IDTech VP3300
        • Clearent's iOS Framework for IDTech VP3300 - Pre-requisites
        • Clearent's iOS Framework for IDTech VP3300 - Additional Configuration
        • Adding Clearent's iOS Framework into your iOS Application
        • Setting Up Clearent's iOS Framework for your Objective-C iOS App
        • Starting a Transaction using Clearent's iOS Framework
        • Starting a Connection using Clearent's iOS Framework
        • Starting a Connection using Clearent's iOS Framework
        • Receiving Feedback Messages using Clearent's iOS Framework
    • Working with Android Framework for IDTech VP3300
      • Configuring an Android Framework for your App
      • Additional Configuration to your Android App
      • Generating a Transaction Token for Manual card Entry
      • Disabling Default EMV Configuration for the Card Reader
      • Configuring Experience with Clearent's Android Framework
  • ACH Transaction Integration
    • Integration Methods for the ACH Transactions
    • Processing an ACH Transaction
    • Getting an ACH Transaction
    • Creating an ACH Transaction Token
    • Handling Returns for the ACH Transactions
    • Checking an ACH Transaction Status
    • ACH Transaction Statuses
    • ACH Transaction Return Codes
  • Paylink
    • The Paylink URL
    • Working with the Paylink
      • Setting up the Paylink
      • Configuring the Paylink URL
      • Using the Paylink Settings API
        • Request Parameters
      • Getting the Paylink Settings
      • Applying the Paylink Settings
      • Sending the Paylink SMS
  • Virtual Terminal
    • Working with the Virtual Terminal
      • Accessing Virtual Terminal
      • Adding or Ordering the Equipment
      • Recurring Payments
        • Adding a New Customer
        • Adding a Payment Method
        • Adding a New Payment Plan
        • Viewing the Plans
      • Processing Sales Transaction
      • Processing ACH Transaction
      • Transaction Search
        • Viewing Transactions
        • Viewing Transaction Receipt
        • Printing Transaction Receipt
        • Emailing Transaction Receipt
        • Void a Transaction
        • Refund a Transaction
        • Processing Pending Transactions
      • Open Batches
        • Viewing Batches
      • VT Settings
        • Merchant
        • Terminal
        • External Terminal
        • Address Verification (AVS)
        • Card Security Code (CSC)
        • Hosted Payment Page (HPP)
  • Financial Management
    • Overview
    • Merchant Pricing
  • Merchant Billing & Funding
  • Financial Reporting
  • Disputes Management
    • Understanding Charge Disputes
    • Managing Disputes in Merchant Portal
    • Managing Disputes via API (Coming Soon!)
  • Reporting
    • Overview
  • Reporting Solutions
  • Working with Reporting API
    • Accessing Reports
    • Retrieving Reports
    • Exporting Reports
  • Support Ticketing
    • Overview
    • Benefits of Support Ticketing System
    • Accessing Support in the Portals
    • Working with Support Ticketing via Partner Portal
      • Types of Support Tickets
      • Submitting a Support Ticket via Partner Portal
  • Working with Support Ticketing via Merchant Portal
    • Types of Support Tickets
    • Submitting a Support Ticket via Merchant Portal
  • Partner & Merchant Solutions
    • Overview
    • Accessing the Portals
    • Navigating the User Interface
    • Working with the Partner Portal
      • Monitoring Performance with Dashboards
      • Managing Merchant Applications
      • Managing Merchants
      • Accessing Reports & Managing Subscriptions
        • Accessing Reports
        • Managing Subscriptions
      • Submitting a Support Ticket
  • Working with the Merchant Portal
    • Monitoring Home Page
    • Accessing Batches
    • Managing Transactions
    • Managing Funding Transactions
    • Managing Virtual Terminal
    • Viewing Chargebacks
    • Managing Disputes
    • Managing Statements & Tax Forms
    • Managing Account Settings
    • Managing User Notifications
    • Managing Support Tickets
  • Security Solutions
    • Overview
    • PCI Compliance
    • Tokenization
    • Encryption
    • Advanced Compliance & Security Measures & Programs
Powered by GitBook

Resources

  • Contact
  • Support Site
  • Campus

Terms & Policies

  • Terms
  • Privacy Policy
  • Disclosures
  • Merchant Agreement

Cookies

  • Cookie List
  • Cookies Settings

Site Info

  • Sitemap

© 2025 Clearent, LLC is a registered agent for Central Bank of St. Louis, MO; Citizens Bank, N.A., Providence, RI; and Pathward, N.A., Sioux Falls, SD.

On this page

Was this helpful?

Export as PDF
  1. Testing Integration

Transaction Error Generation Data

The table below helps you simulate various error responses by using specific transaction amounts. This allows you to verify how your integration handles different error scenarios before going live.

Note: Codes may vary depending on the API endpoint. Some response codes may also have more than one associated message, as shown below.

Value
HTTP Status Code
HTTP Status Code
Amount

000

200

Approved

0.49, 0.80, 0.81, 0.82

000

200

SUCCESS

0.49, 0.80, 0.81, 0.82

001

400

Could not communicate with Terminal

001

404

Signature not found

002

500

Failed to process batch

002

402

Force Approval

002

400

Validation error

003

402

Declined by Issuer – Card expired

0.29

003

500

Failed to process batch

0.29

003

400

transaction-id required

004

402

Card Expired

0.05, 0.04

005

402

Card Suspended

006

402

Allowable Pin Entries Exceeded

0.40

007

402

Declined by Issuer – Referred – Please call Card Issuer

0.01, 0.02

008

402

Declined by Issuer – Invalid Amount

0.11, 0.32

009

400

Invalid Card Number

0.14

010

402

Declined by Issuer – Account not found

0.36, 0.37, 0.38

011

400

Invalid Request

0.31, 0.35, 0.39

012

402

Not Sufficient Funds

0.21

013

402

Transaction Not Permitted To Cardholder

014

402

Declined by Issuer – Exceeds amount limit

0.23

015

402

Declined by Issuer – Transaction not permitted

0.43, 0.44

016

402

Declined by Issuer – Frequency limit exceeded

0.22, 0.25, 0.71

017

402

Card Not Active

018

400

Invalid Pin

0.12, 0.13, 0.47

019

500

PIN Key sync error – Please call Customer Support

020

400

Invalid Currency

021

402

Declined by Issuer – Invalid card security code

0.48

022

400

Cashback Amount Exceeded

0.16

023

402

Transaction Declined By Issuer

0.04, 0.09, 0.15, 0.17

024

402

Previously Reversed

0.10

025

402

Exceeds Maximum Refundable Amount

026

402

Declined by Issuer – Invalid Card Number

027

402

Original Not Found

0.34

028

402

Invalid Terminal – Please call Customer Support

029

402

Inactive Terminal

030

402

Invalid merchant ID – Please call Customer Support

0.46

031

402

Transaction Did Not Complete Normally, Please Retry

0.03

032

402

Duplicate Transaction

0.54

033

402

Capture Card, Please Call Processor

034

402

Card Lost

0.07

035

402

Card Stolen

0.08

036

200

Advice Accepted

037

200

Advice Accepted, No Action Taken

0.33

038

402

Reconciled, In Balance

039

402

Not Reconciled, Totals Provided

040

402

No Opened Batch

041

400

Field Validation

$0.00

042

401

Unauthorized

043

400

Amount Minimum

044

400

Amount Maximum

045

402

Duplicate Transaction

046

402

Avs Response Not Accepted

047

402

Csc Response Not Accepted

048

402

Csc Response Not Accepted

049

500

No Response From Server

050

500

Internal Error

051

500

Could Not Connect

052

500

Exception Condition Contact Support

053

500

Exception Condition Contact Support

054

402

Data Element Error

055

500

Acquirer Not Supported By Switch

056

402

Transaction Destination Cannot Be Found

057

402

Card Issuer Timed Out

058

402

Card Issuer Unavailable

059

402

Duplicate Transmission

060

500

System Error, Database

061

402

Aborted, Threshold Exceeded

062

500

System misconfiguration: {MAY INCLUDE ADDITIONAL ERROR TEXT}

063

500

System Error, Transaction

064

500

System Error, Hsm

065

500

Configuration Error, Invalid Terminal

066

500

Configuration Error, Invalid Terminal

067

500

Configuration Error, Configuration Error

067

500

Configuration error, invalid merchant

068

500

Configuration Error, Configuration Error

068

500

Configuration error, inactive merchant

069

500

Configuration Error, Configuration Error

069

500

Configuration error, invalid store

070

500

Configuration error, inactive store

070

500

Configuration Error, System Error

071

500

System Error, Other

072

500

System Error Other

073

500

System Error Other

074

400

HPP Generic Error Message; query transaction for error details.

074

400

Invalid Request

074

400

Merchant-id from request does not match merchant-id of initial transaction

081

400

Create entity failed

081

400

Update entity failed

081

500

Update failed

082

400

Add entity failed

082

500

Add failed

082

404

Device not found

082

404

Entity not found

082

500

Get failed

083

400

Get entity failed

083

500

Get failed

083

400

Resource not found

084

500

Add Token To Customer Failed

084

400

Apikey on device does not belong to the terminal you have authenticated. Please check that the device was configured correctly

085

404

Unable to delete setting

085

400

Valid Content-Type Header Required for PUT or POST

086

400

Missing or Invalid Accept Type Header. Accept Type Header must be of type ‘application/json or ‘application/xml

087

400

Metadata can only have a maximum of ten key/value pairs

088

400

No body in request

089

200

Delete Successful

089

500

Error Deleting resource

089

400

Unable to delete Customer token

090

400

Required request body content is missing

090

400

Required request body content is missing, malformed, or datatype usage (ex- boolean, number) is invalid

091

402

Delete Token Failed. Token Associated With Payment Plan

091

204

No batch found to process

091

404

Object not found

091

404

Transaction not found

092

405

Http Method not supported

092

404

URL Parameter Invalid not found

093

400

Customer Delete Failed – Customer has active plans

093

400

Merchant Opt Out Delete Failed

094

400

Cannot delete Plan that has been used to charge the customer

280

400

Transaction failed

281

400

Void failed. Cannot void ach transactions that are returned or settled.

282

400

Authorization failed

283

400

Validation failed

284

400

ACH Account not found

285

400

Cannot process request. Contact Clearent for assistance

286

400

An error occurred we did not account for with Drools rules or otherwise

287

404

Transaction not found

288

400

Request failed

289

400

Provider failed

290

500

Transaction Failed

291

400

Cannot process request. Contact Clearent for assistance

292

404

Transaction not found

293

404

Transaction not found

294

500

Cannot process request. Contact Clearent for assistance

295

500

Cannot process request. Contact Clearent for assistance

880

400

Error parsing request

880

400

Error while submitting request to pax terminal

880

400

Failed to process hpp request.

880

400

Transaction failed

880

500

Unexpected Error – please contact customer support

881

400

Device communications unsupported

881

400

Manufacturer unsupported

882

400

Transaction type unsupported for this manufacturer

883

500

Terminal not connected

884

400

Terminal cannot be determined. Configure from Virtual Terminal Settings

884

400

Terminal cannot be determined. Confirm terminal is configured for Semi-Integrated mode

885

400

Device disabled

886

400

Failed to connect to Clearent Gateway. Please check device configuration

886

400

Terminal connection error

887

400

Transaction failed

888

400

Failed to serialize request as xml.

889

400

Token only request failed

889

400

Transaction failed

890

400

Transaction endpoint does not match transaction type

8801

402

Could not determine if transaction succeeded or failed

8831

500

Terminal is busy. Check terminal and try again

13005

400

Signature not valid for HPP response

PreviousOnboarding API Result CodesNextCard Response & Result Codes

Last updated 1 month ago

Was this helpful?