diff --git a/api-specs/checkout/types/responses/MultipleVendorButtonContainers.raml b/api-specs/checkout/types/responses/MultipleVendorButtonContainers.raml
new file mode 100644
index 000000000..c422386af
--- /dev/null
+++ b/api-specs/checkout/types/responses/MultipleVendorButtonContainers.raml
@@ -0,0 +1,17 @@
+#%RAML 1.0 DataType
+(annotations.package): responses
+type: Message
+displayName: MultipleVendorButtonContainers
+discriminatorValue: multiple_vendor_button_containers
+description: |
+  Generated when multiple containers for [vendor payment buttons](/sdk#display-custom-and-vendor-payment-buttons) are found.
+properties:
+  code:
+    type: string
+    description:
+  severity:
+    type: string
+    description: \`warn`
+  message:
+    type: string
+    description: Multiple vendor button containers detected, this may cause issues.
diff --git a/api-specs/checkout/types/types.raml b/api-specs/checkout/types/types.raml
index eca15b366..ba81708f4 100644
--- a/api-specs/checkout/types/types.raml
+++ b/api-specs/checkout/types/types.raml
@@ -14,6 +14,7 @@ InitTimeout: !include responses/InitTimeout.raml
 InvalidMode: !include responses/InvalidMode.raml
 BadInputData: !include responses/BadInputData.raml
 InvalidToken: !include responses/InvalidToken.raml
+MultipleVendorButtonContainers: !include responses/MultipleVendorButtonContainers.raml
 NoPaymentMethods: !include responses/NoPaymentMethods.raml
 PaymentFailed: !include responses/PaymentFailed.raml
 PaymentStarted: !include responses/PaymentStarted.raml