Payment Failure Diagnosis
Overview
This skill produces structured diagnostic analyses of payment processing failures across all major payment rails. It covers ACH (NACHA), Fedwire, SWIFT, CHIPS, check clearing (Check 21), real-time payments (RTP/FedNow), and card networks. Diagnoses identify the failure point, root cause, applicable return/reject codes, regulatory implications, and corrective actions. Output supports operations teams, customer communication, and regulatory compliance.
When to Use
- Investigating why a specific payment was rejected, returned, or delayed
- Diagnosing patterns of payment failures in operations exception queues
- Explaining payment processing errors to customers or relationship managers
- Troubleshooting payment system connectivity or processing issues
- Analyzing payment return rates for compliance with NACHA thresholds
- Supporting Reg E error resolution for electronic payment disputes
- Preparing root cause analysis for material payment processing incidents
Required Inputs
| Input |
Description |
Format |
| Payment details |
Amount, date, parties, payment type, reference |
Payment record |
| Error/return code |
NACHA return reason code, Fedwire reject code, SWIFT error |
System output |
| Processing timeline |
Timestamps from initiation to failure point |
Audit trail |
| Account status |
Originator and receiver account status and balances |
Account data |
| System logs |
Application and middleware processing logs |
Technical logs |
| Routing information |
ABA routing numbers, SWIFT BICs, account numbers |
Payment instructions |
| Compliance screening |
OFAC, fraud screening results |
Screening output |
Methodology
Step 1: Identify the Payment Rail and Failure Type
Classify the payment and failure:
| Rail |
Settlement |
Common Failure Types |
| ACH (NACHA) |
T+1 (standard), T+0 (same-day) |
Returns (R01-R85), NOCs, rejects |
| Fedwire |
Real-time, final |
Rejects (format, routing, OFAC hold) |
| SWIFT |
Varies by correspondent |
NAK, MT199 inquiry, compliance hold |
| CHIPS |
End-of-day net settlement |
Release failures, queue management |
| Check 21/Image |
T+1 (local), T+2 (non-local) |
Return unpaid, duplicate presentment |
| RTP (TCH) |
Real-time, final |
Reject (timeout, account, limit) |
| FedNow |
Real-time, final |
Reject (routing, account, OFAC) |
| Card (Visa/MC) |
T+1 to T+3 |
Decline, chargeback, reversal |
Step 2: Decode the Error/Return Code
Interpret the specific failure code:
ACH Return Reason Codes (most common):
| Code |
Meaning |
Root Cause Category |
| R01 |
Insufficient funds |
Account balance |
| R02 |
Account closed |
Account status |
| R03 |
No account/unable to locate |
Routing/account error |
| R04 |
Invalid account number |
Data quality |
| R05 |
Unauthorized debit (consumer) |
Authorization dispute |
| R06 |
ODFI requested return |
Originator recall |
| R07 |
Authorization revoked |
Customer action |
| R08 |
Payment stopped |
Stop payment |
| R10 |
Customer advises not authorized |
Reg E dispute |
| R16 |
Account frozen |
Legal/compliance |
| R20 |
Non-transaction account |
Account type mismatch |
| R29 |
Corporate customer advises not authorized |
Corporate dispute |
Fedwire Reject Codes:
- Format errors (invalid field content)
- Routing errors (invalid receiving ABA)
- OFAC holds (sanctions screening match)
- Business reason rejects (beneficiary bank rejection)
SWIFT Error Categories:
- NAK (negative acknowledgment): Message format failure
- MT199: Free-format inquiry from correspondent
- Compliance hold: Sanctions/AML screening at intermediary bank
Step 3: Trace the Processing Path
Map the payment's journey and identify where it failed:
Originator → Originating Bank (ODFI) → [Fed/Clearing House] → Receiving Bank (RDFI) → Beneficiary
↓ ↓ ↓ ↓ ↓
Initiation Validation & Clearing & Receipt & Credit to
& capture OFAC screening settlement OFAC screening account
For each node, verify:
- Was the payment received? (timestamp and confirmation)
- Were validation checks passed? (format, routing, compliance)
- Was the payment forwarded? (outbound confirmation)
- What was the elapsed time at each node? (latency analysis)
Step 4: Diagnose the Root Cause
Apply diagnostic logic by failure category:
Account-related failures (R01, R02, R03, R04, R16, R20):
- Verify account number and routing number accuracy
- Check account status (open, closed, frozen, restricted)
- Confirm account type supports the transaction type
- Verify available balance at time of debit (for R01)
- Check for recent account changes (closure, ownership change)
Authorization-related failures (R05, R07, R08, R10, R29):
- Verify originator's authorization (agreement, mandate)
- Check for customer-initiated stop payments or revocations
- Assess whether Reg E rights are applicable (consumer accounts)
- Review originator's authorization retention and evidence
Technical failures (format errors, timeouts, system rejects):
- Review message format against specification (NACHA, ISO 20022, SWIFT MT)
- Check field length, data type, and character set compliance
- Verify routing number validity against Federal Reserve E-Payments directory
- Assess system availability and processing capacity at time of failure
- Check for middleware or integration failures between systems
Compliance-related failures (OFAC holds, fraud blocks):
- Review OFAC screening results and match details
- Determine if hold is a true match or false positive requiring release
- Check for fraud detection triggers requiring review
- Assess regulatory reporting requirements (blocking report, SAR)
Step 5: Assess Regulatory and Financial Impact
Evaluate the consequences of the failure:
NACHA compliance:
- Overall return rate threshold: 15% (administrative + unauthorized)
- Unauthorized return rate threshold: 0.5%
- Exceeding thresholds may result in NACHA enforcement (fine, restricted origination)
- Monitor return rates by originator and SEC code
Reg E implications (consumer electronic fund transfers):
- R10 returns trigger Reg E error resolution obligations
- RDFI must accept returns within 60 days of settlement
- Consumer liability limits apply based on timing of notification
Financial impact:
- Return item fees assessed or absorbed
- Interest cost of delayed settlement
- Customer relationship impact and complaint risk
- Operational cost of manual exception handling
Step 6: Prescribe Corrective Actions
Provide specific, actionable remediation:
For the immediate failure:
- Re-route or re-initiate the payment with corrected information
- Contact receiving institution for resolution (if routing/account issue)
- Release from compliance hold with documented disposition (if false positive)
- Communicate status and timeline to customer or originator
For recurring patterns:
- Implement pre-validation checks (account verification services, routing number validation)
- Enhance data quality controls at payment initiation
- Tune OFAC screening to reduce false positive rates
- Upgrade to current message format standards (ISO 20022)
- Implement real-time balance checks before debit origination
Step 7: Document for Audit Trail
Record the complete diagnostic for operational and regulatory retention:
- Payment reference details (trace number, IMAD/OMAD, Fedwire reference)
- Complete timeline from initiation to failure to resolution
- Root cause classification and evidence
- Customer communication record
- Corrective actions taken with completion confirmation
- Regulatory filing requirements met (if applicable)
Output Specification
# Payment Failure Diagnosis: [Reference/Trace Number]
## Payment Details
- **Payment Type**: [ACH/Wire/Check/RTP]
- **Amount**: [$Amount]
- **Origination Date**: [Date]
- **Originator**: [Name, account, routing]
- **Beneficiary**: [Name, account, routing]
- **Status**: [Rejected/Returned/Delayed/Held]
## Failure Information
- **Error Code**: [Code]
- **Error Description**: [Description]
- **Failure Point**: [Where in the processing chain]
- **Failure Timestamp**: [Date/time]
## Diagnosis
### Root Cause
[Specific root cause with evidence]
### Root Cause Category
[Account / Authorization / Technical / Compliance]
### Processing Path Analysis
[Node-by-node trace showing where failure occurred]
## Impact Assessment
- **Customer Impact**: [Description]
- **Financial Impact**: [$Amount, fees, interest]
- **Regulatory Risk**: [Reg E, NACHA compliance, sanctions]
## Resolution
- **Immediate Action**: [What was done to resolve this specific failure]
- **Prevention**: [What changes prevent recurrence]
- **Customer Communication**: [What was communicated and when]
## Audit Trail
[Timestamps, reference numbers, and documentation for retention]
Analysis Framework
Return Rate Monitoring
Track NACHA return rates for compliance:
| Metric |
Current Rate |
Threshold |
Status |
| Overall return rate (admin + unauthorized) |
[X.X%] |
15.0% |
[OK/Warning/Breach] |
| Unauthorized return rate |
[X.X%] |
0.5% |
[OK/Warning/Breach] |
| WEB debit return rate |
[X.X%] |
15.0% |
[OK/Warning/Breach] |
Set internal early warning at 50% of NACHA threshold.
Payment Exception Trend Analysis
Identify patterns in payment failures:
- Failure rate by payment rail, originator, SEC code, and time period
- Top 10 return reason codes with volume trends
- Correlation between volume spikes and failure rates
- System availability impact on failure rates
Same-Day ACH Performance
Monitor same-day ACH compliance:
- File submission by cutoff time (2:45 PM ET for current window)
- Processing window utilization
- Same-day vs. next-day return rates
Examples
Example 1 — ACH Return Diagnosis:
"ACH credit (payroll) trace #0214XXXXXXXX, $3,247.82, originated 2025-10-01 by ABC Corp (ODFI: First National Bank) to employee account #XXXX5591 at Second State Bank, returned R03 (No Account/Unable to Locate) on 2025-10-02. Diagnosis: The employee's account was closed on 2025-09-28 due to the employee's voluntary account closure after opening an account at a competitor. The pre-notification (prenote) on file was validated in June 2024 and did not reflect the recent closure. Corrective action: (1) Notify ABC Corp payroll department of the return with updated information request (Wire Ops, same day); (2) Recommend ABC Corp implement account validation service (Accuity/Early Warning) for all payroll ACH origination to pre-validate accounts before origination; (3) Update prenote refresh cycle from annual to semi-annual for all payroll originators."
Example 2 — Wire Transfer Compliance Hold:
"Fedwire #20251015XXXXXXX, $425,000 outbound wire from customer account #XXXX2237 to intermediary bank (Deutsche Bank AG) for ultimate beneficiary 'Meridian Trading FZE' (Dubai, UAE). Wire held by OFAC screening at 10:47 AM ET. Match: Beneficiary name scored 82% against SDN entry 'Meridian Trade FZE' (SDN ID 34782, Iran-related). Diagnosis: The screening match is a near-name match. Due diligence reveals: (1) Customer's beneficiary is a UAE-incorporated electronics distributor established in 2012 with verifiable trade licenses; (2) SDN entity was added in 2019 and is associated with Iranian petrochemical transactions; (3) No matching identifiers (address, registration number, beneficial owners). Disposition: False positive — names are similar but entities are distinct. Wire released at 2:15 PM ET after BSA Officer approval. Total hold time: 3 hours 28 minutes. Customer notified of delay."
Guidelines
- Always cite the specific return/reject code and its standard definition
- Trace the complete processing path before concluding root cause
- For OFAC holds, never release without documented false positive determination
- Monitor NACHA return rate thresholds and alert when approaching 50% of limit
- Reg E electronic fund transfers require strict adherence to error resolution timelines
- Preserve all diagnostic documentation for minimum 5 years (BSA recordkeeping)
- Communicate payment status to customers proactively; do not wait for inquiry
- Distinguish between sender-side and receiver-side failures in the diagnosis
- For recurring failures from the same originator, escalate to relationship management
- Document the complete audit trail including all timestamps and reference numbers
Validation Checklist
1---2name: payment-failure-diagnosis3description: Diagnose and explain payment processing failures across ACH, wire transfer, check, and real-time payment rails. Use when investigating rejected, returned, or delayed payments, analyzing payment exception patterns, or troubleshooting payment processing system issues in banking operations.45metadata:6 display_name: "Payment Failure Diagnosis"7 short_description: "Diagnose payment processing failures across all payment rails"8 default_prompt: "Analyze my payment failure diagnosis and recommend clear next actions"9 version: "1.0.1"10 tags:11 - financial-services12 icon_path: "assets/icon.png"13---1415# Payment Failure Diagnosis1617## Overview1819This skill produces structured diagnostic analyses of payment processing failures across all major payment rails. It covers ACH (NACHA), Fedwire, SWIFT, CHIPS, check clearing (Check 21), real-time payments (RTP/FedNow), and card networks. Diagnoses identify the failure point, root cause, applicable return/reject codes, regulatory implications, and corrective actions. Output supports operations teams, customer communication, and regulatory compliance.2021## When to Use2223- Investigating why a specific payment was rejected, returned, or delayed24- Diagnosing patterns of payment failures in operations exception queues25- Explaining payment processing errors to customers or relationship managers26- Troubleshooting payment system connectivity or processing issues27- Analyzing payment return rates for compliance with NACHA thresholds28- Supporting Reg E error resolution for electronic payment disputes29- Preparing root cause analysis for material payment processing incidents3031## Required Inputs3233| Input | Description | Format |34|-------|-------------|--------|35| Payment details | Amount, date, parties, payment type, reference | Payment record |36| Error/return code | NACHA return reason code, Fedwire reject code, SWIFT error | System output |37| Processing timeline | Timestamps from initiation to failure point | Audit trail |38| Account status | Originator and receiver account status and balances | Account data |39| System logs | Application and middleware processing logs | Technical logs |40| Routing information | ABA routing numbers, SWIFT BICs, account numbers | Payment instructions |41| Compliance screening | OFAC, fraud screening results | Screening output |4243## Methodology4445### Step 1: Identify the Payment Rail and Failure Type4647Classify the payment and failure:4849| Rail | Settlement | Common Failure Types |50|------|-----------|---------------------|51| **ACH (NACHA)** | T+1 (standard), T+0 (same-day) | Returns (R01-R85), NOCs, rejects |52| **Fedwire** | Real-time, final | Rejects (format, routing, OFAC hold) |53| **SWIFT** | Varies by correspondent | NAK, MT199 inquiry, compliance hold |54| **CHIPS** | End-of-day net settlement | Release failures, queue management |55| **Check 21/Image** | T+1 (local), T+2 (non-local) | Return unpaid, duplicate presentment |56| **RTP (TCH)** | Real-time, final | Reject (timeout, account, limit) |57| **FedNow** | Real-time, final | Reject (routing, account, OFAC) |58| **Card (Visa/MC)** | T+1 to T+3 | Decline, chargeback, reversal |5960### Step 2: Decode the Error/Return Code6162Interpret the specific failure code:6364**ACH Return Reason Codes (most common)**:6566| Code | Meaning | Root Cause Category |67|------|---------|-------------------|68| R01 | Insufficient funds | Account balance |69| R02 | Account closed | Account status |70| R03 | No account/unable to locate | Routing/account error |71| R04 | Invalid account number | Data quality |72| R05 | Unauthorized debit (consumer) | Authorization dispute |73| R06 | ODFI requested return | Originator recall |74| R07 | Authorization revoked | Customer action |75| R08 | Payment stopped | Stop payment |76| R10 | Customer advises not authorized | Reg E dispute |77| R16 | Account frozen | Legal/compliance |78| R20 | Non-transaction account | Account type mismatch |79| R29 | Corporate customer advises not authorized | Corporate dispute |8081**Fedwire Reject Codes**:82- Format errors (invalid field content)83- Routing errors (invalid receiving ABA)84- OFAC holds (sanctions screening match)85- Business reason rejects (beneficiary bank rejection)8687**SWIFT Error Categories**:88- NAK (negative acknowledgment): Message format failure89- MT199: Free-format inquiry from correspondent90- Compliance hold: Sanctions/AML screening at intermediary bank9192### Step 3: Trace the Processing Path9394Map the payment's journey and identify where it failed:9596```97Originator → Originating Bank (ODFI) → [Fed/Clearing House] → Receiving Bank (RDFI) → Beneficiary98 ↓ ↓ ↓ ↓ ↓99 Initiation Validation & Clearing & Receipt & Credit to100 & capture OFAC screening settlement OFAC screening account101```102103For each node, verify:104- Was the payment received? (timestamp and confirmation)105- Were validation checks passed? (format, routing, compliance)106- Was the payment forwarded? (outbound confirmation)107- What was the elapsed time at each node? (latency analysis)108109### Step 4: Diagnose the Root Cause110111Apply diagnostic logic by failure category:112113**Account-related failures (R01, R02, R03, R04, R16, R20)**:114- Verify account number and routing number accuracy115- Check account status (open, closed, frozen, restricted)116- Confirm account type supports the transaction type117- Verify available balance at time of debit (for R01)118- Check for recent account changes (closure, ownership change)119120**Authorization-related failures (R05, R07, R08, R10, R29)**:121- Verify originator's authorization (agreement, mandate)122- Check for customer-initiated stop payments or revocations123- Assess whether Reg E rights are applicable (consumer accounts)124- Review originator's authorization retention and evidence125126**Technical failures (format errors, timeouts, system rejects)**:127- Review message format against specification (NACHA, ISO 20022, SWIFT MT)128- Check field length, data type, and character set compliance129- Verify routing number validity against Federal Reserve E-Payments directory130- Assess system availability and processing capacity at time of failure131- Check for middleware or integration failures between systems132133**Compliance-related failures (OFAC holds, fraud blocks)**:134- Review OFAC screening results and match details135- Determine if hold is a true match or false positive requiring release136- Check for fraud detection triggers requiring review137- Assess regulatory reporting requirements (blocking report, SAR)138139### Step 5: Assess Regulatory and Financial Impact140141Evaluate the consequences of the failure:142143**NACHA compliance**:144- Overall return rate threshold: 15% (administrative + unauthorized)145- Unauthorized return rate threshold: 0.5%146- Exceeding thresholds may result in NACHA enforcement (fine, restricted origination)147- Monitor return rates by originator and SEC code148149**Reg E implications** (consumer electronic fund transfers):150- R10 returns trigger Reg E error resolution obligations151- RDFI must accept returns within 60 days of settlement152- Consumer liability limits apply based on timing of notification153154**Financial impact**:155- Return item fees assessed or absorbed156- Interest cost of delayed settlement157- Customer relationship impact and complaint risk158- Operational cost of manual exception handling159160### Step 6: Prescribe Corrective Actions161162Provide specific, actionable remediation:163164**For the immediate failure**:165- Re-route or re-initiate the payment with corrected information166- Contact receiving institution for resolution (if routing/account issue)167- Release from compliance hold with documented disposition (if false positive)168- Communicate status and timeline to customer or originator169170**For recurring patterns**:171- Implement pre-validation checks (account verification services, routing number validation)172- Enhance data quality controls at payment initiation173- Tune OFAC screening to reduce false positive rates174- Upgrade to current message format standards (ISO 20022)175- Implement real-time balance checks before debit origination176177### Step 7: Document for Audit Trail178179Record the complete diagnostic for operational and regulatory retention:180- Payment reference details (trace number, IMAD/OMAD, Fedwire reference)181- Complete timeline from initiation to failure to resolution182- Root cause classification and evidence183- Customer communication record184- Corrective actions taken with completion confirmation185- Regulatory filing requirements met (if applicable)186187## Output Specification188189```markdown190# Payment Failure Diagnosis: [Reference/Trace Number]191192## Payment Details193- **Payment Type**: [ACH/Wire/Check/RTP]194- **Amount**: [$Amount]195- **Origination Date**: [Date]196- **Originator**: [Name, account, routing]197- **Beneficiary**: [Name, account, routing]198- **Status**: [Rejected/Returned/Delayed/Held]199200## Failure Information201- **Error Code**: [Code]202- **Error Description**: [Description]203- **Failure Point**: [Where in the processing chain]204- **Failure Timestamp**: [Date/time]205206## Diagnosis207### Root Cause208[Specific root cause with evidence]209210### Root Cause Category211[Account / Authorization / Technical / Compliance]212213### Processing Path Analysis214[Node-by-node trace showing where failure occurred]215216## Impact Assessment217- **Customer Impact**: [Description]218- **Financial Impact**: [$Amount, fees, interest]219- **Regulatory Risk**: [Reg E, NACHA compliance, sanctions]220221## Resolution222- **Immediate Action**: [What was done to resolve this specific failure]223- **Prevention**: [What changes prevent recurrence]224- **Customer Communication**: [What was communicated and when]225226## Audit Trail227[Timestamps, reference numbers, and documentation for retention]228```229230## Analysis Framework231232### Return Rate Monitoring233234Track NACHA return rates for compliance:235236| Metric | Current Rate | Threshold | Status |237|--------|-------------|-----------|--------|238| Overall return rate (admin + unauthorized) | [X.X%] | 15.0% | [OK/Warning/Breach] |239| Unauthorized return rate | [X.X%] | 0.5% | [OK/Warning/Breach] |240| WEB debit return rate | [X.X%] | 15.0% | [OK/Warning/Breach] |241242Set internal early warning at 50% of NACHA threshold.243244### Payment Exception Trend Analysis245246Identify patterns in payment failures:247- Failure rate by payment rail, originator, SEC code, and time period248- Top 10 return reason codes with volume trends249- Correlation between volume spikes and failure rates250- System availability impact on failure rates251252### Same-Day ACH Performance253254Monitor same-day ACH compliance:255- File submission by cutoff time (2:45 PM ET for current window)256- Processing window utilization257- Same-day vs. next-day return rates258259## Examples260261**Example 1 — ACH Return Diagnosis**:262"ACH credit (payroll) trace #0214XXXXXXXX, $3,247.82, originated 2025-10-01 by ABC Corp (ODFI: First National Bank) to employee account #XXXX5591 at Second State Bank, returned R03 (No Account/Unable to Locate) on 2025-10-02. Diagnosis: The employee's account was closed on 2025-09-28 due to the employee's voluntary account closure after opening an account at a competitor. The pre-notification (prenote) on file was validated in June 2024 and did not reflect the recent closure. Corrective action: (1) Notify ABC Corp payroll department of the return with updated information request (Wire Ops, same day); (2) Recommend ABC Corp implement account validation service (Accuity/Early Warning) for all payroll ACH origination to pre-validate accounts before origination; (3) Update prenote refresh cycle from annual to semi-annual for all payroll originators."263264**Example 2 — Wire Transfer Compliance Hold**:265"Fedwire #20251015XXXXXXX, $425,000 outbound wire from customer account #XXXX2237 to intermediary bank (Deutsche Bank AG) for ultimate beneficiary 'Meridian Trading FZE' (Dubai, UAE). Wire held by OFAC screening at 10:47 AM ET. Match: Beneficiary name scored 82% against SDN entry 'Meridian Trade FZE' (SDN ID 34782, Iran-related). Diagnosis: The screening match is a near-name match. Due diligence reveals: (1) Customer's beneficiary is a UAE-incorporated electronics distributor established in 2012 with verifiable trade licenses; (2) SDN entity was added in 2019 and is associated with Iranian petrochemical transactions; (3) No matching identifiers (address, registration number, beneficial owners). Disposition: False positive — names are similar but entities are distinct. Wire released at 2:15 PM ET after BSA Officer approval. Total hold time: 3 hours 28 minutes. Customer notified of delay."266267## Guidelines268269- Always cite the specific return/reject code and its standard definition270- Trace the complete processing path before concluding root cause271- For OFAC holds, never release without documented false positive determination272- Monitor NACHA return rate thresholds and alert when approaching 50% of limit273- Reg E electronic fund transfers require strict adherence to error resolution timelines274- Preserve all diagnostic documentation for minimum 5 years (BSA recordkeeping)275- Communicate payment status to customers proactively; do not wait for inquiry276- Distinguish between sender-side and receiver-side failures in the diagnosis277- For recurring failures from the same originator, escalate to relationship management278- Document the complete audit trail including all timestamps and reference numbers279280## Validation Checklist281282- [ ] Payment rail and type are correctly identified283- [ ] Error/return code is decoded with standard definition284- [ ] Processing path is traced to the specific failure point285- [ ] Root cause is categorized (account, authorization, technical, compliance)286- [ ] Regulatory implications are assessed (Reg E, NACHA thresholds, OFAC)287- [ ] Financial impact is quantified (fees, interest, customer impact)288- [ ] Corrective action addresses both the immediate failure and recurrence prevention289- [ ] Customer communication is documented with timestamps290- [ ] Audit trail includes all reference numbers and processing timestamps291- [ ] Pattern analysis checks for systemic vs. isolated failure