Updated API from documentation release

Author: ct-sdks[bot]

api-specs/checkout/api.raml

@@ -136,6 +136,7 @@ traits:
         responses:
           200:
             body:
+              type: PaymentIntentResponse
               example: !include ../checkout/examples/payments/capturePaymentResponse.json
           400:
             description: The request was invalid.

api-specs/checkout/examples/payments/capturePaymentResponse.json

@@ -1 +1,3 @@
-{}
+{
+  "outcome": "approved"
+}

api-specs/checkout/types/payment-intents/PaymentIntentOutcome.raml

@@ -0,0 +1,18 @@
+#%RAML 1.0 DataType
+(annotations.package): PaymentIntents
+type: string
+displayName: PaymentIntentOutcome
+description: |
+  The outcome returned by the payment Connector after processing a Payment Intent.
+(annotations.ignoreValidators): [EnumValuePascalCaseRule]
+enum:
+  - approved
+  - rejected
+  - received
+(annotations.enumDescriptions):
+  approved: |
+    The Payment Intent was processed and approved by the payment service provider (PSP).
+  rejected: |
+    The Payment Intent was rejected by the payment service provider (PSP).
+  received: |
+    The Payment Intent was received and is being processed asynchronously by the payment service provider (PSP).

api-specs/checkout/types/payment-intents/PaymentIntentResponse.raml

@@ -0,0 +1,13 @@
+#%RAML 1.0 DataType
+(annotations.package): PaymentIntents
+type: object
+displayName: PaymentIntentResponse
+description: |
+  Returned by Checkout after forwarding a Payment Intent request to the payment Connector.
+  If the Connector response does not contain a valid `outcome` value, Checkout returns a `500 Internal Server Error`.
+example: !include ../../examples/payments/capturePaymentResponse.json
+properties:
+  outcome:
+    type: PaymentIntentOutcome
+    description: |
+      The outcome of the Payment Intent as reported by the payment [Connector](/connectors-and-applications#payment-connectors).

api-specs/checkout/types/types.raml

@@ -119,7 +119,9 @@ PaymentIntentAction: !include payment-intents/PaymentIntentAction.raml
 PaymentIntentCancelAction: !include payment-intents/PaymentIntentCancelAction.raml
 PaymentIntentCaptureAction: !include payment-intents/PaymentIntentCaptureAction.raml
 PaymentIntentOperation: !include payment-intents/PaymentIntentOperation.raml
+PaymentIntentOutcome: !include payment-intents/PaymentIntentOutcome.raml
 PaymentIntentRefundAction: !include payment-intents/PaymentIntentRefundAction.raml
+PaymentIntentResponse: !include payment-intents/PaymentIntentResponse.raml
 PaymentIntentReverseAction: !include payment-intents/PaymentIntentReverseAction.raml
 AddDiscountCodeError: !include responses/AddDiscountCodeError.raml
 ApplicationDeactivated: !include responses/ApplicationDeactivated.raml