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

# Update Payment Method

> Update a saved beneficiary payment method

Update an existing beneficiary payment method. All required fields must be provided — this is a full replacement of the payment method record.

```
PUT /v1/beneficiaries/payment-methods/update/{id}
```

<Note>
  Requires an `Idempotency-Key` header.
</Note>

## Path parameters

<ParamField path="id" type="string" required>
  The ID of the beneficiary payment method to update.
</ParamField>

## Request body

<ParamField body="gateway_id" type="integer" required>
  The ID of the payout method (gateway).
</ParamField>

<ParamField body="currency" type="string" required>
  Currency code for this payment method (e.g. `CLP`, `MXN`, `BRL`).
</ParamField>

<ParamField body="payment_data" type="object" required>
  Updated key/value pairs of account details. Must include all fields required by the selected gateway.
</ParamField>

<ParamField body="nickname" type="string" required>
  A label to identify this payment method.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT 'https://api.yativo.com/api/v1/beneficiaries/payment-methods/update/pm-a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -H 'Idempotency-Key: pm-update-001' \
    -d '{
      "gateway_id": 42,
      "currency": "CLP",
      "nickname": "Maria Savings Account",
      "payment_data": {
        "account_number": "98765432",
        "bank_code": "014",
        "account_type": "savings",
        "rut": "12.345.678-9"
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "status": "success",
    "data": {
      "id": "pm-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "user_id": "usr-001",
      "gateway_id": 42,
      "currency": "CLP",
      "nickname": "Maria Savings Account",
      "payment_data": {
        "account_number": "98765432",
        "bank_code": "014",
        "account_type": "savings",
        "rut": "12.345.678-9"
      },
      "beneficiary_id": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
      "created_at": "2026-04-02T10:30:00.000000Z",
      "updated_at": "2026-04-02T15:00:00.000000Z"
    }
  }
  ```
</ResponseExample>