Sign in

v50

latestOpenAPI 3.0.1raw.githubusercontent.com2026-07-169377194.1 KB
Charge operations

Authorise charge

post/v1/frontend/charges/{chargeId}/cards

Path parameters

chargeIdstring required

Charge external ID

Request body

accept_headerstring
accept_language_headerstring
card_brandstring
card_numberstring

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_namestring

Cardholder name

corporate_cardboolean
cvcstring
ip_addressstring
js_enabledboolean
js_navigator_languagestring
js_screen_color_depthstring
js_screen_heightstring
js_screen_widthstring
js_timezone_offset_minsstring
prepaid'PREPAID' | 'NOT_PREPAID' | 'UNKNOWN'
user_agent_headerstring
worldpay_3ds_flex_ddc_resultstring

Example request

{
  "accept_header": "text/html",
  "accept_language_header": "fr;q=0.9, fr-CH;q=1.0, en;q=0.8, de;q=0.7, *;q=0.5",
  "address": {
    "city": "London",
    "country": "GB",
    "county": "county",
    "line1": "Address line 1",
    "line2": "Address line 2",
    "postcode": "AB1 2CD"
  },
  "card_brand": "visa",
  "card_number": "4242424242424242",
  "card_type": "DEBIT",
  "cardholder_name": "Joe B",
  "cvc": "123",
  "ip_address": "127.0.0.1",
  "js_enabled": true,
  "js_navigator_language": "en-GB",
  "js_screen_color_depth": "24",
  "js_screen_height": "900",
  "js_screen_width": "1440",
  "js_timezone_offset_mins": "-60",
  "prepaid": "NOT_PREPAID",
  "user_agent_header": "Mozilla/5.0",
  "worldpay_3ds_flex_ddc_result": "1f1154b7-620d-4654-801b-893b5bb22db1"
}

Response

OK