---
title: "Update a gateway account credential"
method: PATCH
path: "/v1/api/accounts/{accountId}/credentials/{credentialsId}"
tags: ["Gateway account credentials"]
---

# Update a gateway account credential

`PATCH /v1/api/accounts/{accountId}/credentials/{credentialsId}`

## Path parameters

- `accountId` integer, required
- `credentialsId` integer, required

## Request body

- string

## Response `200`

OK

- GatewayAccountCredentialsWithInternalId
  - `active_end_date` string, date-time
  - `active_start_date` string, date-time
  - `created_date` string, date-time
  - `credentials` union
    - object
      - `gateway_merchant_id` string
      - `one_off_customer_initiated` WorldpayMerchantCodeCredentials
        - `merchant_code` string
        - `username` string
      - `recurring_customer_initiated` WorldpayMerchantCodeCredentials
        - `merchant_code` string
        - `username` string
      - `recurring_merchant_initiated` WorldpayMerchantCodeCredentials
        - `merchant_code` string
        - `username` string
    - object
      - `stripe_account_id` string
    - object
      - `merchant_id` string
      - `username` string
  - `external_id` string
  - `gateway_account_credential_id` integer
  - `gateway_account_id` integer
  - `last_updated_by_user_external_id` string — User external ID
  - `payment_provider` string
  - `state` 'CREATED' | 'ENTERED' | 'VERIFIED_WITH_LIVE_PAYMENT' | 'ACTIVE' | 'RETIRED'

## Other responses

- `400` — Bad request - Invalid or missing mandatory fields
- `404` — Not found - account or credential not found

---

[API](https://skmtc.net/government-digital-service/apis/connector-api.md) · [All operations](https://skmtc.net/government-digital-service/apis/connector-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/government-digital-service/connector-api/revisions/68dc8eefc661/schema)