• Home
  • Definitions
  • API
  • About
    • Intended Audience
    • PIN Validation
    • Logging
    • Transaction Reversal
    • Error handling
    • Request ID
    • Date Format
  • Getting Started
    • Environments
    • API Endpoint Format
  • Certification and Going Live
  • Documentation
    • Authentication
    • Loading
    • Redeeming
      • Basket
        • Basket Scenario 1
        • Basket Scenario 2
        • Basket Scenario 3
        • Basket Scenario 4
    • Balance
    • Reversing
    • Card Actions
    • Understanding Responses
      • Response Codes
      • Common Causes for Non-Zero Response Codes
        • Card Locking
        • Limits
        • Expiry
        • MID Transaction Control
        • Card Range Management
        • Part-Payment/ Insufficient Funds
      • Response Code 20
    • Miscellaneous
      • Start Date
      • User Interface
      • Observations
      • Timeouts, Retries & Rate Limits
      • Card Types and Card Status

Understanding Responses

Except in exceptional circumstances the API will return with HTTP 200. Success/Failure is denoted by the responseCode field that is part of all response payloads. Zero (0) denotes "success". The sections below describe the non-zero response codes that are returned in the case of "failure" and "partial success".

This section provides information on response codes.

Response Codes

Common Causes

Response Code 20


Next Section