> ## 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.

# Paddle

> Kết nối tài khoản hoá đơn chèo thuyền; chuẩn bị sản phẩm, cửa sổ thanh toán và thiết lập móc.

![Paddle logo](https://mintcdn.com/zonely-a8cd49e7/RhT7oGMq-hyCnspk/images/payments/merchant-providers-20261028/paddle.png?fit=max\&auto=format\&n=RhT7oGMq-hyCnspk\&q=85\&s=21ab32157f5b7d4233669ae9cfe4d085)

Bạn có thể nhận được một lần thanh toán với Paddle Cửa sổ thanh toán mở bởi Paddle và sắp xếp hóa đơn bán hàng của khách hàng. kiểm tra tài khoản của bạn, địa chỉ trang web và sản phẩm bạn bán cho sử dụng trực tiếp Paddle.

> [!NOTE]
>
> `transaction_checkout_not_enabled` Lỗi ngụ ý tính năng đăng ký trong bạn Paddle Tài khoản chưa được mở. Hãy kiểm tra tình trạng chứng thực của tài khoản từ đó. Paddle và sống trên tàu.

## MoR (Merchant of  record) Mô hình và sự bảo đảm

Paddle Đạo luật, ngành kinh doanh hàng đầu thế giới **Bán hàng đã đăng ký (Merchant of  record - MoR)** Một trong những cơ sở hạ tầng:

* **Chính thức là bán hàng Paddle.com:** Khi người chơi nhận được tín dụng hay sản phẩm, bạn có thể trực tiếp bán hóa đơn PaddleTrung tâm thương mại Central City đang chỉnh sửa. VAT (VAT) và doanh thu bị gián đoạn theo quốc gia của người mua là tài chính của quốc gia này.
* **Dễ dàng cho mỗi nhà phát triển:** Người sở hữu máy phục vụ không cần phải cắt một e-bill hoặc thiết lập một công ty cho mỗi bán.
* [Paddle](https://www.paddle.com/help/start/account-verification/what-is-account-verification): Khả năng sử dụng dịch vụ và nhận tiền phụ thuộc vào quốc gia được hỗ trợ và việc nhà cung cấp phê duyệt tài khoản. Trước khi mở bán, hãy kiểm tra yêu cầu xác minh và điều khoản của tài khoản.

## Khu vực đăng ký

| Zonely Area | Information to enter |
| - | - |
| **API Key** | Your live account `pdl_live_apikey_` Starting with the server API key. |
| **Product ID** | Of the product `pro_` Starting ID. Price ID is not used. |
| **Webhook Secret** | Paddle notification link `pdl_ntfset_` Secret key value starting with. |
| **Client-side Token** | Your live account `live_` with the starting browser switch. |
| **Environment** | For actual collection **live** Select. |

[![API Key, Product ID, Webhook Secret, Client-side Token, Environment](https://mintcdn.com/zonely-a8cd49e7/vqU0BjGNyRJAfyxV/images/panel/payments-connections-site-guide-20261027/pay-paddle-vi.png?fit=max\&auto=format\&n=vqU0BjGNyRJAfyxV\&q=85\&s=aa15d839fb520c6d95419956aa0bd984)](https://docs.zonely.gen.tr/images/panel/payments-connections-site-guide-20261027/pay-paddle-vi.png)

> [card] 1. Khóa ADI
>
> Nhập phím pdl live  apikey  từ tài khoản trực tiếp của bạn.

> [card] ID sản xuất 2.
>
> Nhập ID bắt đầu với pro  của sản phẩm.

> [card] 3 Webok Secret
>
> Nhập vào giá trị phím pdl  ttset  Bí mật của liên kết thông báo chèo.

> [card] 4 khách hàng- bên Token
>
> Nhập khách hàng- bên Token, bắt đầu với trực tiếp  của tài khoản trực tiếp của bạn.

> [card] Môi trường 5.
>
> Chọn Sống để thực sự sưu tập.

> [!NOTE]
>
> Các sản phẩm, địa chỉ thông báo và API Chuyển đổi trực tiếp (sống) và thử nghiệm môi trường trên mái chèo hoàn toàn độc lập với nhau. Paddle Quản lý bảng để tạo tập hợp thật và đang ở Zonely bảng điều khiển **sống** Đảm bảo môi trường được chọn.

## 1. Định nghĩa liên kết thanh toán mặc định (Default Payment Link)

Xác định tên miền mặc định để khớp với cửa sổ thanh toán Paddle với nơi Mạng của bạn:

1. **Trả phòng** Mở đầu trang **Cấu hình kiểm tra** lên trang giấy.

[![Checkout → Checkout configuration Menu](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-01a-checkout-config-vi.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=55bfd4a0c04d9f1ae3fceae2a1e3bf7a)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01a-checkout-config-vi.png)

> [card] 1. Cấu hình kiểm tra
>
> Mở trang cấu hình kiểm tra từ trình đơn trái.

2. **Thiết lập** Đã xác định trên thẻ **Liên kết thanh công cụ mặc định** vào địa chỉ thông báo của trang web **Lưu** Lưu với:
   ```txt theme={"theme":"css-variables"}
   https://siteniz.com/process/paddle
   ```

[![Default payment link (https://siteniz.com/process/paddle) and Save Button](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-01b-default-payment-link-vi.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=e5009d4394b54a1fc801680b407802c5)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-01b-default-payment-link-vi.png)

> [card] 1. Liên kết thanh công
>
> `https://siteniz.com/process/paddle` Lưu địa chỉ.

## Sống sót API Nhận lệnh khóa và khách hàng- bên

Chuẩn bị những giá trị và giá trị để giao tiếp với trang web của bạn Paddle API và mở cửa sổ thanh toán:

1. Dưới thực đơn bên trái của mái chèo **Thiết lập** Mở và mở phần **DEVELOPER TOOLS** Từ **In ấn** Nhấn vào trang đó.

[![DEVELOPER TOOLS → Authentication Menu](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-02-authentication-menu-vi.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=d5fe3839986ce679f42da3ad494413c2)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-02-authentication-menu-vi.png)

> [card] Xác thực 1.
>
> Chuyển sang mục Nhà phát triển: Công cụ Xác thực Trình nền

2. Hàng trên trang **Khóa API mới** Ấn vào nút đi.
3. 3, đưa chìa khóa trong tờ đơn đăng ký (v. d. `Zonely`).
4. **Hạn sử dụng** để giữ phím hoạt động trong trường học **Không bao giờ tuyệt vời** Chọn lựa đi.

[![Name (Zonely), Expires at (Never Expires)](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-03-new-api-key-vi.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=065c775889e6ae2f362d6f9f8e875ec3)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-03-new-api-key-vi.png)

> [card] 1. Tên phím
>
> Cho bạn biết tên phím Zonely.

> [card] 2 Không bao giờ bỏ bớt
>
> Chọn Không bao giờ hết hạn cho hiệu lực thời gian không có thời gian của bạn.

5. **Thẻ** trong phần **Tất cả** Tìm nhóm người đó, để bắt đầu thanh toán và xác nhận các mệnh lệnh. **Đọc nhiều hơn** và **Chữ hoa AaUpper** Kiểm tra cả hai quyền hạn và giữ lại công tắc.

[![Permissions (All), Authors (Read and write)](https://mintcdn.com/zonely-a8cd49e7/4rGhtNph-21zLYCd/images/panel/paddle-20261028/paddle-04-permissions-all-vi.png?fit=max\&auto=format\&n=4rGhtNph-21zLYCd\&q=85\&s=91fcd602792821230d5cda7d4eba3cc5)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-04-permissions-all-vi.png)

> [card] 1. Nhóm tác quyền: Tất cả
>
> Chọn tất cả đường dây cho phép.

> [card] 2. Đọc và ghi
>
> Đọc và lưu hai hộp nhỏ bằng cách đánh dấu.

6. Sống sót API Phím từ cửa sổ đến màn hình (`pdl_live_apikey_...`) Sao chép và sao chép trong Zonely Bảng quản lý **Khóa API** Dán nó trên cánh đồng.

[![Copy Live API Key (pdl\_live\_apikey\_...)](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-05-copy-api-key-vi.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=5fa38b328fd3bf0cebca2cc7ed67fc6b)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-05-copy-api-key-vi.png)

> [card] Bản sao khoá ADI
>
> `pdl_live_apikey_` Dán bảng điều khiển bằng cách sao chép các phím bắt đầu với.

7. **In ấn** trang từ trang đầu **Hiệu ứng bên khách** Nhấn vào trang đó.

[![Client-side tokens Tab](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-06-client-side-token-vi.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=1fb04ed70edd919a55ec9f34caee9d6d)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-06-client-side-token-vi.png)

> [card] 1. vật thể phụ khách
>
> Từ trên bảng điều khiển đến vùng biểu tượng bên khách hàng.

8. 8, 3 điểm ở bên phải của bảng hiệu hoạt động trong danh sách (`...`) Mở và mở trình đơn **Chép** Ấn vào nút đi. `live_` Bắt đầu khoá trình duyệt bằng Zonely trong bảng quản lý của bạn **Phần mềm khách hàng** Dán nó trên cánh đồng.

[![Copy Live Token with Copy token Option](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-06b-copy-token-vi.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=6e2e6c5781a826487217195f53f7ebeb)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-06b-copy-token-vi.png)

> [card] 1.
>
> Sao chép biểu tượng trực tiếp với tùy chọn hiệu sao chép từ thực đơn 3 điểm.

## Sản phẩm sáng tạo và xác định giá trị sản phẩm

Một sản phẩm nên được tạo ra để bắt đầu thanh toán Paddle Cơ sở hạ tầng và ID của sản phẩm này (**ID sản phẩm**Nên được lấy:

1. thực đơn trái **Catalog** Dưới đầu trang **Nhà** Nhấn vào trang đó.

[![Catalog Menu and Products Tab](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-07-catalog-products-vi.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=b408582a0ed938e57f649879fe035f2d)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-07-catalog-products-vi.png)

> [card] 1. Trình đơn sản xuất
>
> Tới trang sản phẩm của Catalog từ thực đơn trái.

2. **+ sản phẩm mới** Ấn vào nút đi.
3. Điền thông tin về sản phẩm vào mẫu xuất hiện:
   * **Tên sản phẩm:** Hãy nhập tên sản phẩm (v. d. `Kredi`).
   * **Loại thuế:** Cho sản phẩm số `Standard digital goods` Chọn loại.

[![Product name (Kredi), Tax category (Standard digital goods)](https://mintcdn.com/zonely-a8cd49e7/8EH289u0ry2LVncN/images/panel/paddle-20261028/paddle-08-new-product-vi.png?fit=max\&auto=format\&n=8EH289u0ry2LVncN\&q=85\&s=a4672d0a661fe46a04778595200ab51f)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-08-new-product-vi.png)

> [card] 1. Tên sản xuất
>
> Tên sản phẩm `Kredi` Nhập nó như

> [card] Phân loại thuế
>
> `Standard digital goods` Chọn loại.

4. **Lưu** Lưu sản phẩm bằng cách bấm cái nút.

[![Save Button to Save Your Product](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-08b-save-product-vi.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=7030a99deac80ac48d43673a2b5615aa)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-08b-save-product-vi.png)

> [card] 1.
>
> Ấn nút Lưu để lưu sản phẩm.

5. Được xác định trong trang chi tiết của sản phẩm được tạo ra `pro_` Bắt đầu với **ID sản phẩm** Sao chép giá trị và sao chép giá trị vào Zonely Bảng quản lý **ID sản phẩm** Dán vào hộp.

[![Product ID (pro\_...) Copy](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-09-product-id-vi.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=9c2d99d8fac22e75500d6fd19bf62fce)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-09-product-id-vi.png)

> [card] 1. Bản sao ID sản xuất
>
> `pro_` sao chép ID sản phẩm bắt đầu với.

## Cấu hình thông báo về trình điều khiển web

Mở đăng ký bàn điều khiển web trên Paddle bảng điều khiển để ngay lập tức chuyển khoản thanh toán vào trang web của bạn:

1. Xác định trong thực đơn trái của mái chèo **Tin tức** Dưới đầu trang **Tin tức** Nhấn vào trang đó.

[![Events Menu and Notifications Tab](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-10-notifications-menu-vi.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=cc6f474a8824e233c2241312d4b5795f)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-10-notifications-menu-vi.png)

> [card] 1. Thông báo
>
> Trình thông báo mở  từ trình đơn các sự kiện.

2. **Điểm đến mới** Ấn vào nút đi.
3. Hãy điền vào thiết lập thông báo:
   * **Kiểu thông báo:** **móc câu** Hãy xem lựa chọn.
   * **URL:** Nhập địa chỉ thông báo của trang web:
     ```txt theme={"theme":"css-variables"}
     https://siteniz.com/process/paddle
     ```
   * **Mô tả:** Viết mô tả mục tiêu này (v. d.... `Server`).

[![Notification type (Webhook), Endpoint URL (https://siteniz.com/process/paddle), Description](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-11-new-destination-vi.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=e1f59c2225f2976a8bacf679f3379aa8)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-11-new-destination-vi.png)

> [card] 1. Kiểu thông báo
>
> Kiểm tra lựa chọn Webok.

> [card] 2. Kết thúc URL
>
> `https://siteniz.com/process/paddle` gõ địa chỉ.

> [card] 3. Mô tả
>
> Hãy nhập mô tả cho máy phục vụ của bạn.

4. **Kiểu sử dụng** trình đơn **Nền** Chọn đi.
5. **Tin tức** Để đảm bảo rằng nơi Mạng của bạn đã hoàn thành và hoàn thành phong trào tài khoản **Tất cả** Đánh dấu và giữ mục tiêu.

[![Usage type (Platform), Events (All)](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-12-events-all-vi.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=76bdf084a3f8a82bd95aa8e996227e61)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-12-events-all-vi.png)

> [card] 1. Kiểu sử dụng
>
> Chọn nền tảng.

> [card] Tất cả
>
> Đánh dấu ô này để xem mọi sự kiện thông báo.

6. Nhấn vào mục tiêu đã tạo ra **Tin tức** Enter tùy chọn.
7. 7 Trong cửa sổ mở `pdl_ntfset_` Bắt đầu với **Bí mật** Sao chép giá trị và sao chép giá trị vào Zonely Bảng quản lý **Bí mật kiểu Webok** Dán vào hộp.

[![Secret key (pdl\_ntfset\_...)](https://mintcdn.com/zonely-a8cd49e7/Y7EvK_1wXxolqufi/images/panel/paddle-20261028/paddle-13-secret-key-vi.png?fit=max\&auto=format\&n=Y7EvK_1wXxolqufi\&q=85\&s=31d65a05d6154efc342ac517e215b76b)](https://docs.zonely.gen.tr/images/panel/paddle-20261028/paddle-13-secret-key-vi.png)

> [card] 1.
>
> `pdl_ntfset_` Dán trường bí mật Webok bằng cách sao chép chìa khóa bắt đầu từ.

## Kết nối thông báo thanh toán

Thành tích thanh toán **Sửa** với mở và **Gọi lại URL** Chép tất cả các địa chỉ. URL khu vực của thông báo bạn tạo ra trong Paddle với địa chỉ đầy đủ này. **Bí mật** giá trị trong Zonely **Bí mật kiểu Webok** Phải đăng ký ở hiện trường.

> [!TIP]
>
> **Khóa API** có **Phần mềm khách hàng** khác. Đừng ghi máy phục vụ API Phím vào trường khóa trình duyệt. Bảng quản lý **Kết nối thử ra** Cái nút này xác nhận sản phẩm và API Truy cập.

Liên kết này là cho một lần thu tiền được chuẩn bị theo thứ tự và thuế bao gồm. **Lưu trả tiền** Theo hướng đó.

[Payments](https://docs.zonely.gen.tr/vi/guides/payments.md)


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