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). Liên hệ với chúng tôi nếu bạn cần trợ giúp.
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.Dodo Payments PCI DSS Attestation of Compliance (AOC)
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.
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 |
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.Bước 1: Tạo khóa API
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.
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).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.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.
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).
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.
Câu hỏi thường gặp
What is the HMAC key for?
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.
I lost my API key or HMAC key, what now?
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.
Do test and live use the same credentials?
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.