Payment transaction detected

This event is emitted when a transaction has been detected in the blockchain mempool for a given payment.

Payload schema

Webhook payload

Use this schema when validating, storing, or transforming the incoming paymentTransactionDetected webhook payload.

idstring<uuid>required

Unique identifier for this webhook delivery.

webhookIdstring<uuid>required

Identifier of the webhook configuration that produced this delivery.

eventTypestringrequired

Discriminator for the event. Always the value shown here for this event.

AllowedpaymentTransactionDetected

eventDataobjectrequired

Event-specific payload. The key matches eventType.

paymentTransactionDetectedPaymentTransactionWebhookDatarequired

networkNetworkrequired

AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetCardanoDashSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetZcashZcashTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetFiat

tokenstringnullable

amountnumber<float>required>= 0

senderAddressesSenderAddress[]nullable

addressstringrequired

transactionHashstringrequired

radomDataRadomEventData

Context for the Radom object that triggered the event.

paymentLinkPaymentLinkDatarequired

paymentLinkIdstring<uuid>required

paymentLinkOrderIdstring<uuid>nullable

inputDataInputData[]nullable

labelstringrequired

valuestringnullable

checkoutSessionCheckoutSessionDatarequired

checkoutSessionIdstring<uuid>required

metadataMetadata[]nullable

keystringrequired

valuestringrequired

invoiceInvoiceDatarequired

invoiceIdstring<uuid>required

invoicePaymentIdstring<uuid>nullable

paymentSessionPaymentSessionDatarequired

paymentSessionIdstring<uuid>required

metadataMetadata[]nullable

keystringrequired

valuestringrequired

subscriptionSubscriptionIdDatarequired

subscriptionIdstring<uuid>required

donationLinkDonationLinkDatarequired

donationLinkIdstring<uuid>required

donationLinkOrderIdstring<uuid>required

Examples

{
  "id": "449add49-fb4e-4412-a8b5-4292514fa3ff",
  "webhookId": "2397dd55-c65c-4a98-b990-fcb36e2ca88b",
  "eventType": "paymentTransactionDetected",
  "eventData": {
    "paymentTransactionDetected": {
      "network": "SepoliaTestnet",
      "token": "0xa4fce8264370437e718ae207805b4e6233638b9e",
      "amount": "25.500000",
      "transactionHash": "0xaf3f03d5b876f8dda67adf3615b7eaf651f4fc6a37fa2a49032ea60a6f94f0d0"
    }
  },
  "radomData": {
    "paymentLink": {
      "paymentLinkId": "8de41e07-deea-47ab-9198-ab9759178e0a",
      "paymentLinkOrderId": "9e4110ca-07d5-4765-af82-3f0d17165837"
    }
  }
}