Checking access…

Skip to main content
Version: v1

Invalidated Payment Method

When a bank's ACH network returns a transaction with a return code indicating the account can no longer be used (closed, invalid, frozen, etc.), CCG marks that bank account payment method as INVALIDATED. An invalidated payment method can no longer be used for payments or updated β€” the only action available on it is deletion.

Quick Reference

What Happens When a Payment Method Is Invalidated?​

  • Payments cannot be processed using that payment method.
  • Updating the payment method is prohibited.
  • The only permitted action is deleting the payment method.

List of Return Codes That Result in Invalidation​

Return CodeDescription
R02Account Closed
R03No Account/Unable to locate account
R04Invalid account
R07Authorization revoked
R10Customer advises not authorized
R11Check truncation entry return
R12Branch sold to another DFI
R13Invalid ACH Routing number
R14Representative Payee deceased
R15Beneficiary or account holder deceased
R16Account frozen
R20Non-Transaction Account
R29Corporate Customer Advises Not Authorized
R30RDFI Not participant in Check Truncation Program
R31Permissible Return entry, a non-consumer related return code
R34Limited participation DFI
R35Return of improper Debit Entry
R36Return of improper Credit Entry
R37Source document presented for Payment
R38Stop payment on source document
R39Improper source document
R40Return of ENR entry by a Federal Government agency
R41Invalid transaction code ENR
R42Routing No/ Check Digit Error ENR
R43Invalid DFI Account No. ENR
R44Invalid Individual ID No. ENR
R45Invalid Individual / Company Name ENR
R46Invalid representative Payee indicator ENR
R47Duplicate enrollment of ENR Entry by a Federal Government agency
R50State law affecting RCK acceptance
R51Item related to RCK entry is ineligible or RCK entry is improper
R52Stop payment on RCK Item (adjustment entries)
R53Item and RCK entry presented for payment
R81Non-Participant in Cross-Border program 2 Banking days
R82Invalid Foreign receiving DFI identification
R84Entry not processed by gateway

Checking Payment Method Status​

Use Find Payment Method to check paymentMethodDetails.status before attempting a payment or update against a saved bank account. Invalidation happens asynchronously (driven by an ACH return) and is reflected the next time the payment method is read β€” there is no polling or dedicated status endpoint for this.

Notifications​

A status change to INVALIDATED is expected to surface via PAYMENT_METHOD_UPDATED β€” see Payment Methods Webhooks for the full event and ACH structure schema.

Error Handling​

Payment and update requests against an INVALIDATED payment method fail validation. Refer Update Payment Method Error Codes for the general error shape β€” there is no error code specific to this use case beyond the standard validation failure for the attempted operation.

Frequently Asked Questions​

Can an invalidated payment method be reactivated?​

No. The only permitted action is deletion β€” add a new payment method instead.

How do I know which return code caused the invalidation?​

The return code itself is not currently exposed on the payment method resource. Contact CCG support if you need the originating return code for reconciliation.

What should my integration do when it encounters an invalidated payment method?​

Stop attempting payments against it, prompt the customer to add a new payment method, and allow deletion of the invalidated one.