---
title: "Send card details to authorise a MOTO payment"
method: POST
path: "/v1/auth"
tags: ["Authorise card payments"]
---

# Send card details to authorise a MOTO payment

`POST /v1/auth`

## Request

- Base URL: `https://publicapi.payments.service.gov.uk`
- URL: `https://publicapi.payments.service.gov.uk/v1/auth`
- Auth: none declared

You can use this endpoint to [authorise payments](https://docs.payments.service.gov.uk/moto_payments/moto_send_card_details_api/) you have created with `authorisation_mode` set to `moto_api`.

## Request body

- AuthorisationRequest: Contains the user's payment information. This information will be sent to the payment service provider to authorise the payment.
  - `card_number` string, required: The full card number from the paying user's card.
  - `cardholder_name` string, required: The name on the paying user's card.
  - `cvc` string, required: The card verification code (CVC) or card verification value (CVV) on the paying user's card.
  - `expiry_date` string, required: The expiry date of the paying user's card. This value must be in `MM/YY` format.
  - `one_time_token` string, required: This single use token authorises your request and matches it to a payment. GOV.UK Pay generated the `one_time_token` when the payment was created.

## Response `204`

Your authorisation request was successful.

## Other responses

- `400`: Your request is invalid. Check the `code` and `description` in the response to find out why your request failed.
- `402`: The `card_number` you sent is not a valid card number or you chose not to accept this card type. Check the `code` and `description` fields in the response to find out why your request failed.
- `422`: A value you sent is invalid or missing. Check the `code` and `description` in the response to find out why your request failed.
- `500`: There is something wrong with GOV.UK Pay. If there are no issues on our status page (https://payments.statuspage.io), you can contact us with your error code and we'll investigate.

## Changes

- **2025-10-03** `4dc2d80f453a`: 1 breaking
  - the `one_time_token` request property's minLength was increased from `0` to `1`
- **2023-04-18** `c8f226fc66d4`: 3 info
  - added the optional property `header` to the response with the `400` status
  - added the optional property `header` to the response with the `402` status
  - added the optional property `header` to the response with the `500` status
- **2022-05-31** `85a2dd6e13df`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/government-digital-service/apis/gov-uk-pay-api/changes/v1/auth/post.md)

---

[API](https://skmtc.dev/government-digital-service/apis/gov-uk-pay-api.md) - [All operations](https://skmtc.dev/government-digital-service/apis/gov-uk-pay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/government-digital-service/apis/gov-uk-pay-api/revisions/6dc4b2c91eb8?raw)