createOrUpdateOrderPaymentCollectionWorkflow - Medusa Core Workflows Reference

This documentation provides a reference to the createOrUpdateOrderPaymentCollectionWorkflow. It belongs to the @medusajs/medusa/core-flows package.

This workflow creates or updates payment collection for an order. It's used by other order-related workflows, such as createOrderPaymentCollectionWorkflow to update an order's payment collections based on changes made to the order.

You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around creating or updating payment collections for an order.

Source Code

Examples#

Steps#

Input#

order_idstring
amountnumberOptional

Output#

PaymentCollectionDTO[]PaymentCollectionDTO[]
idstring
The ID of the payment collection.
currency_codestring
The ISO 3 character currency code of the payment sessions and payments associated with payment collection.
The total amount to be authorized and captured.
The status of the payment collection.
payment_providersPaymentProviderDTO[]
The payment provider used to process the associated payment sessions and payments.
authorized_amountBigNumberValueOptional
The amount authorized within the associated payment sessions.
refunded_amountBigNumberValueOptional
The amount refunded within the associated payments.
captured_amountBigNumberValueOptional
The amount captured within the associated payments.
completed_atstring | DateOptional
When the payment collection was completed.
created_atstring | DateOptional
When the payment collection was created.
updated_atstring | DateOptional
When the payment collection was updated.
metadataRecord<string, unknown>Optional
Holds custom data in key-value pairs.
payment_sessionsPaymentSessionDTO[]Optional
The associated payment sessions.
paymentsPaymentDTO[]Optional
The associated payments.
Was this page helpful?
Ask Anything
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break