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

# Adyen - Truy cập API Kết nối & Raw Card

> Tạo khóa API, tài khoản merchant, và webhook ký HMAC bạn cần để kết nối Adyen như bộ xử lý riêng của bạn với Bring Your Own Processor (BYOP).

<Note>
  Hướng dẫn này áp dụng khi bạn kết nối **Adyen** như bộ xử lý riêng thông qua [Bring Your Own Processor (BYOP)](/features/byop). [Liên hệ với chúng tôi](mailto:founders@dodopayments.com) nếu bạn cần trợ giúp.
</Note>

## Kích hoạt truy cập dữ liệu thẻ nguyên bản

Trước khi Dodo có thể định tuyến thanh toán thông qua Adyen, tài khoản Adyen của bạn cần được kích hoạt **truy cập dữ liệu thẻ nguyên bản**. Adyen yêu cầu điều này đằng sau việc tuân thủ PCI DSS. Vì **Dodo Payments xử lý dữ liệu thẻ nguyên bản thay cho bạn** và tuân thủ **PCI DSS Cấp độ 1**, bạn cung cấp **Dodo Payments' Attestation of Compliance (AOC)** cho Adyen — bạn không cần chứng nhận của riêng mình.

<Card title="Dodo Payments PCI DSS Attestation of Compliance (AOC)" icon="file-shield" href="https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf">
  Tải về AOC hiện tại của Dodo Payments và gửi nó tới hỗ trợ của Adyen để kích hoạt truy cập dữ liệu thẻ nguyên bản.
</Card>

Liên hệ hỗ trợ của Adyen để yêu cầu truy cập thẻ nguyên bản cho tài khoản merchant của bạn, đính kèm AOC ở trên.

## Những gì bạn sẽ cần

Để kết nối Adyen trong **Cài đặt → BYOP**, thu thập ba giá trị từ Khu vực Khách hàng của bạn trên Adyen:

| Giá trị              | Nguồn gốc                                          |
| -------------------- | -------------------------------------------------- |
| **API key**          | Developers → API credentials                       |
| **Merchant Account** | Mã định danh tài khoản merchant của bạn trên Adyen |
| **HMAC key**         | Được tạo khi bạn thiết lập webhook                 |

<Info>
  Adyen giữ riêng các thông tin xác thực **test** (`ca-test.adyen.com`) và **live** (`ca-live.adyen.com`). Tạo thông tin xác thực trong môi trường phù hợp với chế độ bạn đang cấu hình trong Dodo.
</Info>

## Bước 1: Tạo khóa API

<Steps>
  <Step title="Open API credentials">
    Trong Khu vực Khách hàng của Adyen, đi tới **Developers → API credentials**. Bạn cần quyền **Quản lý API credentials** hoặc **Quản trị viên Merchant**.
  </Step>

  <Step title="Select your credential">
    Chọn thẻ **Payments** và chọn tên người dùng thông tin xác thực của bạn (nó có dạng `ws_123456@Company.YourCompanyAccount`).
  </Step>

  <Step title="Generate the key">
    Đi tới **Cài đặt máy chủ → Xác thực**, mở thẻ **API key**, và chọn **Tạo API key**.
  </Step>

  <Step title="Copy it immediately">
    Sao chép và lưu trữ khóa một cách an toàn; bạn sẽ không thể sao chép lại sau khi rời khỏi trang này. Một khóa mới tạo sẽ hoạt động ngay lập tức, và khóa cũ sẽ tiếp tục hoạt động trong 24 giờ.
  </Step>
</Steps>

## Bước 2: Tìm tài khoản merchant của bạn

**Merchant account** của bạn là mã định danh tài khoản Adyen sử dụng để xử lý các giao dịch của bạn. Nó hiển thị trong bộ chọn tài khoản ở phía trên Khu vực Khách hàng (ví dụ, `YourCompany_ECOM`). Bạn sẽ dán nó vào trường **Merchant Account** trong Dodo.

## Bước 3: Thiết lập webhook và khóa HMAC

Dodo tạo một URL **Webhook Endpoint** khi bạn lưu kết nối với Adyen. Thêm nó như một webhook trong Adyen và tạo một khóa HMAC. Bạn cần có quyền **Quản trị viên Merchant** hoặc **Kỹ thuật viên tích hợp Merchant**.

<Steps>
  <Step title="Create a webhook">
    Trong Khu vực Khách hàng, đi tới **Developers → Webhooks** và chọn **Tạo webhook mới**. Từ danh sách, chọn **Thêm** cho loại **Standard webhook**.
  </Step>

  <Step title="Configure the webhook">
    * Nhập một **Mô tả**.
    * Chuyển đổi qua **Enabled** để kích hoạt nó.
    * Dưới **Cấu hình máy chủ**, dán URL **Webhook Endpoint** mà Dodo tạo vào trường **URL** (nó phải là HTTPS và có thể truy cập công khai).
  </Step>

  <Step title="Generate the HMAC key">
    Dưới **Bảo mật**, trong phần **HMAC Key**, chọn **Tạo** để tạo một khóa HMAC mới. Sao chép nó và lưu trữ an toàn; bạn sẽ không thể sao chép lại sau này. Sau đó chọn **Lưu cấu hình**.
  </Step>

  <Step title="Paste the HMAC key into Dodo">
    Quay lại **Cài đặt → BYOP**, dán khóa HMAC vào trường **Webhook Signing Secret** để hoàn tất kết nối.

    <Card title="Set up BYOP" icon="shuffle" href="/features/byop">
      Thực hiện theo toàn bộ quy trình thiết lập Bring Your Own Processor.
    </Card>
  </Step>
</Steps>

<Tip>
  Sau khi lưu, sử dụng **Kiểm tra kết nối** trong Dodo để thực hiện một cuộc gọi thử nghiệm tới Adyen và xác nhận khóa API, tài khoản merchant và khóa HMAC của bạn là hợp lệ trước khi bạn hoạt động.
</Tip>

## Câu hỏi thường gặp

<AccordionGroup>
  <Accordion title="What is the HMAC key for?">
    Adyen ký mọi webhook với một chữ ký HMAC để người nhận có thể xác minh tính toàn vẹn và nguồn gốc của thông báo. Dodo sử dụng khóa HMAC bạn cung cấp để xác thực các webhook từ tài khoản Adyen của bạn.
  </Accordion>

  <Accordion title="I lost my API key or HMAC key, what now?">
    Cả hai đều không thể được truy xuất sau khi tạo. Tạo một khóa API mới dưới **Developers → API credentials**, hoặc một khóa HMAC mới trong cài đặt webhook, sau đó cập nhật giá trị trong **Cài đặt → BYOP**.
  </Accordion>

  <Accordion title="Do test and live use the same credentials?">
    Không. Tạo thông tin xác thực trong môi trường tương ứng, test (`ca-test.adyen.com`) hoặc live (`ca-live.adyen.com`), và cấu hình chúng trong chế độ tương ứng trong Dodo.
  </Accordion>
</AccordionGroup>

## Tham khảo

* [Adyen: API credentials](https://docs.adyen.com/development-resources/api-credentials/)
* [Adyen: Cấu hình và quản lý webhooks](https://docs.adyen.com/development-resources/webhooks/configure-and-manage)