Use the API to take MOTO payments
If you have an integration with the GOV.UK Pay API, you can create MOTO payments through our API. Your paying user gives you their payment details by calling your service or sending their details through the post. An agent enters the paying user’s payment details and completes the payment.
Make sure you’ve enabled MOTO (telephone or post) payments on your account first.
Create a MOTO payment using the GOV.UK Pay API
Use the API to create a payment (
POST /v1/payments) and include
"moto": truein the request body.
Go to the
next_urlincluded in the body of the response to your API call.
Fill in your user’s payment details on the Enter card details page. The Enter Card Details page will not have a billing address field, even if you’ve enabled billing address collection on your service.
Confirm the payment on the Confirm your payment page. You will not need to do 3D Secure confirmation.
Taking a payment by post
If you’re taking a payment by post, make sure you’ve collected your user’s:
- card number
- card expiry date
- card security code
- name from their card
- email address - if you’ve enabled collecting your users’ email addresses
Hide users’ card information
When taking payments over the phone, you can hide the card information of paying users. When a call centre agent enters a user’s card information, the details are hidden like a password. This protects the paying user’s card information from anyone that can see the call centre agent’s screen. You can hide:
- the card number
- the card verification value (CVV) or card verification code (CVC)
To hide or unhide this information, you must have the Administrator role for your MOTO service. To see if you are an admin for a service, select Manage team members from the Overview screen.
This change takes immediate effect, so you should tell your service team staff before changing these settings.
- Sign in to the GOV.UK Pay admin tool.
- Select the account you want to change.
- Go to Settings and then Security.
- Go to either Hide card numbers or Hide card security codes and select Change.
- Select either Hidden or Visible and then Save changes.