Skip to main content
PAYLINK_DEPOSIT_UNDERPAID is sent when a payer makes a partial payment toward a fixed-price Pay Link through the QR deposit flow. Use it to track the shortfall and follow up with the payer. This is an opt-in Pay Link webhook event. Subscribing to ALL, REGULAR_ALL, or REGULAR_TRANSACTION does not include it.

​
Subscribe

Create a Pay Link webhook with PAYLINK_DEPOSIT_UNDERPAID in optInEvents:
Include paylinkId for a specific Pay Link, or omit it for an account-wide subscription. Standard webhook authentication and signature verification apply.

​
Payload

​
Handling the event

  • The event may fire again as further partial payments arrive. Amounts are cumulative; do not add them across deliveries.
  • Handle duplicate deliveries using the charge reference and amount fields.
  • An underpaid event does not confirm payment completion. Wait for a successful Pay Link transaction webhook with event: "CREATED" or another applicable confirmation before marking the charge as paid.
This event applies only to fixed-price Pay Link QR payments. It is separate from DEPOSIT_BELOW_MINIMUM, which concerns deposit wallet settlement thresholds.