Get webhook event by ID - Coinbase Developer Documentation

Get webhook event by ID

curl --request GET \
  --url https://payments.coinbase.com/api/v1/webhook-events/{id} \
  --header 'Authorization: <api-key>'

{
  "entity": "<string>",
  "id": "<string>",
  "eventType": "EVENT_TYPE_PAYMENT_AUTHORIZED",
  "operationType": "OPERATION_TYPE_PAYMENT",
  "paymentOperation": {
    "entity": "<string>",
    "id": "<string>",
    "transactionHash": "<string>",
    "params": {},
    "status": "PAYMENT_OPERATION_STATUS_SUCCEEDED",
    "action": "PAYMENT_OPERATION_ACTION_AUTHORIZE",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "payment": {
      "entity": "<string>",
      "id": "<string>",
      "maxAmount": "<string>",
      "token": "<string>",
      "networkId": 123,
      "payer": "<string>",
      "signature": "<string>",
      "receiver": "<string>",
      "maxFeeBps": 123,
      "minFeeBps": 123,
      "feeReceiver": "<string>",
      "salt": "<string>",
      "paymentInfoHash": "<string>",
      "nonce": "<string>",
      "authorizationExpiry": "<string>",
      "preApprovalExpiry": "<string>",
      "refundExpiry": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "operator": "<string>",
      "contractAddress": "<string>",
      "authorizedAmount": "<string>",
      "capturedAmount": "<string>",
      "voidedAmount": "<string>",
      "refundedAmount": "<string>",
      "chargedAmount": "<string>",
      "merchantId": "<string>"
    },
    "output": "<string>",
    "error": "<string>",
    "errorCode": "<string>",
    "revertReason": "<string>",
    "blockNumber": "<string>",
    "metadata": {}
  },
  "rewardOperation": {
    "id": "<string>",
    "action": "REWARD_OPERATION_ACTION_ALLOCATE",
    "status": "REWARD_OPERATION_STATUS_PENDING",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "reward": {
      "id": "<string>",
      "campaignAddress": "<string>",
      "paymentInfoHash": "<string>",
      "recipientAddress": "<string>",
      "tokenAddress": "<string>",
      "chainId": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "amount": "<string>",
    "transactionHash": "<string>",
    "error": "<string>",
    "errorCode": "<string>",
    "revertReason": "<string>",
    "blockNumber": "<string>"
  },
  "webhook": {
    "entity": "<string>",
    "id": "<string>",
    "operatorCoinbaseUserId": "<string>",
    "identifier": "<string>",
    "description": "<string>",
    "url": "<string>",
    "events": [
      "EVENT_TYPE_PAYMENT_AUTHORIZED"
    ],
    "secret": "<string>",
    "status": "WEBHOOK_STATUS_ACTIVATED",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "source": "WEBHOOK_SOURCE_OPERATOR",
  "attempts": 123,
  "maxRetries": 123,
  "apiVersion": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "deliveredAt": "2023-11-07T05:31:56Z",
  "metadata": {}
}

GET

api

webhook-events

{id}

Get webhook event by ID

curl --request GET \
  --url https://payments.coinbase.com/api/v1/webhook-events/{id} \
  --header 'Authorization: <api-key>'

{
  "entity": "<string>",
  "id": "<string>",
  "eventType": "EVENT_TYPE_PAYMENT_AUTHORIZED",
  "operationType": "OPERATION_TYPE_PAYMENT",
  "paymentOperation": {
    "entity": "<string>",
    "id": "<string>",
    "transactionHash": "<string>",
    "params": {},
    "status": "PAYMENT_OPERATION_STATUS_SUCCEEDED",
    "action": "PAYMENT_OPERATION_ACTION_AUTHORIZE",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "payment": {
      "entity": "<string>",
      "id": "<string>",
      "maxAmount": "<string>",
      "token": "<string>",
      "networkId": 123,
      "payer": "<string>",
      "signature": "<string>",
      "receiver": "<string>",
      "maxFeeBps": 123,
      "minFeeBps": 123,
      "feeReceiver": "<string>",
      "salt": "<string>",
      "paymentInfoHash": "<string>",
      "nonce": "<string>",
      "authorizationExpiry": "<string>",
      "preApprovalExpiry": "<string>",
      "refundExpiry": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "operator": "<string>",
      "contractAddress": "<string>",
      "authorizedAmount": "<string>",
      "capturedAmount": "<string>",
      "voidedAmount": "<string>",
      "refundedAmount": "<string>",
      "chargedAmount": "<string>",
      "merchantId": "<string>"
    },
    "output": "<string>",
    "error": "<string>",
    "errorCode": "<string>",
    "revertReason": "<string>",
    "blockNumber": "<string>",
    "metadata": {}
  },
  "rewardOperation": {
    "id": "<string>",
    "action": "REWARD_OPERATION_ACTION_ALLOCATE",
    "status": "REWARD_OPERATION_STATUS_PENDING",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "reward": {
      "id": "<string>",
      "campaignAddress": "<string>",
      "paymentInfoHash": "<string>",
      "recipientAddress": "<string>",
      "tokenAddress": "<string>",
      "chainId": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "amount": "<string>",
    "transactionHash": "<string>",
    "error": "<string>",
    "errorCode": "<string>",
    "revertReason": "<string>",
    "blockNumber": "<string>"
  },
  "webhook": {
    "entity": "<string>",
    "id": "<string>",
    "operatorCoinbaseUserId": "<string>",
    "identifier": "<string>",
    "description": "<string>",
    "url": "<string>",
    "events": [
      "EVENT_TYPE_PAYMENT_AUTHORIZED"
    ],
    "secret": "<string>",
    "status": "WEBHOOK_STATUS_ACTIVATED",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "source": "WEBHOOK_SOURCE_OPERATOR",
  "attempts": 123,
  "maxRetries": 123,
  "apiVersion": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "deliveredAt": "2023-11-07T05:31:56Z",
  "metadata": {}
}

Authorizations

Authorization

string

header

required

Authorization header using the Bearer scheme. Learn more about JWT tokens in the Coinbase Developer Portal.

Path Parameters

string

required

The unique identifier of the webhook event.

Response

A successful response.

Webhook event payload details.

entity

string

eventType

enum<string>

List of supported events.

Available options:

EVENT_TYPE_PAYMENT_AUTHORIZED,

EVENT_TYPE_PAYMENT_CAPTURED,

EVENT_TYPE_PAYMENT_VOIDED,

EVENT_TYPE_PAYMENT_REFUNDED,

EVENT_TYPE_PAYMENT_CHARGED,

EVENT_TYPE_REWARD_ALLOCATED,

EVENT_TYPE_REWARD_DISTRIBUTED,

EVENT_TYPE_REWARD_DEALLOCATED,

EVENT_TYPE_REWARD_SENT,

EVENT_TYPE_PAYMENT_RECONCILED

operationType

enum<string>

Type of operation that triggered the webhook.

Available options:

OPERATION_TYPE_PAYMENT,

OPERATION_TYPE_REWARD

paymentOperation

PaymentOperation · object

Event details related to a payment including transaction hash, status, and associated payment information.

Show child attributes

paymentOperation.entity

string

required

Entity type, e.g., 'payment-operation'.

paymentOperation.id

string

required

Unique event ID.

paymentOperation.transactionHash

string

required

Blockchain transaction hash.

paymentOperation.params

Params · object

required

Payment Operation Parameters.

Show child attributes

paymentOperation.params.{key}

string

paymentOperation.status

enum<string>

required

Payment Operation status.

Available options:

PAYMENT_OPERATION_STATUS_SUCCEEDED,

PAYMENT_OPERATION_STATUS_FAILED,

PAYMENT_OPERATION_STATUS_PENDING

paymentOperation.action

enum<string>

required

Type of action (e.g., PAYMENT_OPERATION_ACTION_AUTHORIZE).

Available options:

PAYMENT_OPERATION_ACTION_AUTHORIZE,

PAYMENT_OPERATION_ACTION_CAPTURE,

PAYMENT_OPERATION_ACTION_CHARGE,

PAYMENT_OPERATION_ACTION_RECLAIM,

PAYMENT_OPERATION_ACTION_REFUND,

PAYMENT_OPERATION_ACTION_VOID

paymentOperation.createdAt

string<date-time>

required

Event creation timestamp.

paymentOperation.updatedAt

string<date-time>

required

Event update timestamp.

paymentOperation.payment

Payment · object

required

Detailed payment object.

Show child attributes

paymentOperation.payment.entity

string

required

Entity type, e.g., 'payment'.

paymentOperation.payment.id

string

required

Unique payment ID.

paymentOperation.payment.maxAmount

string

required

Max payment amount approved by the buyer.

paymentOperation.payment.token

string

required

Token address used.

paymentOperation.payment.networkId

integer<int32>

required

Identifier for the blockchain network.

paymentOperation.payment.payer

string

required

Payer's EVM address.

paymentOperation.payment.signature

string

required

Digital signature of the preapproved amount signed by the buyer.

paymentOperation.payment.receiver

string

required

Receiver's EVM address.

paymentOperation.payment.maxFeeBps

integer<int32>

required

Max fee in basis points.

paymentOperation.payment.minFeeBps

integer<int32>

required

Min fee in basis points.

paymentOperation.payment.feeReceiver

string

required

Fee recipient address.

paymentOperation.payment.salt

string

required

Unique salt to prevent duplicate preapproval authorizations.

paymentOperation.payment.paymentInfoHash

string

required

Hash of the payment info.

paymentOperation.payment.nonce

string

required

Nonce in the Preapproval Authorization.

paymentOperation.payment.authorizationExpiry

string<int64>

required

Expiry time for the authorization.

paymentOperation.payment.preApprovalExpiry

string<int64>

required

Expiry time for preapproval

paymentOperation.payment.refundExpiry

string<int64>

required

Expiry time for refund

paymentOperation.payment.createdAt

string<date-time>

required

Creation timestamp.

paymentOperation.payment.updatedAt

string<date-time>

required

Last update timestamp.

paymentOperation.payment.operator

string

required

Operator handling the payment.

paymentOperation.payment.contractAddress

string

required

Smart contract address of the Commerce PaymentEscrow protocol

paymentOperation.payment.authorizedAmount

string

required

Authorized payment amount.

paymentOperation.payment.capturedAmount

string

required

Captured payment amount.

paymentOperation.payment.voidedAmount

string

required

Voided payment amount.

paymentOperation.payment.refundedAmount

string

required

Refunded payment amount.

paymentOperation.payment.chargedAmount

string

required

Charged payment amount.

paymentOperation.payment.merchantId

string

required

Merchant ID.

paymentOperation.output

string

Output of the payment operation.

paymentOperation.error

string

Error of the payment operation.

paymentOperation.errorCode

string

Error code of the payment operation.

paymentOperation.revertReason

string

Blockchain revert reason of the payment operation.

paymentOperation.blockNumber

string<int64>

Block number of the payment operation.

paymentOperation.metadata

Metadata · object

Additional metadata as a free-form object.

rewardOperation

RewardOperation · object

Operation details related to a reward including transaction hash, status, and associated reward information.

Show child attributes

rewardOperation.id

string

required

Unique identifier for the reward operation.

rewardOperation.action

enum<string>

required

Type of reward operation (e.g., REWARD_OPERATION_ACTION_DISTRIBUTE).

Available options:

REWARD_OPERATION_ACTION_ALLOCATE,

REWARD_OPERATION_ACTION_DEALLOCATE,

REWARD_OPERATION_ACTION_DISTRIBUTE,

REWARD_OPERATION_ACTION_SEND

rewardOperation.status

enum<string>

required

Current status of the reward operation.

Available options:

REWARD_OPERATION_STATUS_PENDING,

REWARD_OPERATION_STATUS_SUCCEEDED,

REWARD_OPERATION_STATUS_FAILED

rewardOperation.createdAt

string<date-time>

required

Timestamp when the reward operation was created.

rewardOperation.updatedAt

string<date-time>

required

Timestamp when the reward operation was last updated.

rewardOperation.reward

Reward · object

Detailed reward object associated with this operation.

Show child attributes

rewardOperation.reward.id

string

required

Unique identifier for the reward.

rewardOperation.reward.campaignAddress

string

required

Onchain address of the campaign contract.

rewardOperation.reward.paymentInfoHash

string

required

Hash of the payment info that this reward is associated with.

rewardOperation.reward.recipientAddress

string

required

Blockchain address that will receive the reward.

rewardOperation.reward.tokenAddress

string

required

Address of the token contract used for the reward.

rewardOperation.reward.chainId

integer<int32>

required

The blockchain network identifier where the reward is processed.

rewardOperation.reward.createdAt

string<date-time>

required

Timestamp when the reward was created.

rewardOperation.reward.updatedAt

string<date-time>

required

Timestamp when the reward was last updated.

rewardOperation.amount

string

Amount involved in this reward operation.

rewardOperation.transactionHash

string

Blockchain transaction hash for this reward operation.

rewardOperation.error

string

Error message if the reward operation failed.

rewardOperation.errorCode

string

Error code of the reward operation.

rewardOperation.revertReason

string

Blockchain revert reason of the reward operation.

rewardOperation.blockNumber

string<int64>

Block number of the reward operation.

webhook

Webhook · object

Webhook configuration details.

Show child attributes

webhook.entity

string

Type of the entity, always "webhook".

webhook.id

string

Unique identifier for the webhook.

webhook.operatorCoinbaseUserId

string

Coinbase user ID of the operator this webhook belongs to.

webhook.identifier

string

External identifier for clients.

webhook.description

string

Human-readable description of the webhook's purpose.

webhook.url

string

The URL where webhook events will be sent.

webhook.events

enum<string>[]

Types of events this webhook should receive.

List of supported events.

Available options:

EVENT_TYPE_PAYMENT_AUTHORIZED,

EVENT_TYPE_PAYMENT_CAPTURED,

EVENT_TYPE_PAYMENT_VOIDED,

EVENT_TYPE_PAYMENT_REFUNDED,

EVENT_TYPE_PAYMENT_CHARGED,

EVENT_TYPE_REWARD_ALLOCATED,

EVENT_TYPE_REWARD_DISTRIBUTED,

EVENT_TYPE_REWARD_DEALLOCATED,

EVENT_TYPE_REWARD_SENT,

EVENT_TYPE_PAYMENT_RECONCILED

webhook.secret

string

Secret used for webhook signature verification.

webhook.status

enum<string>

Status of the webhook (active, inactive).

Available options:

WEBHOOK_STATUS_ACTIVATED,

WEBHOOK_STATUS_DEACTIVATED

webhook.createdAt

string<date-time>

When the webhook was created.

webhook.updatedAt

string<date-time>

When the webhook was last updated.

source

enum<string>

List of webhook sources.

Available options:

WEBHOOK_SOURCE_OPERATOR,

WEBHOOK_SOURCE_INDEXER

attempts

integer<int32>

maxRetries

integer<int32>

apiVersion

string

createdAt

string<date-time>

deliveredAt

string<date-time>

metadata

object

Get webhook events by reward operation ID

Get webhook deliveries by event ID

⌘I

PAYMENT ACCEPTANCE

Authorizations

Path Parameters

Response