---
title: "Validate Worldpay credentials"
method: POST
path: "/v1/api/accounts/{accountId}/worldpay/check-credentials"
tags: ["Gateway account credentials"]
---

# Validate Worldpay credentials

`POST /v1/api/accounts/{accountId}/worldpay/check-credentials`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `accountId` integer, required

## Request body

- WorldpayValidatableCredentials
  - `merchant_code` string
  - `merchant_id` string
  - `password` string, required
  - `username` string, required

## Response `200`

OK

- ValidationResult
  - `result` string: valid/invalid result for Worldpay flex credentials

## Other responses

- `404`: Not found - account not found or not a Worldpay gateway account
- `422`: Unprocessable Entity - Invalid or missing mandatory fields
- `500`: Internal server error

## Changes

- **2026-10-02** `042ba06d9017`: 1 info
  - removed the `AMOUNT_BELOW_MINIMUM` enum value from the `error_identifier` response property for the response status `422`
- **2026-10-01** `4e93196bd6aa`: 2 warning
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_ADYEN` enum value to the `error_identifier` response property for the response status `422`
  - added the new `AMOUNT_BELOW_MINIMUM_FOR_STRIPE` enum value to the `error_identifier` response property for the response status `422`
- **2025-04-14** `8ad9796ed750`: 2 breaking
  - the `password` request property's minLength was increased from `0` to `1`
  - the `username` request property's minLength was increased from `0` to `1`
- **2025-01-16** `c12941ae518b`: 1 warning
  - added the new `AMOUNT_BELOW_MINIMUM` enum value to the `error_identifier` response property for the response status `422`
- **2024-12-16** `c62c5562a57d`: 2 info
  - added the new optional request property `merchant_code`
  - the request property `merchant_id` became optional

[Operation history](https://skmtc.dev/government-digital-service/apis/connector-api/changes/v1/api/accounts/:accountId/worldpay/check-credentials/post.md)

---

[API](https://skmtc.dev/government-digital-service/apis/connector-api.md) - [All operations](https://skmtc.dev/government-digital-service/apis/connector-api/llms.txt) - [OpenAPI document](https://skmtc.dev/government-digital-service/apis/connector-api/revisions/7f294e492d3c?raw)