Bật quyền truy cập dữ liệu thẻ thô
Trước khi Dodo Payments có thể định tuyến các khoản thanh toán qua Adyen, tài khoản Adyen của bạn cần có raw card data access. Adyen chỉ bật quyền này cho các thiết lập tuân thủ PCI DSS. Dodo Payments xử lý raw card data thay cho bạn và tuân thủ PCI DSS Level 1, vì vậy bạn không cần có môi trường dữ liệu thẻ riêng. Adyen vẫn yêu cầu PCI DSS Self-Assessment Questionnaire (SAQ) hoặc Attestation of Compliance của riêng bạn, trong đó nêu tên Dodo Payments tại Part 2f, cùng với Dodo Payments Attestation of Compliance (AOC).Dodo Payments PCI DSS Attestation of Compliance (AOC)
Tải xuống AOC Dodo Payments hiện tại và gửi cho bộ phận hỗ trợ Adyen để bật quyền truy cập dữ liệu thẻ thô.
Những gì bạn cần
Để kết nối Adyen trong Settings → BYOP, bạn cần ba giá trị từ Adyen Customer Area:Adyen giữ riêng thông tin xác thực test (
ca-test.adyen.com) và live (ca-live.adyen.com). Hãy tạo thông tin xác thực trong Customer Area tương ứng với chế độ Dodo Payments mà bạn đang cấu hình.Bước 1: Tạo API Key
Để tạo API key, bạn cần vai trò Manage API credentials hoặc Merchant admin trong Customer Area.1
Open API Credentials
Đăng nhập Adyen Customer Area, chọn tài khoản Company của bạn, rồi đi đến Developers → API credentials.
2
Select Your Credential
Chọn tab Payments, rồi chọn username thông tin xác thực của bạn. Username có dạng
ws_123456@Company.YourCompanyAccount.3
Generate the Key
Trong Server settings → Authentication, mở tab API key và chọn Generate API key.
4
Copy It Immediately
Chọn biểu tượng sao chép và lưu trữ key một cách an toàn. Bạn không thể sao chép lại key sau khi rời khỏi trang. Sau đó chọn Save changes. Key mới tạo sẽ có hiệu lực ngay lập tức, còn key trước đó tiếp tục hoạt động trong 24 giờ.Trong Dodo Payments, dán key vào trường Secret Key.
Bước 2: Tìm Merchant Account của bạn
merchant account của bạn là mã định danh tài khoản mà Adyen sử dụng để xử lý các giao dịch của bạn. Để tìm mã này, hãy đi đến Settings → Merchant accounts trong Customer Area, ví dụYourCompany_ECOM.
Dán mã nhận dạng vào trường Merchant Account trong Dodo Payments. Sau khi thiết lập, merchant account được lưu trữ an toàn và không thể thay đổi.
Bước 3: Thiết lập Webhook và HMAC Key
Khi bạn lưu kết nối Adyen, Dodo Payments tạo một URL Webhook Endpoint. Thêm URL này dưới dạng webhook trong Adyen, sau đó tạo HMAC key. Bạn cần vai trò Merchant admin hoặc Merchant technical integrator.1
Create a Webhook
Trong Customer Area, đi đến Developers → Webhooks và chọn Create new webhook. Trong danh sách loại webhook, chọn Add bên cạnh Standard webhook.
2
Configure the Webhook
- Nhập Description.
- Bật nút chuyển Enabled.
- Trong Server configuration, dán URL Webhook Endpoint do Dodo Payments tạo vào trường URL. URL phải sử dụng HTTPS và có thể truy cập công khai.
3
Generate the HMAC Key
Trong Security, tại phần HMAC Key, chọn Generate để tạo HMAC key mới. Sao chép key và lưu trữ an toàn. Sau đó chọn Save configuration.
4
Paste the HMAC Key into Dodo
Trong Settings → BYOP, dán HMAC key vào trường Webhook Signing Secret, rồi chọn Save & continue để hoàn tất kết nối.
Set up BYOP
Thực hiện đầy đủ quy trình thiết lập Bring Your Own Processor.
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 bằng chữ ký HMAC, để bên 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 Payments sử dụng HMAC key bạn cung cấp để xác thự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?
Bạn không thể sao chép lại API key sau khi rời khỏi trang. Để thay thế HMAC key, hãy tạo key mới trong webhook settings của Adyen. Sau đó mở Settings → BYOP, chọn Edit Configuration, chỉnh sửa kết nối Adyen, dán key vào Webhook Signing Secret, rồi chọn Save & continue.Dodo dashboard không cho phép bạn thay đổi API key đã lưu. Để thay thế key, hãy tạo key mới trong Developers → API credentials, sau đó liên hệ support@dodopayments.com để cập nhật kết nối.
Do test and live use the same credentials?
Do test and live use the same credentials?
Không. Hãy 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), rồi cấu hình chúng trong chế độ tương ứng trên Dodo Payments. Adyen cũng yêu cầu HMAC key mới khi bạn chuyển từ test sang live.