asyavee/medusa-store
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: add a troubleshooting section on creating a payment session with zero total (#12974)

Browse Source
This commit is contained in:
Shahed Nasser
2025-07-16 14:26:40 +03:00
committed by GitHub
parent 1797f0298b
commit 5527d95b5c
11 changed files with 129 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
www/apps/api-reference/specs/store/openapi.full.yaml
View File

@@ -5114,7 +5114,11 @@ paths:
operationId: PostPaymentCollectionsIdPaymentSessions
summary: Initialize Payment Session of a Payment Collection
x-sidebar-summary: Initialize Payment Session
description: Initialize and add a payment session to a payment collection. This is used during checkout, where you create a payment collection for the cart, then initialize a payment session for the payment provider that the customer chooses.
description: |
Initialize and add a payment session to a payment collection. This is used during checkout, where you create a payment collection for the cart, then initialize a payment session for the payment provider that the customer chooses.
It's highly recommended to have an amount greater than `0` in the payment collection, as some payment providers, such as Stripe, require a non-zero amount to create a payment session. Otherwise, an error will be thrown on the payment provider's side.
In cases where you want to create a payment session for a payment collection with an amount of `0`, you can use the Manual System Payment Provider instead of third-party payment providers. The Manual System Payment Provider is built into Medusa and allows you to create payment sessions without interacting with an external payment provider.
Make sure to configure the Manual System Payment Provider in your store's region. Learn more in the [Manage Region](https://docs.medusajs.com/user-guide/settings/regions#edit-region-details) user guide.
externalDocs:
url: https://docs.medusajs.com/v2/resources/storefront-development/checkout/payment
description: 'Storefront guide: How to implement payment during checkout.'

18
www/apps/api-reference/specs/store/paths/store_payment-collections_{id}_payment-sessions.yaml
View File

@@ -2,11 +2,27 @@ post:
operationId: PostPaymentCollectionsIdPaymentSessions
summary: Initialize Payment Session of a Payment Collection
x-sidebar-summary: Initialize Payment Session
description: >-
description: >
Initialize and add a payment session to a payment collection. This is used
during checkout, where you create a payment collection for the cart, then
initialize a payment session for the payment provider that the customer
chooses.
It's highly recommended to have an amount greater than `0` in the payment
collection, as some payment providers, such as Stripe, require a non-zero
amount to create a payment session. Otherwise, an error will be thrown on
the payment provider's side.
In cases where you want to create a payment session for a payment collection
with an amount of `0`, you can use the Manual System Payment Provider
instead of third-party payment providers. The Manual System Payment Provider
is built into Medusa and allows you to create payment sessions without
interacting with an external payment provider.
Make sure to configure the Manual System Payment Provider in your store's
region. Learn more in the [Manage
Region](https://docs.medusajs.com/user-guide/settings/regions#edit-region-details)
user guide.
externalDocs:
url: >-
https://docs.medusajs.com/v2/resources/storefront-development/checkout/payment