# SandboxAchStatusAdvanceRequestDto

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

Which settlement outcome to drive a sandbox ACH sale to, and the return detail when the outcome
is a return.

## Fields
- `targetStatus` ([SandboxAchTargetStatus](https://devportal.demo.winkpg.io/docs/api/models/SandboxAchTargetStatus.md)) required: The settlement status to drive the transaction to: a terminal outcome, or one of the  intermediate statuses a debit passes through on the way to one. Required. (nullable)
  Values:
  - `SettlementSucceeded`: The debit cleared and the money moved. The ordinary success case.
  - `SettlementRolledBack`: The receiving bank returned the debit. Requires a NACHA return code and reason. Arriving after SettlementSucceeded makes it a late return, which the resulting Transaction.Returned event flags.
  - `NotEligible`: The entry was voided on the processor's side before it reached the ACH network.
  - `SettlementFailed`: The processor reported an error on the entry rather than accepting it.
  - `Accepted`: The processor accepted the entry and queued it for the next origination window. The first intermediate status.
  - `Verifying`: The processor is verifying the account before origination. Follows Accepted.
  - `Originated`: The entry was originated onto the ACH network and is in flight. Follows Verifying.
  - `PartiallySettled`: Part of the amount has settled. The last intermediate status; follows Originated.
- `nachaReturnCode` (string): The NACHA return code to record, for example `R01`. Required when  `targetStatus` is `SettlementRolledBack`, and  rejected otherwise: a code on a settlement would be persisted and then published as part of an  event that says the debit cleared. (nullable)
- `nachaReturnReason` (string): The return reason to record, for example `Insufficient funds`. Required alongside  `nachaReturnCode`, and rejected on any other outcome for the same reason. (nullable, max length 120)

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.
