---
title: "Handle Coinbase Webhook"
method: POST
path: "/api/v1/webhooks/coinbase"
tags: ["Webhooks"]
---

# Handle Coinbase Webhook

`POST /api/v1/webhooks/coinbase`

## Request

- The document declares no server URL.
- Auth: none declared

Handle incoming Coinbase webhook events.

Supports both Payment Link API (new) and legacy Commerce Charge API formats.
Auto-detects the format based on the signature header:
- X-Hook0-Signature  → Payment Link API (payment_link.payment.*)
- X-CC-Webhook-Signature → Legacy Commerce (charge:*)

Payment Link event types:
- payment_link.payment.success: Payment completed successfully
- payment_link.payment.failed: Payment failed
- payment_link.payment.expired: Payment link expired

Legacy event types (deprecated):
- charge:confirmed: Payment confirmed

## Response `200`

Successful Response

- unknown

## Changes

- **2026-05-22** `6059f99c1875`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/changes/api/v1/webhooks/coinbase/post.md)

---

[API](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway.md) - [All operations](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/revisions/6059f99c1875?raw)