---
title: "Authorise charge"
method: POST
path: "/v1/frontend/charges/{chargeId}/cards"
tags: ["Charge operations"]
---

# Authorise charge

`POST /v1/frontend/charges/{chargeId}/cards`

## Path parameters

- `chargeId` string, required

## Request body

- AuthCardDetails
  - `accept_header` string
  - `accept_language_header` string
  - `address` Address
    - `city` string
    - `country` string
    - `county` string
    - `line1` string
    - `line2` string
    - `postcode` string
  - `browserAcceptHeader` string
  - `browserColorDepth` string
  - `browserIpAddress` string
  - `browserJavaScriptEnabled` boolean
  - `browserLanguage` string
  - `browserScreenHeight` string
  - `browserScreenWidth` string
  - `browserTZ` string
  - `browserUserAgent` string
  - `card_brand` string
  - `card_number` string — Card number. See https://docs.payments.service.gov.uk/testing_govuk_pay/#mock-card-numbers-and-email-addresses for test card numbers
  - `card_type` 'DEBIT' | 'CREDIT' | 'CREDIT_OR_DEBIT'
  - `cardholder_name` string — Cardholder name
  - `corporate_card` boolean
  - `cvc` string
  - `expiry_date` CardExpiryDate — The expiry date of the card the user paid with.
    - `fourDigitYear` string
    - `twoDigitMonth` string
    - `twoDigitYear` string
  - `ip_address` string
  - `js_enabled` boolean
  - `js_navigator_language` string
  - `js_screen_color_depth` string
  - `js_screen_height` string
  - `js_screen_width` string
  - `js_timezone_offset_mins` string
  - `prepaid` 'PREPAID' | 'NOT_PREPAID' | 'UNKNOWN'
  - `user_agent_header` string
  - `worldpay_3ds_flex_ddc_result` string

## Response `200`

OK

## Other responses

- `202` — Accepted - payment has been submitted for authorisation and awaiting response from payment service provider
- `400` — Bad request - invalid payload or the payment has been declined
- `402` — Gateway error
- `404` — Not found - charge not found
- `422` — Unprocessable Entity - Invalid payload or missing mandatory attributes
- `500` — Internal server error - For gateway errors or anything else not handled

---

[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)