> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useagentbank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# correct_payment_recipient

> Correct recipient fields for a payment paused on an invalid recipient.

**Authentication:** `settlement:prepare`\
**Mutates state:** Yes\
**Idempotency:** Stable `request_id`\
**Confirmation:** `confirmed_by_user=true`

```json theme={null}
{
  "request_id": "stable retry ID",
  "payment_id": "pay_...",
  "recipient_fields": {},
  "confirmed_by_user": true
}
```

Valid only when the payment has a settlement in
`recipient_correction_required` with an `invalid_recipient` step. Core
resubmits the canonical fields and returns the updated aggregate.

It is rejected when the payment is merely in `need_review`.