Send card details to authorise a MOTO payment API reference

This page is part of GOV.UK Pay’s API reference and is an index of the following you’ll use when sending card details through the API:

parameters
example requests
example responses
attributes you’ll get in your response

The URL for this endpoint is:

POST https://publicapi.payments.service.gov.uk/v1/auth

You can use this endpoint to authorise payments you have created with the authorisation_mode set to moto_api.

This endpoint does not need an API bearer token. The request is instead secured with the one_time_token you received when you created this payment.

The data from this endpoint is ‘strongly consistent’, meaning it is updated immediately after you make any changes. You can read more about data consistency in our API.

JSON body parameters for ‘Send card details to authorise a MOTO payment’

Name	Type	Description
`one_time_token`	string	A single use token that identifies the payment to authorise and authenticates this request. GOV.UK Pay returns a `one_time_token` when you create a payment with `authorisation_mode` set to `moto_api`. You can read more about creating and authorising MOTO payments by sending card details through the API.
`card_number`	string	The full card number from the paying user’s card.
`cvc`	string	The card verification code (CVC) or card verification value (CVV) on the paying user’s card.
`expiry_date`	string	The expiry date of the card the user paid with. This value must be in `MM/YY` format.
`cardholder_name`	string	The name on the paying user’s card.

Example request for ‘Send card details to authorise a MOTO payment’

This example request sends card details to authorise the MOTO payment that returned the one_time_token of 9a084cca-2f23-4938-92ca-d7ebd1db537e when that payment was created:

curl "https://publicapi.payments.service.gov.uk/v1/auth" \
-H 'Content-Type: application/json' \
-d '{
  "one_time_token": "9a084cca-2f23-4938-92ca-d7ebd1db537e",
  "card_number": "4444333322221111",
  "cvc": "123",
  "expiry_date": "02/24",
  "cardholder_name": "Sherlock Holmes"
}'

Example response for ‘Send card details to authorise a MOTO payment’

A successful MOTO payment authorisation returns a 204 HTTP status code without a response body.