Skip to main content
Processor integrations are microservices you build and host to handle atomic payment transactions within a Commerce V1 flow. When the flow reaches a transaction node, Commerce dispatches a CloudEvent to your integration. Your service coordinates with the third-party processor and reports the result back. This keeps Commerce flow-agnostic while giving you full control over processor-specific logic — including custom business rules such as checking seller balances before initiating a marketplace transfer.
Diagram showing the processor integration architecture.

​
How it works

Commerce sends a start event when the flow reaches a transaction node. The ce-type matches the value configured in that node — this is how your integration identifies which operation to perform. Once the transaction is complete, your integration sends a Finish event and Commerce routes the flow based on the result. See Flow Configuration for transaction node configuration.

​
Events

Commerce sends a Custom Transaction Event when the flow reaches a transaction node. Once processing is complete, your integration sends a Finish event and Commerce routes the flow based on the result value.