Skip to content

Integration Flows

SenteRail integrations combine API requests, asynchronous events, and reconciliation. Design your system so each step can be retried, verified, and matched to your own records.

Merchant Checkout Flow

mermaid
flowchart LR
  merchant[Merchant backend] -->|Create payment session| senterail[SenteRail]
  senterail -->|Payment instructions or redirect| customer[Customer]
  senterail -->|Signed event| webhook[Merchant webhook receiver]
  webhook -->|Verify and persist| system[Merchant system]
  system -->|Reconcile| records[Orders or accounting records]

Webhook Recovery Flow

mermaid
flowchart LR
  event[SenteRail event] --> verify[Verify signature]
  verify --> persist[Persist event ID]
  persist --> apply[Apply state once]
  apply --> reconcile[Reconcile with local records]
  verify -->|Invalid| reject[Reject and alert]

Reconciliation Flow

mermaid
flowchart LR
  local[Your source of truth] --> compare[Compare references]
  events[SenteRail events] --> compare
  compare --> matched[Matched records]
  compare --> exception[Exception or support case]