From c8d7dae1a281194b267cc51a685d4cff6414e174 Mon Sep 17 00:00:00 2001
From: Nathan Driver <80888259+NathanD-GDS@users.noreply.github.com>
Date: Wed, 5 Feb 2025 15:45:25 +0000
Subject: [PATCH] PP-10644 Small fixes to MOTO API documentation (#992)
---
source/api_reference/index.html.md.erb | 1 +
.../moto_send_card_details_api/index.html.md.erb | 13 ++++++++++++-
2 files changed, 13 insertions(+), 1 deletion(-)
diff --git a/source/api_reference/index.html.md.erb b/source/api_reference/index.html.md.erb
index ff822390..4e8e501f 100644
--- a/source/api_reference/index.html.md.erb
+++ b/source/api_reference/index.html.md.erb
@@ -193,6 +193,7 @@ These error descriptions are intended for developers, not your users.
| Error code | Endpoint(s) | Meaning |
|--------------|------------|---------|
+| P0010 | Send card details to authorise a MOTO payment | The paying user's bank rejected the payment authorisation.
This is because the user entered incorrect payment details or they did not have sufficient funds in their account. |
| P0101 | Create a payment
Send card details to authorise a MOTO payment | The request you sent is missing a required parameter.
Check the `field` attribute in the response to see which parameter is missing. |
| P0102 | Create a payment
Send card details to authorise a MOTO payment | A header or parameter value you sent in your request is invalid.
Check the `description` attribute in the response to find out which value is invalid. |
| P0104 | Create a payment | You included `return_url` and `"authorisation_mode": "moto_api"` in your request. These parameters cannot be used together.
Remove the `return_url` parameter to create [a Mail Order / Telephone Order (MOTO) payment that accepts card details sent through the API](/moto_payments/moto_send_card_details_api).
Remove the `authorisation_mode` parameter to [create a standard payment](/making_payments). |
diff --git a/source/moto_payments/moto_send_card_details_api/index.html.md.erb b/source/moto_payments/moto_send_card_details_api/index.html.md.erb
index 72556c73..de5a3e37 100644
--- a/source/moto_payments/moto_send_card_details_api/index.html.md.erb
+++ b/source/moto_payments/moto_send_card_details_api/index.html.md.erb
@@ -127,7 +127,18 @@ curl "https://publicapi.payments.service.gov.uk/v1/auth" \
If the authorisation request is successful, you’ll receive a `204` response. The response body will be empty.
-If the authorisation request is unsuccessful, you’ll receive a `4xx` HTTP status code and an error code in the `code` attribute. You can see [the meanings of GOV.UK Pay API error codes in our API reference](/api_reference/#http-status-codes).
+If the authorisation request is unsuccessful, you’ll receive a `402` HTTP status code. The response body will contain a `P0010` code and a `description` of the error.
+
+For example:
+
+```json
+{
+ "code": "P0010",
+ "description": "The payment was rejected"
+}
+```
+
+You can see [the meanings of GOV.UK Pay API error codes in our API reference](/api_reference/#gov-uk-pay-api-error-codes).
We time out requests to `/v1/auth` after about 10 seconds. If your request times out, you’ll receive a `500` HTTP status code and a `P0050` API error code.