UNPKG

openapi-directory

Version:

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

1 lines 513 kB
{"openapi":"3.1.0","servers":[{"url":"https://checkout-test.adyen.com/v71"}],"info":{"contact":{"name":"Adyen Developer Experience team","url":"https://github.com/Adyen/adyen-openapi","x-twitter":"Adyen"},"description":"Adyen Checkout API provides a simple and flexible way to initiate and authorise online payments. You can use the same integration for payments made with cards (including 3D Secure), mobile wallets, and local payment methods (for example, iDEAL and Sofort).\n\nThis API reference provides information on available endpoints and how to interact with them. To learn more about the API, visit [online payments documentation](https://docs.adyen.com/online-payments).\n\n## Authentication\nEach request to Checkout API must be signed with an API key. For this, [get your API key](https://docs.adyen.com/development-resources/api-credentials#generate-api-key) from your Customer Area, and set this key to the `X-API-Key` header value, for example:\n\n```\ncurl\n-H \"Content-Type: application/json\" \\\n-H \"X-API-Key: YOUR_API_KEY\" \\\n...\n```\n## Versioning\nCheckout API supports [versioning](https://docs.adyen.com/development-resources/versioning) using a version suffix in the endpoint URL. This suffix has the following format: \"vXX\", where XX is the version number.\n\nFor example:\n```\nhttps://checkout-test.adyen.com/v71/payments\n```\n\n## Going live\n\nTo access the live endpoints, you need an API key from your live Customer Area.\n\nThe live endpoint URLs contain a prefix which is unique to your company account, for example:\n```\nhttps://{PREFIX}-checkout-live.adyenpayments.com/checkout/v71/payments\n```\n\nGet your `{PREFIX}` from your live Customer Area under **Developers** > **API URLs** > **Prefix**.\n\nWhen preparing to do live transactions with Checkout API, follow the [go-live checklist](https://docs.adyen.com/online-payments/go-live-checklist) to make sure you've got all the required configuration in place.\n\n## Release notes\nHave a look at the [release notes](https://docs.adyen.com/online-payments/release-notes?integration_type=api&version=71) to find out what changed in this version!","termsOfService":"https://www.adyen.com/legal/terms-and-conditions","title":"Adyen Checkout API","version":"71","x-apisguru-categories":["payment"],"x-logo":{"url":"https://twitter.com/Adyen/profile_image?size=original"},"x-origin":[{"format":"openapi","url":"https://raw.githubusercontent.com/Adyen/adyen-openapi/main/json/CheckoutService-v71.json","version":"3.1"}],"x-providerName":"adyen.com","x-publicVersion":true,"x-serviceName":"CheckoutService-v71"},"tags":[{"name":"Payments"},{"name":"Donations"},{"name":"Payment links"},{"name":"Modifications"},{"name":"Recurring"},{"name":"Orders"},{"name":"Utility"},{"name":"Classic Checkout SDK"}],"paths":{"/applePay/sessions":{"post":{"description":"You need to use this endpoint if you have an API-only integration with Apple Pay which uses Adyen's Apple Pay certificate.\n\nThe endpoint returns the Apple Pay session data which you need to complete the [Apple Pay session validation](https://docs.adyen.com/payment-methods/apple-pay/api-only?tab=adyen-certificate-validation_1#complete-apple-pay-session-validation).","operationId":"post-applePay-sessions","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-applePay-sessions-basic"}},"schema":{"$ref":"#/components/schemas/ApplePaySessionRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-applePay-sessions-basic-200"}},"schema":{"$ref":"#/components/schemas/ApplePaySessionResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Get an Apple Pay session","tags":["Utility"],"x-methodName":"getApplePaySession","x-sortIndex":2}},"/cancels":{"post":{"description":"Cancels the authorisation on a payment that has not yet been [captured](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/{paymentPspReference}/captures), and returns a unique reference for this request. You get the outcome of the request asynchronously, in a [**TECHNICAL_CANCEL** webhook](https://docs.adyen.com/online-payments/cancel#cancellation-webhook).\n\nIf you want to cancel a payment using the [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference), use the [`/payments/{paymentPspReference}/cancels`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/{paymentPspReference}/cancels) endpoint instead.\n\nIf you want to cancel a payment but are not sure whether it has been captured, use the [`/payments/{paymentPspReference}/reversals`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/{paymentPspReference}/reversals) endpoint instead.\n\nFor more information, refer to [Cancel](https://docs.adyen.com/online-payments/cancel).","operationId":"post-cancels","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"cancel-with-own-reference":{"$ref":"#/components/examples/post-cancels-cancel-with-own-reference"}},"schema":{"$ref":"#/components/schemas/StandalonePaymentCancelRequest"}}}},"responses":{"201":{"content":{"application/json":{"examples":{"cancel-with-own-reference":{"$ref":"#/components/examples/post-cancels-cancel-with-own-reference-201"}},"schema":{"$ref":"#/components/schemas/StandalonePaymentCancelResponse"}}},"description":"Created - the request has been fulfilled and has resulted in one or more new resources being created.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Cancel an authorised payment","tags":["Modifications"],"x-methodName":"cancelAuthorisedPayment","x-sortIndex":3}},"/cardDetails":{"post":{"description":"Send a request with at least the first 6 digits of the card number to get a response with an array of brands on the card. If you include [your supported brands](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/cardDetails__reqParam_supportedBrands) in the request, the response also tells you if you support each [brand that was identified](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/cardDetails__resParam_details).\n\nIf you have an API-only integration and collect card data, use this endpoint to find out if the shopper's card is co-branded. For co-branded cards, you must let the shopper choose the brand to pay with if you support both brands.\n\n","operationId":"post-cardDetails","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-cardDetails-basic"},"supported-brands":{"$ref":"#/components/examples/post-cardDetails-supported-brands"}},"schema":{"$ref":"#/components/schemas/CardDetailsRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-cardDetails-basic-200"},"supported-brands":{"$ref":"#/components/examples/post-cardDetails-supported-brands-200"}},"schema":{"$ref":"#/components/schemas/CardDetailsResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Get the list of brands on the card","tags":["Payments"],"x-methodName":"cardDetails","x-sortIndex":6}},"/donations":{"post":{"description":"Takes in the donation token generated by the `/payments` request and uses it to make the donation for the donation account specified in the request.\n\nFor more information, see [Donations](https://docs.adyen.com/online-payments/donations).","operationId":"post-donations","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"donations":{"$ref":"#/components/examples/post-donations-donations"},"donations-with-token":{"$ref":"#/components/examples/post-donations-donations-with-token"}},"schema":{"$ref":"#/components/schemas/DonationPaymentRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"donations":{"$ref":"#/components/examples/post-donations-donations-200"}},"schema":{"$ref":"#/components/schemas/DonationPaymentResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Start a transaction for donations","tags":["Donations"],"x-methodName":"donations","x-sortIndex":2}},"/orders":{"post":{"description":"Creates an order to be used for partial payments. Make a POST `/orders` call before making a `/payments` call when processing payments with different payment methods.","operationId":"post-orders","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-orders-basic"}},"schema":{"$ref":"#/components/schemas/CreateOrderRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-orders-basic-200"}},"schema":{"$ref":"#/components/schemas/CreateOrderResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Create an order","tags":["Orders"],"x-methodName":"orders","x-sortIndex":2}},"/orders/cancel":{"post":{"description":"Cancels an order. Cancellation of an order results in an automatic rollback of all payments made in the order, either by canceling or refunding the payment, depending on the type of payment method.","operationId":"post-orders-cancel","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-orders-cancel-basic"}},"schema":{"$ref":"#/components/schemas/CancelOrderRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-orders-cancel-basic-200"}},"schema":{"$ref":"#/components/schemas/CancelOrderResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Cancel an order","tags":["Orders"],"x-methodName":"cancelOrder","x-sortIndex":3}},"/originKeys":{"post":{"deprecated":true,"description":"This operation takes the origin domains and returns a JSON object containing the corresponding origin keys for the domains. \n> If you're still using origin key for your Web Drop-in or Components integration, we recommend [switching to client key](https://docs.adyen.com/development-resources/client-side-authentication/migrate-from-origin-key-to-client-key). This allows you to use a single key for all origins, add or remove origins without generating a new key, and detect the card type from the number entered in your payment form. ","operationId":"post-originKeys","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-originKeys-basic"}},"schema":{"$ref":"#/components/schemas/UtilityRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-originKeys-basic-200"}},"schema":{"$ref":"#/components/schemas/UtilityResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Create originKey values for domains","tags":["Utility"],"x-deprecatedInVersion":"67","x-methodName":"originKeys","x-sortIndex":1}},"/paymentLinks":{"post":{"description":"Creates a payment link to our hosted payment form where shoppers can pay. The list of payment methods presented to the shopper depends on the `currency` and `country` parameters sent in the request.\n\nFor more information, refer to [Pay by Link documentation](https://docs.adyen.com/online-payments/pay-by-link#create-payment-links-through-api).","operationId":"post-paymentLinks","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-paymentLinks-basic"}},"schema":{"$ref":"#/components/schemas/PaymentLinkRequest"}}}},"responses":{"201":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-paymentLinks-basic-201"}},"schema":{"$ref":"#/components/schemas/PaymentLinkResponse"}}},"description":"Created - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Create a payment link","tags":["Payment links"],"x-methodName":"paymentLinks","x-sortIndex":1}},"/paymentLinks/{linkId}":{"get":{"description":"Retrieves the payment link details using the payment link `id`.","operationId":"get-paymentLinks-linkId","parameters":[{"description":"Unique identifier of the payment link.","in":"path","name":"linkId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/get-paymentLinks-linkId-basic-200"}},"schema":{"$ref":"#/components/schemas/PaymentLinkResponse"}}},"description":"OK - the request has succeeded."},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error."},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Get a payment link","tags":["Payment links"],"x-methodName":"getPaymentLink","x-sortIndex":2},"patch":{"description":"Updates the status of a payment link. Use this endpoint to [force the expiry of a payment link](https://docs.adyen.com/online-payments/pay-by-link#update-payment-link-status).","operationId":"patch-paymentLinks-linkId","parameters":[{"description":"Unique identifier of the payment link.","in":"path","name":"linkId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/patch-paymentLinks-linkId-basic"}},"schema":{"$ref":"#/components/schemas/UpdatePaymentLinkRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/patch-paymentLinks-linkId-basic-200"}},"schema":{"$ref":"#/components/schemas/PaymentLinkResponse"}}},"description":"OK - the request has succeeded."},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error."},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Update the status of a payment link","tags":["Payment links"],"x-methodName":"updatePaymentLink","x-sortIndex":3}},"/paymentMethods":{"post":{"description":"Queries the available payment methods for a transaction based on the transaction context (like amount, country, and currency). Besides giving back a list of the available payment methods, the response also returns which input details you need to collect from the shopper (to be submitted to `/payments`).\n\nAlthough we highly recommend using this endpoint to ensure you are always offering the most up-to-date list of payment methods, its usage is optional. You can, for example, also cache the `/paymentMethods` response and update it once a week.","operationId":"post-paymentMethods","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-paymentMethods-basic"},"filtered":{"$ref":"#/components/examples/post-paymentMethods-filtered"},"include-stored":{"$ref":"#/components/examples/post-paymentMethods-include-stored"}},"schema":{"$ref":"#/components/schemas/PaymentMethodsRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-paymentMethods-basic-200"},"filtered":{"$ref":"#/components/examples/post-paymentMethods-filtered-200"},"include-stored":{"$ref":"#/components/examples/post-paymentMethods-include-stored-200"}},"schema":{"$ref":"#/components/schemas/PaymentMethodsResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Get a list of available payment methods","tags":["Payments"],"x-methodName":"paymentMethods","x-sortIndex":2}},"/paymentMethods/balance":{"post":{"description":"Retrieves the balance remaining on a shopper's gift card. To check a gift card's balance, make a POST `/paymentMethods/balance` call and include the gift card's details inside a `paymentMethod` object.","operationId":"post-paymentMethods-balance","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-paymentMethods-balance-basic"},"not-enough":{"$ref":"#/components/examples/post-paymentMethods-balance-not-enough"}},"schema":{"$ref":"#/components/schemas/BalanceCheckRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-paymentMethods-balance-basic-200"},"not-enough":{"$ref":"#/components/examples/post-paymentMethods-balance-not-enough-200"}},"schema":{"$ref":"#/components/schemas/BalanceCheckResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Get the balance of a gift card","tags":["Orders"],"x-methodName":"getBalanceOfGiftCard","x-sortIndex":1}},"/paymentSession":{"post":{"deprecated":true,"description":"Provides the data object that can be used to start the Checkout SDK. To set up the payment, pass its amount, currency, and other required parameters. We use this to optimise the payment flow and perform better risk assessment of the transaction.\n\nFor more information, refer to [How it works](https://docs.adyen.com/online-payments#howitworks).","operationId":"post-paymentSession","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"android":{"$ref":"#/components/examples/post-paymentSession-android"},"enableOneClick":{"$ref":"#/components/examples/post-paymentSession-enableOneClick"},"ios":{"$ref":"#/components/examples/post-paymentSession-ios"},"split":{"$ref":"#/components/examples/post-paymentSession-split"},"web":{"$ref":"#/components/examples/post-paymentSession-web"}},"schema":{"$ref":"#/components/schemas/PaymentSetupRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"enableOneClick":{"$ref":"#/components/examples/post-paymentSession-enableOneClick-200"},"web":{"$ref":"#/components/examples/post-paymentSession-web-200"}},"schema":{"$ref":"#/components/schemas/PaymentSetupResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Create a payment session","tags":["Classic Checkout SDK"],"x-deprecatedInVersion":"37","x-methodName":"paymentSession","x-sortIndex":1}},"/payments":{"post":{"description":"Sends payment parameters (like amount, country, and currency) together with other required input details collected from the shopper. To know more about required parameters for specific payment methods, refer to our [payment method guides](https://docs.adyen.com/payment-methods). \nThe response depends on the [payment flow](https://docs.adyen.com/payment-methods#payment-flow):\n* For a direct flow, the response includes a `pspReference` and a `resultCode` with the payment result, for example **Authorised** or **Refused**. \n* For a redirect or additional action, the response contains an `action` object. ","operationId":"post-payments","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"applepay":{"$ref":"#/components/examples/post-payments-applepay"},"card-3d-secure-2-web":{"$ref":"#/components/examples/post-payments-card-3d-secure-2-web"},"card-3d-secure-direct":{"$ref":"#/components/examples/post-payments-card-3d-secure-direct"},"card-direct":{"$ref":"#/components/examples/post-payments-card-direct"},"card-securedfields":{"$ref":"#/components/examples/post-payments-card-securedfields"},"enableOneClick-SF":{"$ref":"#/components/examples/post-payments-enableOneClick-SF"},"googlepay":{"$ref":"#/components/examples/post-payments-googlepay"},"ideal":{"$ref":"#/components/examples/post-payments-ideal"},"klarna":{"$ref":"#/components/examples/post-payments-klarna"},"oneclick-securedfields":{"$ref":"#/components/examples/post-payments-oneclick-securedfields"},"recurring":{"$ref":"#/components/examples/post-payments-recurring"},"split-balanceplatform":{"$ref":"#/components/examples/post-payments-split-balanceplatform"},"split-classic":{"$ref":"#/components/examples/post-payments-split-classic"},"subscription-first-transaction":{"$ref":"#/components/examples/post-payments-subscription-first-transaction"}},"schema":{"$ref":"#/components/schemas/PaymentRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"card-direct":{"$ref":"#/components/examples/post-payments-card-direct-200"},"card-securedfields":{"$ref":"#/components/examples/post-payments-card-securedfields-200"},"enableOneClick-SF":{"$ref":"#/components/examples/post-payments-enableOneClick-SF-200"},"ideal":{"$ref":"#/components/examples/post-payments-ideal-200"},"split-balanceplatform":{"$ref":"#/components/examples/post-payments-split-balanceplatform-200"},"subscription-first-transaction":{"$ref":"#/components/examples/post-payments-subscription-first-transaction-200"}},"schema":{"$ref":"#/components/schemas/PaymentResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Start a transaction","tags":["Payments"],"x-methodName":"payments","x-sortIndex":3}},"/payments/details":{"post":{"description":"Submits details for a payment created using `/payments`. This step is only needed when no final state has been reached on the `/payments` request, for example when the shopper was redirected to another page to complete the payment.\n\n","operationId":"post-payments-details","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"00.redirect":{"$ref":"#/components/examples/post-payments-details-00.redirect"},"3d-secure-2-native":{"$ref":"#/components/examples/post-payments-details-3d-secure-2-native"}},"schema":{"$ref":"#/components/schemas/PaymentDetailsRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"00.redirect":{"$ref":"#/components/examples/post-payments-details-00.redirect-200"}},"schema":{"$ref":"#/components/schemas/PaymentDetailsResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Submit details for a payment","tags":["Payments"],"x-methodName":"paymentsDetails","x-sortIndex":4}},"/payments/result":{"post":{"deprecated":true,"description":"Verifies the payment result using the payload returned from the Checkout SDK.\n\nFor more information, refer to [How it works](https://docs.adyen.com/online-payments#howitworks).","operationId":"post-payments-result","parameters":[{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-payments-result-basic"}},"schema":{"$ref":"#/components/schemas/PaymentVerificationRequest"}}}},"responses":{"200":{"content":{"application/json":{"examples":{"basic":{"$ref":"#/components/examples/post-payments-result-basic-200"}},"schema":{"$ref":"#/components/schemas/PaymentVerificationResponse"}}},"description":"OK - the request has succeeded.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Verify a payment result","tags":["Classic Checkout SDK"],"x-deprecatedInVersion":"37","x-methodName":"verifyPaymentResult","x-sortIndex":2}},"/payments/{paymentPspReference}/amountUpdates":{"post":{"description":"Increases or decreases the authorised payment amount and returns a unique reference for this request. You get the outcome of the request asynchronously, in an [**AUTHORISATION_ADJUSTMENT** webhook](https://docs.adyen.com/development-resources/webhooks/understand-notifications#event-codes).\n\nYou can only update authorised amounts that have not yet been [captured](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/{paymentPspReference}/captures).\n\nThe amount you specify in the request is the updated amount, which is larger or smaller than the initial authorised amount.\n\nFor more information, refer to [Authorisation adjustment](https://docs.adyen.com/online-payments/adjust-authorisation#use-cases).","operationId":"post-payments-paymentPspReference-amountUpdates","parameters":[{"description":"The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment.","in":"path","name":"paymentPspReference","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"amount-update":{"$ref":"#/components/examples/post-payments-paymentPspReference-amountUpdates-amount-update"}},"schema":{"$ref":"#/components/schemas/PaymentAmountUpdateRequest"}}}},"responses":{"201":{"content":{"application/json":{"examples":{"amount-update":{"$ref":"#/components/examples/post-payments-paymentPspReference-amountUpdates-amount-update-201"}},"schema":{"$ref":"#/components/schemas/PaymentAmountUpdateResponse"}}},"description":"Created - the request has been fulfilled and has resulted in one or more new resources being created.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Update an authorised amount","tags":["Modifications"],"x-methodName":"updateAuthorisedAmount","x-sortIndex":6}},"/payments/{paymentPspReference}/cancels":{"post":{"description":"Cancels the authorisation on a payment that has not yet been [captured](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/paymentPspReference/captures), and returns a unique reference for this request. You get the outcome of the request asynchronously, in a [**CANCELLATION** webhook](https://docs.adyen.com/online-payments/cancel#cancellation-webhook).\n\nIf you want to cancel a payment but don't have the [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference), use the [`/cancels`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/cancels) endpoint instead.\n\nIf you want to cancel a payment but are not sure whether it has been captured, use the [`/payments/{paymentPspReference}/reversals`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments/{paymentPspReference}/reversals) endpoint instead.\n\nFor more information, refer to [Cancel](https://docs.adyen.com/online-payments/cancel).","operationId":"post-payments-paymentPspReference-cancels","parameters":[{"description":"The [`pspReference`](https://docs.adyen.com/api-explorer/#/CheckoutService/latest/post/payments__resParam_pspReference) of the payment that you want to cancel. ","in":"path","name":"paymentPspReference","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/Idempotency-Key"}],"requestBody":{"content":{"application/json":{"examples":{"cancel-with-psp-reference":{"$ref":"#/components/examples/post-payments-paymentPspReference-cancels-cancel-with-psp-reference"}},"schema":{"$ref":"#/components/schemas/PaymentCancelRequest"}}}},"responses":{"201":{"content":{"application/json":{"examples":{"cancel-with-psp-reference":{"$ref":"#/components/examples/post-payments-paymentPspReference-cancels-cancel-with-psp-reference-201"}},"schema":{"$ref":"#/components/schemas/PaymentCancelResponse"}}},"description":"Created - the request has been fulfilled and has resulted in one or more new resources being created.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"400":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-400"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Bad Request - a problem reading or understanding the request."},"401":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-401"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unauthorized - authentication required."},"403":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-403"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Forbidden - insufficient permissions to process the request."},"422":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-422"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Unprocessable Entity - a request validation error.","headers":{"Idempotency-Key":{"$ref":"#/components/headers/Idempotency-Key"}}},"500":{"content":{"application/json":{"examples":{"generic":{"$ref":"#/components/examples/generic-500"}},"schema":{"$ref":"#/components/schemas/ServiceError"}}},"description":"Internal Server Error - the server could not process the request."}},"security":[{"BasicAuth":[]},{"ApiKeyAuth":[]}],"summary":"Cancel an authorised payment","tags":["Modifications"],"x-methodName":"cancelAuthorisedPaymentByPspReference","x-sortIndex":2}},"/payments/{paymentPspReference}/captures":{"post":{"description":" Captures an authorised payment and returns a unique reference for this request. You get the outcome of the request asynchronously, in a [**CAPTURE** webhook](https://docs.adyen.com/online-payments/capture#capture-notification).\n\nYou can capture either the full authorised amount or a part of the authorised amount. By default, any unclaimed amount after a partial capture gets cancelled. This does not apply if you enabled multiple partial captures on your account and the payment method supports multiple partial captures. \n\n[Automatic capture](https://docs.adyen.com/online-payments/capture#automatic-capture) is the default setting for most payment methods. In these cases, you don't need to make capture requests. However, making capture requests for payments that are captured automatically does not result in doub