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.
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.
| 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 |
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 |
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:
SWIFT Error Categories:
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:
Apply diagnostic logic by failure category:
Account-related failures (R01, R02, R03, R04, R16, R20):
Authorization-related failures (R05, R07, R08, R10, R29):
Technical failures (format errors, timeouts, system rejects):
Compliance-related failures (OFAC holds, fraud blocks):
Evaluate the consequences of the failure:
NACHA compliance:
Reg E implications (consumer electronic fund transfers):
Financial impact:
Provide specific, actionable remediation:
For the immediate failure:
For recurring patterns:
Record the complete diagnostic for operational and regulatory retention:
# 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]
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.
Identify patterns in payment failures:
Monitor same-day ACH compliance:
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."