45 lines
2.5 KiB
Plaintext
45 lines
2.5 KiB
Plaintext
export const metadata = {
|
|
title: `Payment Steps in Checkout Flow`,
|
|
}
|
|
|
|
# {metadata.title}
|
|
|
|
In this guide, you'll learn about Medusa's accept payment flow that's used in checkout.
|
|
|
|
## Overview of the Payment Flow in Checkout
|
|
|
|
The Medusa application has a built-in payment flow that allows you to accept payments from customers, typically during checkout.
|
|
|
|
This flow is designed to be flexible and extensible, allowing you to integrate with various payment providers.
|
|
|
|
The payment flow consists of the following steps:
|
|
|
|

|
|
|
|
- [Create Payment Collection](!api!/store#payment-collections_postpaymentcollections): Create a payment collection associated with a cart.
|
|
- This payment collection will hold all details related to the payment operations.
|
|
- [Show Payment Providers](!api!/store#payment-providers_getpaymentproviders): Show the customer the available payment providers to choose from.
|
|
- You can integrate any [payment provider](../payment-provider/page.mdx), and you can enable them per region.
|
|
- [Create and Initialize Payment Session](!api!/store#payment-collections_postpaymentcollectionsidpaymentsessions): Create a payment session for the selected payment provider in the Medusa application, and initialize the session in the third-party payment provider.
|
|
- [Complete Cart](!api!/store#carts_postcartsidcomplete): Once the customer places the order, complete the cart, which involves:
|
|
- Authorizing the payment session with the third-party payment provider.
|
|
- If the third-party payment provider requires performing additional actions, show them to the customer, then retry cart completion.
|
|
|
|
---
|
|
|
|
## Implement Payment Checkout Step in Storefront
|
|
|
|
If you're using the [Next.js Starter Storefront](../../../nextjs-starter/page.mdx), the checkout flow is already implemented with the payment step.
|
|
|
|
If you're building a custom storefront, or you want to customize the checkout flow, you can follow the [Checkout in Storefront](../../../storefront-development/checkout/page.mdx) guide to learn how to build the checkout flow in the storefront, including the payment step.
|
|
|
|
---
|
|
|
|
{/* TODO add section on customizng the payment flow */}
|
|
|
|
## Build a Custom Payment Flow
|
|
|
|
You can also build a custom payment flow using workflows or the Payment Module's main service.
|
|
|
|
Refer to the [Accept Payment Flow](../payment-flow/page.mdx) guide to learn more.
|