# Checkout Payment Intents API

Capture, refund, reverse, and cancel an authorized Payment.

After a [Payment](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APayment) has been [authorized](https://docs.commercetools.com/checkout/payments-lifecycle.md#authorization) and Checkout has created an [Order](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AOrder), you might need to perform actions on the Payment during its [lifecycle](https://docs.commercetools.com/checkout/payments-lifecycle.md). The Checkout Payment Intents API lets you send requests to capture, refund, reverse, or cancel an authorized Payment.
Following your request via the Checkout Payment Intents API, Checkout will request the [payment service provider](https://docs.commercetools.com/checkout/connectors-and-applications.md#supported-psps-payment-integration-types-and-payment-methods) (PSP) or gift card management system to perform the related financial process.

Use the Payment Intents API only for payments created by Checkout.

## Scope

(a CSV formatted table follows. The first line are the column names.)
Scope,Permission granted
`manage_checkout_payment_intents:{projectKey}`,Send capture, refund, reverse, or cancel requests to the payment service provider (PSP) or gift card management system and update the [Payment](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APayment) by calling the payment Connector.


## Representations

#### PaymentIntentAction

See API type definition [PaymentIntentAction](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Atype%3APaymentIntentAction).

#### PaymentIntentOperation

See API type definition [PaymentIntentOperation](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Atype%3APaymentIntentOperation).

#### PaymentIntentResponse

See API type definition [PaymentIntentResponse](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Atype%3APaymentIntentResponse).

#### PaymentIntentOutcome

See API type definition [PaymentIntentOutcome](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Atype%3APaymentIntentOutcome).

## Manage Payment by ID

See API endpoint definition [POST /\{projectKey}/payment-intents/\{paymentId}](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Aendpoint%3A%2F%7BprojectKey%7D%2Fpayment-intents%2F%7BpaymentId%7D%3APOST).

## Manage Payment Intents actions

#### Capture Payment

See API type definition [PaymentIntentCaptureAction](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Atype%3APaymentIntentCaptureAction).

#### Refund Payment

See API type definition [PaymentIntentRefundAction](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Atype%3APaymentIntentRefundAction).

#### Cancel Payment

See API type definition [PaymentIntentCancelAction](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Atype%3APaymentIntentCancelAction).

#### Reverse Payment

To use Automated Reversals, the Connectors in your Project must support the `reversePayment` action.

See API type definition [PaymentIntentReverseAction](https://docs.commercetools.com/checkout/payment-intents-api.md?urn=ctp%3Acheckout%3Atype%3APaymentIntentReverseAction).

## Related pages

- [Section overview page](https://docs.commercetools.com/checkout.md)
- [Previous page: Payment Integrations](https://docs.commercetools.com/checkout/payment-integrations-api.md)
- [Next page: Transactions](https://docs.commercetools.com/checkout/transactions-api.md)