Payment Webhooks

Suave provides webhooks to send updates whenever the status of a payment order changes. This includes when a payment order is created, succeeds, or fails.

Our webhooks return metadata associated with the payment, as well as any transaction details, such as hashes and timestamps.

Events are triggered with 3 types: payment_processing, payment_success, and payment_failed.

Example Payload

{
  "event": {
    "resource": "event",
    "type": "payment_success",
    "created_at": "2021-01-01T00:00:00Z",
    "env_mode": "live",
    "data": {
      "payment_order_id": "order-id",
      "metadata": { "nft-purchased": "Bored Ape NFT #1234" },
      "transaction_hash": "0x1234567890"
    }
  }
}