--- title: "Payment lifecycle BPM" slug: "payment-lifecycle-bpm" tags: ["bpmn", "Associate App", "platform", "warehouse", "event stream ", "exchange", "payment", "payment options", "refund", "store fulfillment", "events", "omnichannel manager "] updated: 2026-01-06T15:10:30Z published: 2026-01-06T15:10:30Z canonical: "docs.newstore.com/payment-lifecycle-bpm" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.newstore.com/llms.txt > Use this file to discover all available pages before exploring further. # Payment lifecycle BPM The payment lifecycle is connected to the order lifecycle in NewStore, and relies on concepts such as *order fulfillment*. The payment lifecycle is represented by the diagrams below using the [BPMN notation](/v1/docs/bpmn-notation#bpmn-notation). Payment concepts are described in detail in the [Business process](/v1/docs/business-process-models) section. For more information on the order lifecycle, see [Order lifecycle BPM](/v1/docs/order-lifecycle-bpm). The diagrams in the following sections refer to events that are emitted part of the event stream. See the [entity model](/v1/docs/receiving-real-time-data#event-stream) and the [webhook](https://docs.newstore.net/api/webhooks/stream_webhook_sink_hook). If there are issues during the payment capture or refund process, an associate can try to [fix them](/v1/docs/monitoring-orders#retrying-a-payment-or-refund) using NewStore Omnichannel Manager. ## Processing the payment authorization ![](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/d954900b-642a-4a84-908f-732e7612fb34.png) [Click here to download the BPMN image](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/d954900b-642a-4a84-908f-732e7612fb34.png) When the order has been fulfilled or canceled, the payment workflow is initiated. When an order is [successfully fulfilled](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/d954900b-642a-4a84-908f-732e7612fb34.png?sv=2022-11-02&spr=https&st=2024-10-15T19%3A15%3A17Z&se=2024-10-15T19%3A30%3A17Z&sr=c&sp=r&sig=EksVpfCOyJdg42174CVLF9lFGiIdLH9ScSZ%2FeoF3p3k%3D?sv=2022-11-02&spr=https&st=2024-10-15T19%3A38%3A46Z&se=2024-10-15T19%3A53%3A46Z&sr=c&sp=r&sig=7670nylZqa7LzDb44%2BO9dxgVS%2FKLRwBcC3cD25qVyfY%3D?sv=2022-11-02&spr=https&st=2024-11-13T12%3A41%3A56Z&se=2024-11-13T12%3A56%3A56Z&sr=c&sp=r&sig=nmcRDtzn%2FhjoOeqhv0sfcieOveWd2PRQm%2FelyaaRICw%3D?sv=2022-11-02&spr=https&st=2024-11-13T12%3A42%3A49Z&se=2024-11-13T12%3A57%3A49Z&sr=c&sp=r&sig=lRk42HPW8S3L476ewvpnfeUpkNSBONl9U30IXgsk7mA%3D) , the `fulfillment_request.items_completed` event is emitted and the order moves into the payment authorization phase. The authorization of the payment depends on the mode of payment. Pre-captured payments are considered by NewStore as authorized. Payment for an order at NewStore can be done via the following methods: - *Cash*: An associate receives cash payment in the store from the customer and marks the payment process as completed in NewStore Associate App. - *Credit card*: When the customer pays for an order using a credit card, NewStore authorizes the payment. The authorization process is marked as completed in the platform. This includes credit card payments made through [NewStore Checkout](/v1/docs/setting-up-newstore-checkout-with-adyen-pay-by-link#integ-newstore-checkout). - *Gift card*: A customer can also pay for an order by redeeming a `gift card`. The payment is captured and authorized in the platform. See [Integrating a gift card provider](/v1/docs/integrating-a-gift-card-provider#integ-giftcard). Once the payment authorization is processed in NewStore Omnichannel Cloud, the `payment_account.amount_authorized` event is emitted. ## Capturing the payment ![](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/be5833ba-555d-48e6-a395-6aeb9a3296d8.png) [Click here to download the BPMN image](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/be5833ba-555d-48e6-a395-6aeb9a3296d8.png) After the payment is authorized, the payment capture phase starts. Once the payment is captured in NewStore Omnichannel Cloud via a [financial instrument](/v1/docs/integrating-a-payment-service-provider#financial-instruments), the `payment_account.amount_captured` event is emitted. When the payment is successfully captured, the order lifecycle in the platform is completed. > [!TIP] > Note > > In some situations when the payment transaction is placed via Associate App, for some payment methods such as **Adyen** or **Tap to Pay on iPhone**, the `payment_origin` property is populated in the [payload](https://docs.newstore.net/api/webhooks/stream_webhook_sink_hook/) of the `payment_account.amount_captured` event. For some other payment transactions, such as ones generated via an Adyen adapter, the `payment_origin` property may not be populated. NewStore supports integrating with multiple payment providers and payment methods. For more information, see [About payments](/v1/docs/about-payments#about-payments). ## Refunding the payment or revoking authorization ![](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/ac77f72c-128f-4194-9a91-5b57067b8c60.png) [Click here to download the BPMN image](https://cdn.document360.io/c2d22fcd-a44b-4e1e-bf3a-84f0ffba0dbe/Images/Documentation/ac77f72c-128f-4194-9a91-5b57067b8c60.png) When an order is canceled and the payment has not yet been captured in the platform, NewStore voids the authorization of the payment. The `payment_account.amount_voided` event is emitted, and the voided amount is released to the customer's credit line account. The payment is refunded to the customer if the amount has been captured in the platform and: - Items in an order or the whole order is canceled. - A customer returns items from an order. The `payment_account.amount_refunded` event is emitted. When the refunds are for `blind returns` that originate from an [external order management system](/v1/docs/about-order-fulfillment#using-an-external-oms-to-fulfill-orders) , an external order ID is added to the `payment_account.amount_refunded` event. An associate can also manually refund an order using NewStore Omnichannel Manager. See [Refunding orders or items in an order](/v1/docs/modifying-orders-for-customers#refunding-orders-or-items-in-an-order). **Related topics** - [Order lifecycle BPM](/v1/docs/order-lifecycle-bpm#bpm-order-lifecycle) - [About payments](/v1/docs/about-payments#about-payments) - [Getting started with the NewStore platform](/v1/docs/getting-started-with-the-newstore-platform#noc) - [Receiving real-time data](/v1/docs/receiving-real-time-data#event-stream) - [Event stream webhook](https://docs.newstore.net/api/webhooks/stream_webhook_sink_hook)