Delay taking a payment
You can control how long it takes GOV.UK Pay to take (‘capture’) a payment from your user’s bank account after your payment service provider (PSP) has authorised that payment.
You may want to use delayed capture if you need time to do your own anti-fraud checks on payments, or check that users are eligible for your service.
During the delay, your user’s available bank balance is reduced by the payment amount.
You cannot use delayed capture if you only use payment links.
To use this feature, include "delayed_capture": true
in the body of a Create new payment request.
The user experience matches the current payment flow. Once your user selects Confirm on the Confirm your details page:
- the payment status will change to
capturable
- your service can call the
POST /v1/payments/{PAYMENT_ID}/capture
endpoint to send a delayed capture request
Your service must send the delayed capture request within 120 hours (5 days) of creating the payment, regardless of how long your user takes to complete the payment flow. If you do not, the payment will expire.
If you’ve enabled sending payment confirmation emails, GOV.UK Pay will send a payment confirmation email to your user once we’ve received and processed your service’s capture request.
You can see definitions and possible values of every parameter and attribute for this endpoint in our API reference. You can also view possible responses to your capture request.
See the capture URL for a payment
If a payment is available for capture, you can see its capture URL in responses to API calls. For example:
GET /v1/payments
GET /v1/payments/{PAYMENT_ID}
Replace {PAYMENT_ID}
with the ID of the payment you want to see the capture URL for.
The _
links` object will contain:
"capture": {
"href": "https://publicapi.payments.service.gov.uk/v1/payments/{PAYMENT_ID}/capture",
"method": "POST"
}
If the payment is not available for capture, the _links
object will not contain a capture
object.