Skip to main content
Payin webhooks notify your system about changes in the lifecycle of a funding operation.
A payin represents any incoming payment into a wallet, whether it comes from bank transfers, cards, crypto networks, or internal transfers. These events allow you to:
  • Reconcile incoming funds
  • Update user balances
  • Trigger business logic (e.g., grant access, release goods)
  • Handle failures or cancellations

​
Payin Lifecycle

A payin moves through the following states:

​
State Definitions

​
Available Webhook Events

Each state transition triggers a webhook event.

​
Payin Types

A payin can originate from different funding sources: The payinType field in the webhook payload identifies the origin of the funds.

​
Important Behavior

  • payin_completed guarantees funds are available in the wallet.
  • Only COMPLETED payins increase the wallet balance.
  • Fees and FX conversion (if applicable) are already calculated in the payload.
  • Always use orderId or own_reference for reconciliation.