{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-documentation/get_started/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Disable Specific Payment Methods","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"disable-specific-payment-methods","__idx":0},"children":["Disable Specific Payment Methods"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you want to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["block or prevent particular payment methods"]}," from being used to complete a payment, you can explicitly disable them when creating payment sessions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-use","__idx":2},"children":["How to use"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When creating a payment session via the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/api/reference/openapi#operation/paymentSessionCreate"},"children":["paymentSessionCreate"]}," endpoint, you can specify the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settings.paymentMethodOptions"]}," field as shown below."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"Disable Payment Methods - Payload Example","header":{"title":"Disable Payment Methods - Payload Example","controls":{"copy":{}}},"source":"{\n  \"amount\": 54550,\n  \"currency\": \"GBP\",\n  \"customerEmail\": \"test@mail.com\",\n  \"settings\": {\n    \"paymentMethodOptions\": {\n      \"disabled\": [\"Amex\"]\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Payment Session created above will ensure that Amex payments are disabled when processing the payment. If the customer attempts to pay with Amex, the payment session will be marked as failed."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This feature is not enabled by default. Please contact support if you want to make use of them."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"next-steps","__idx":3},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To process a payment with specific payment methods disabled, you can follow the steps outlined in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/get_started/process_payments"},"children":["Initial Setup"]}," guide. No special SDK configuration is required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Additionally, have a look at the error codes on ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/get_started/process_payments/sdk_errors"},"children":["this"]}," page to handle scenarios where a customer attempts to use a disabled payment method."]}]}]},"headings":[{"value":"Disable Specific Payment Methods","id":"disable-specific-payment-methods","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"How to use","id":"how-to-use","depth":2},{"value":"Next Steps","id":"next-steps","depth":3}],"frontmatter":{"seo":{"title":"Disable Specific Payment Methods"}},"lastModified":"2026-03-13T08:30:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/documentation/get_started/initiate_payments/additional_settings/disabling-payment-methods","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}