> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Coinbase

> Cryptocurrency payments with Coinbase Commerce: API key, webhook URL and shared secret installation steps.

![Coinbase logo](https://mintcdn.com/zonely-a8cd49e7/OWL-tSwzP6Edx1KZ/images/doc-icons/odemeler--coinbase.png?fit=max\&auto=format\&n=OWL-tSwzP6Edx1KZ\&q=85\&s=d79c404a973f399269c6de0a1504ab67)

Coinbase payment method, **Coinbase Trading** Using its infrastructure, it allows you to load automatic balance with popular crypto coins such as Bitcoin, Ethereum, Litecoin and USDT on your website.

Coinbase payment registration **Secret Key** and **Webhook Key** The areas belong to the Commerce connection. Coinbase Business and CDP use different forms of API and authentication.

## Registration areas

| Zonely Area | Information to enter |
| - | - |
| **Secret Key** | API key generated from Coinbase Commerce panel (`Settings → Security`). |
| **Webhook Key** | Shared secret key used to verify notification signatures (`Webhook Shared Secret`). |

[![Hidden Key, Webhook Key](https://mintcdn.com/zonely-a8cd49e7/iIpHL9lTqM3E1w0D/images/panel/payments-connections-site-guide-20261027/pay-coinbase-en.png?fit=max\&auto=format\&n=iIpHL9lTqM3E1w0D\&q=85\&s=1ab60334ad8ec791d65c2f015ae19038)](https://docs.zonely.gen.tr/images/panel/payments-connections-site-guide-20261027/pay-coinbase-en.png)

> [card] 1. Hidden Key
>
> Enter the API key you created on the Coinbase Commerce panel.

> [card] 2. Webhook Key
>
> Enter the Shared Secret key you receive for Coinbase notifications.

## 1. Creating API Key (Gizli Key)

Login to Coinbase Commerce panel and create your API key:

1. From left menu or upper **Settings** to the page.
2. Top tabs **News** Click on the tab.
3. **API Keys** located in the right of the card **New API Key** Click on the button.
4. Copy the generated API key to a safe location and copy it to your Zonely management panel **Secret Key** Paste in the box.

[![New API Key (Create New API Key)](https://mintcdn.com/zonely-a8cd49e7/Ch8HjYnwA0dGeANI/images/panel/coinbase-20261028/coinbase-01-create-api-key-en.png?fit=max\&auto=format\&n=Ch8HjYnwA0dGeANI\&q=85\&s=43f58b6fa8ec8bb7f7e504067938fa85)](https://docs.zonely.gen.tr/images/panel/coinbase-20261028/coinbase-01-create-api-key-en.png)

> [card] 1. New API key
>
> Click the button to produce a new Commerce API key.

## 2. Add Webhook Endpoint

A webhook endpoint should be defined to get instant access to your website:

1. **Settings** Under menu **News** Click on the tab.
2. Bottom of the page **Webhook subscriptions** located in the section **Add an endpoint** Click on the button.

[![Add an endpoint (Add Endpoint)](https://mintcdn.com/zonely-a8cd49e7/Ch8HjYnwA0dGeANI/images/panel/coinbase-20261028/coinbase-02-add-endpoint-en.png?fit=max\&auto=format\&n=Ch8HjYnwA0dGeANI\&q=85\&s=03455396746b2a8ba8573d3ae270d523)](https://docs.zonely.gen.tr/images/panel/coinbase-20261028/coinbase-02-add-endpoint-en.png)

> [card] 1. Add an endpoint
>
> Click to open the new notification address insert window.

## 3. Webhook Notification Address Definition

Close **New Webhook Subscription** modal window:

1. Enter your site Coinbase payment route in the notification URL field:
   ```txt theme={"theme":"css-variables"}
   https://siteniz.com/process/coinbase
   ```
2. **Save** Confirm the address by pressing the button.

[![Webhook Notification Address (https://siteniz.com/process/coinbase), Save (Save)](https://mintcdn.com/zonely-a8cd49e7/Ch8HjYnwA0dGeANI/images/panel/coinbase-20261028/coinbase-03-webhook-url-en.png?fit=max\&auto=format\&n=Ch8HjYnwA0dGeANI\&q=85\&s=8557eb7cfe25b0d17dd0cd2be5d79a95)](https://docs.zonely.gen.tr/images/panel/coinbase-20261028/coinbase-03-webhook-url-en.png)

> [card] 1. Notification Address
>
> `https://siteniz.com/process/coinbase` Type the route.

> [card] 2. Save
>
> Click to complete the Webhook registration.

## 4. Receiving Webhook Hidden Key (Shared Secret)

1. Webhook endpoint appears in the list after successfully added.
2. Top right of the Webhook subscriptions card **Show shared secret** Click on the button.

[![Show shared secret (Show The Hidden Key That Be Paid)](https://mintcdn.com/zonely-a8cd49e7/Ch8HjYnwA0dGeANI/images/panel/coinbase-20261028/coinbase-04-show-shared-secret-en.png?fit=max\&auto=format\&n=Ch8HjYnwA0dGeANI\&q=85\&s=ae694609ac8960d1883938293a4f3bf1)](https://docs.zonely.gen.tr/images/panel/coinbase-20261028/coinbase-04-show-shared-secret-en.png)

> [card] 1. Show shared secret
>
> Click to view the hidden webhook signature key.

3. Close **Webhook Shared Secret** Click the copy button next to the hidden key in the window.
4. The value you copied in your Zonely management panel **Webhook Key** Paste it in the field and save the payment method.

[![Copy (Shared Secret Key)](https://mintcdn.com/zonely-a8cd49e7/YdDD-t3g9PL9hocm/images/panel/coinbase-20261028/coinbase-05-copy-shared-secret-en.png?fit=max\&auto=format\&n=YdDD-t3g9PL9hocm\&q=85\&s=03383ec948b2145ab2a9cc447dd355e6)](https://docs.zonely.gen.tr/images/panel/coinbase-20261028/coinbase-05-copy-shared-secret-en.png)

> [card] 1. Copy
>
> Click to copy the shared secret key to the clipboard.

## Trade and Business difference

Coinbase runs the Trading service as a separate integration to Business. CDP API key ID does not convert the link to paste JWT key or Business webhook subscription ID into areas. With the API that your account uses, you need to have the same product on the site’s payment link.

[Coinbase’s Commerce → Business migration description](https://help.coinbase.com/en/transitioning-from-coinbase-commerce-to-coinbase-business)tells the current steps about the account and transaction history.

## Transaction history

Previous transactions **Store → Payments** Check the transaction number, amount and status in the section. Match the transaction record on the provider side with the same number.

[Payment records and history](https://docs.zonely.gen.tr/en/guides/payment-gateways.md) · [Payment methods](https://docs.zonely.gen.tr/en/payments/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.