Testing Amounts

Overview

To test various transaction scenarios without using different card numbers, you can use specific transaction amounts in your test requests. When you submit a payment with these designated amounts, we will return specific response codes and decline reasons, allowing you to validate your integration's handling of different outcomes.

This testing method is particularly useful for simulating specific decline scenarios and testing your error handling without needing multiple test card numbers.


Test amounts

Submit the following amounts in your test transactions to receive the corresponding response:

AmountStatusReasonDescription
101declinedgeneric_declineIssuer returned a generic decline.
204declinedexpired_cardThe card has expired.
216declinedinvalid_avsThe Address Verification System (AVS) check failed.
217declinedinvalid_pinThe PIN entered is invalid.
218declinedclosed_accountIssuer could not locate the bank account associated with the card number.
251declinedsuspected_fraudIssuer classified the transaction as fraudulent.
301declinedinsufficient_fundsThe cardholder has insufficient funds to complete the transaction.
321declinedcardholder_cancellationThe cardholder has requested the transaction be cancelled.
323declinedrestricted_cardThe card has restrictions that prevent this transaction.
324declinedinvalid_cvvThe CVV provided is invalid.
325declinedexpired_cardThe card has expired.
401declinedsuspected_fraudIssuer classified the transaction as fraudulent.
402declinedlost_or_stolenThe card has been reported as lost or stolen.
10.99declinedgeneric_declineIssuer returned a generic decline.
565declinedsoft_declineA soft decline was received; the transaction may be retried.

Refunds

Test refund functionality by submitting a refund request against a successful transaction. Use any amount for refund testing—the refund will be processed regardless of the original transaction amount.

When testing refunds:

  • The original transaction must have a success status
  • Submit the refund amount you wish to refund (full or partial)
  • The refund will be processed and return a successful response

Voids

Test void functionality by submitting a void request against a pending or recently authorized transaction. Voids must be submitted before the transaction has been settled.

When testing voids:

  • The original transaction must be in a pending or authorized state
  • Submit a void request using the transaction ID
  • The void will be processed and return a successful response
  • Voided transactions will have a status of voided

Did this page help you?