Skip to main content

Webhook Events

Minteo sends webhooks when entities reach final states. Payins are an exception: they also trigger webhooks when the payment gateway confirms the user completed the payment.

Available Events

order.updated

Triggered when an order reaches a final state.

Final states:

  • SUCCEEDED - Order completed successfully
  • FAILED - Order failed

Related schema: Order


payout.updated

Triggered when a payout reaches a final state.

Final states:

  • FULFILLED - Payout completed successfully
  • ABORTED - Payout was aborted

Related schema: Payout


payout.item.updated

Triggered when a payout item reaches a final state.

Final states:

  • SUCCEEDED - Payout item succeeded
  • REJECTED - Payout item was rejected

Related schema: Payout Item


payin.updated

Triggered when a payin reaches a final state or when the payment gateway confirms the user completed the payment.

info

Payins are the only entity that triggers webhooks at an intermediate state. This allows you to react immediately when the user completes the payment, before the payin is fully processed.

Intermediate states:

  • IN_PROGRESS with status_code: GATEWAY_CONFIRM_PAYIN - Payment confirmed by the gateway

Final states:

  • FULFILLED - Payin completed successfully
  • ABORTED - Payin was aborted

Related schema: Payin


Next steps