Sign in

v39

latestOpenAPI 3.0.1raw.githubusercontent.com2025-10-031646108.8 KB
Authorise card payments

Send card details to authorise a MOTO payment

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

post/v1/auth

Request body

card_numberstring required

The full card number from the paying user's card.

cardholder_namestring required

The name on the paying user's card.

cvcstring required

The card verification code (CVC) or card verification value (CVV) on the paying user's card.

expiry_datestring required

The expiry date of the paying user's card. This value must be in MM/YY format.

one_time_tokenstring 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.

Example request

{
  "card_number": "4242424242424242",
  "cardholder_name": "J. Citizen",
  "cvc": "123",
  "expiry_date": "09/22",
  "one_time_token": "12345-edsfr-6789-gtyu"
}

Response

Your authorisation request was successful.