createOrderPaymentCollectionWorkflow - Medusa Core Workflows Reference

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

This workflow creates a payment collection for an order. It's used by the Create Payment Collection Admin API Route.

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

Source Code

Examples#

Steps#

Workflow hook

Step conditioned by when

View step details

Input#

CreateOrderPaymentCollectionWorkflowInputCreateOrderPaymentCollectionWorkflowInput
The details of the payment collection to create.
order_idstring
The id of the order for which to create a payment collection.
amountnumber
The amount of the payment collection.

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