Pay2S cho Easy Digital Downloads (EDD)

Nội dung Markdown đầy đủ của trang tài liệu.

# Pay2S cho Easy Digital Downloads (EDD)

Plugin riêng cho shop bán file, ebook, phần mềm bằng EDD; không cài ZIP WooCommerce vào EDD.

::: warning Bản thử nghiệm 0.1.0
Đã kiểm tra chữ ký, callback và adapter bằng dữ liệu giả lập; chưa kiểm thử đầu cuối trên shop thật. Cài ở staging để nghiệm thu trước khi dùng cho khách. Chưa hỗ trợ tự động gia hạn, hoàn tiền tự động hoặc đa cửa hàng.
:::

## Tải plugin

[Tải Pay2S EDD 0.1.0 beta](/downloads/integrations/pay2s-edd-0.1.0-beta.zip)

## Cài đặt

1. Chuẩn bị WordPress HTTPS, PHP 7.4+ và EDD 3.x; cấu hình tiền tệ VND.
2. WordPress → Plugins → Add New → Upload Plugin, chọn ZIP và kích hoạt.
3. Settings → Pay2S EDD: nhập PartnerCode, AccessKey, SecretKey và bankAccounts.
4. Downloads → Settings → Payments: bật Pay2S. Dùng tài khoản Pay2S demo để nghiệm thu. Bản này chặn EDD Test Mode, không tự giả lập thanh toán thành công.

```json
[{"bank_id":"ACB","account_number":"YOUR_ACCOUNT"}]
```

Giữ số tài khoản trong dấu nháy để không mất số 0 đầu. Có thể thêm nhiều ngân hàng theo thứ tự mong muốn.

## Luồng giao dịch

Checkout tạo đơn EDD pending và liên kết Pay2S. Khách thanh toán trên Payment Page. IPN tới `/wp-json/pay2s-edd/v1/ipn`, được kiểm tra chữ ký, merchant, gateway, mã đơn và số tiền trước khi chuyển đơn sang hoàn tất. Callback lặp không cấp lại đơn.

Khách quay về trang chờ có khóa truy cập riêng. Nếu IPN chưa tới, trang kiểm tra mỗi 2 giây trong tối đa 2 phút. Khi xác nhận xong, chuyển tới receipt EDD; link tải và license do EDD/add-on của shop cung cấp. Việc quay lại URL có `resultCode=0` không tự mở quyền tải.

## Phạm vi và nghiệm thu

Thanh toán một lần, VND nguyên. Không có recurring, auto-refund hoặc form hóa đơn điện tử trong bản này. Nếu request tạo liên kết timeout, kiểm tra đơn trước khi tạo lại. Đơn đã refunded/revoked không được tự mở lại.

Thử đơn có thuế/giảm giá, guest, tài khoản đăng nhập, link tải, callback trùng, callback sai số tiền và trường hợp redirect trước IPN. Chỉ sau nghiệm thu mới triển khai shop thật.

Tham khảo [gateway EDD](https://easydigitaldownloads.com/docs/payment-gateways/) và [source gateway mẫu chính thức](https://github.com/awesomemotive/easy-digital-downloads/blob/master/includes/gateways/manual.php).