Adyen

Adyen là một công ty Hà Lan cung cấp một số phương thức thanh toán trực tuyến.

Ghi chú

Adyen chỉ làm việc với khách hàng xử lý hơn 10 triệu hàng năm hoặc lập hóa đơn tối thiểu 1.000 giao dịch mỗi tháng.

Cấu hình

Tab Thông tin đăng nhập

SotaFMS cần Thông tin Xác thực API của bạn để kết nối với tài khoản Adyen của bạn, bao gồm:

  • Tài khoản Thương nhân: Mã của tài khoản thương nhân để sử dụng với Adyen.

  • Khóa API: Khóa API của người dùng dịch vụ web.

  • Khóa Khách hàng: Khóa khách hàng của người dùng dịch vụ web.

  • HMAC Key: Khóa HMAC của webhook.

  • URL API Thanh toán: Đây là URL cơ sở cho các điểm cuối API Thanh toán.

  • Đường dẫn API Định kỳ: Đường dẫn cơ sở cho các điểm cuối API Định kỳ.

Bạn có thể sao chép thông tin đăng nhập từ tài khoản Adyen của mình, và dán chúng vào các trường liên quan dưới tab Credentials.

Quan trọng

Nếu bạn đang thử nghiệm Adyen với một tài khoản kiểm tra Adyen, hãy đi đến Tài khoản ‣ Cấu hình ‣ Nhà cung cấp thanh toán. Ở đó, nhấp vào Adyen, bật chế độ Chế độ Kiểm tra và nhập thông tin đăng nhập vào tab Thông tin đăng nhập.

Khóa API và Khóa Khách hàng

Để lấy API Key và Client Key, đăng nhập vào tài khoản Adyen của bạn, đi đến Developers ‣ API Credentials.

  • Nếu bạn đã có một người dùng API, hãy mở nó.

  • Nếu bạn chưa có người dùng API, hãy nhấp vào Tạo thông tin đăng nhập mới.

Đi đến Cài đặt máy chủ ‣ Xác thực và sao chép hoặc tạo Khóa API của bạn. Hãy cẩn thận khi sao chép khóa API của bạn vì bạn sẽ không được phép lấy lại sau này mà không cần tạo một khóa mới.

Bây giờ, hãy đi đến Cài đặt khách hàng ‣ Xác thực và sao chép hoặc tạo Khóa Khách hàng của bạn. Đây cũng là nơi mà bạn có thể cho phép thanh toán được thực hiện từ trang web của bạn.

Khóa HMAC

Để lấy được Khóa HMAC, bạn cần cấu hình một webhook Thông báo Tiêu chuẩn. Để làm điều này, đăng nhập vào tài khoản Adyen của bạn sau đó đi đến Developers ‣ Webhooks ‣ Add webhook ‣ Add Standard notification.

Cấu hình một webhook.

Ở đó, trong General ‣ Server configuration ‣ URL, nhập địa chỉ máy chủ của bạn tiếp theo là /payment/adyen/notification.

Nhập URL thông báo.

Sau đó nhập Security ‣ HMAC Key ‣ Generate. Hãy cẩn thận sao chép key vì bạn sẽ không được phép làm điều đó sau này mà không cần tạo mới một key khác.

Tạo một khóa HMAC và lưu nó.

Bạn phải lưu webhook để hoàn tất quá trình tạo ra nó.

Đường dẫn API

Tất cả các URL API của Adyen đều bao gồm một tiền tố cụ thể cho khu vực khách hàng được tạo bởi Adyen. Để cấu hình các URL, tiến hành như sau:

  1. Đăng nhập vào tài khoản Adyen của bạn, sau đó đi đến Developers ‣ API URLs.

  2. Sao chép Tiền tố cho khu vực Khách hàng trực tiếp của bạn (ví dụ, trung tâm dữ liệu) và lưu lại cho sau này.

    Sao chép tiền tố cho các API của Adyen
  3. Trong SotaFMS, điều hướng đến nhà cung cấp thanh toán Adyen.

  4. Trong trường Checkout API URL, nhập URL sau và thay thế yourprefix bằng tiền tố bạn đã lưu trước đó: https://yourprefix-checkout-live.adyenpayments.com/checkout

  5. Trong trường Recurring API URL, nhập URL sau và thay thế yourprefix bằng tiền tố bạn đã lưu trước đó: https://yourprefix-pal-live.adyenpayments.com/pal/servlet/Recurring.

Ghi chú

Nếu bạn đang thử nghiệm Adyen, bạn có thể sử dụng các URL sau đây thay vì:

  • Đường dẫn API thanh toán: https://checkout-test.adyen.com

  • Đường dẫn API Định kỳ: https://pal-test.adyen.com/pal/servlet/Recurring

Tài khoản Adyen

Cho phép thanh toán từ một nguồn cụ thể

Để cho phép thanh toán được khởi tạo từ trang web của bạn, hãy tuân theo các bước trong Khóa API và Khóa Khách hàng để điều hướng đến người dùng API của bạn và chọn Thêm nguồn gốc được phép, sau đó thêm các URL từ nơi thanh toán sẽ được thực hiện (các URL của các máy chủ chứa các phiên bản SotaFMS của bạn).

Cho phép thanh toán được khởi xướng từ một miền cụ thể.

Đặt một lệnh cấm sử dụng thẻ

Adyen cho phép bạn thu một số tiền một cách thủ công thay vì tự động thu ngay lập tức.

Để thiết lập nó, bật tùy chọn Capture Amount Manually trên SotaFMS, như được giải thích trong tài liệu cung cấp thanh toán.

Sau đó, mở tài khoản Thương gia Adyen của bạn, đi đến Tài khoản ‣ Cài đặt, và đặt Độ trễ Capture thành thủ công.

Cài đặt Độ trễ Chụp trong Adyen

Cảnh báo

  • Nếu bạn cấu hình SotaFMS để ghi lại số tiền một cách thủ công, hãy đảm bảo đặt Độ Trễ Ghi Lại thành thủ công trên Adyen. Nếu không, giao dịch sẽ bị chặn ở trạng thái đã được ủy quyền trong SotaFMS.

  • SotaFMS vẫn chưa hỗ trợ việc ghi nhận một phần. Hãy nhớ rằng nếu bạn thực hiện việc ghi nhận một phần từ giao diện của Adyen, SotaFMS sẽ xử lý nó như là một ghi nhận đầy đủ.

Ghi chú

Sau 7 ngày, nếu giao dịch vẫn chưa được xác nhận, khách hàng có quyền rút lại nó.