Kết nối PayPal để nhận donate từ nước ngoài

Chuẩn bị

• Một tài khoản PayPal Business. Tài khoản cá nhân có thể nâng cấp miễn phí tại paypal.com.
• Tài khoản VTPay đã có trang donate. Chưa có thì xem cách tạo trang nhận donate.
• Khoảng 5 phút.

Bước 1: Mở Apps & Credentials trên PayPal Developer

1. Vào developer.paypal.com và đăng nhập bằng tài khoản PayPal Business.
2. Ở góc trên bên trái, chọn Live (hoặc Sandbox nếu muốn thử trước).
3. Bấm mục Apps & Credentials ở menu trái, rồi bấm nút đen Create App ở góc trên bên phải.

Bước 2: Tạo app

Đặt tên app, ví dụ VTPay donate, rồi bấm Create App.

Bước 3: Copy Client ID và Secret

Mở app vừa tạo. Bấm biểu tượng copy cạnh Client ID và cạnh Secret key 1.

Secret giống như mật khẩu: không gửi cho ai, không dán vào nhóm chat. Chỉ dán vào ô Kết nối PayPal trên vtpay.vn.

Bước 4: Kết nối PayPal trên VTPay

1. Trên VTPay, mở menu Donate cho người nước ngoài (trong phần Cài đặt Donate).
2. Ở ô Kết nối PayPal, chọn chế độ Live (hoặc Sandbox nếu bạn lấy mã Sandbox).
3. Dán Client ID và Secret, rồi bấm Kết nối PayPal.
4. Thành công sẽ hiện chấm xanh Đã kết nối kèm dòng "Đã đăng ký thông báo (webhook) với PayPal".

Secret được mã hoá ngay khi lưu và không bao giờ hiện lại.

Bước 5: Bật nhận donate PayPal

1. Bật công tắc Nhận donate từ người nước ngoài (PayPal).
2. Đặt Số tiền tối thiểu (USD), từ $1 đến $1.000.
3. Bấm Cập nhật ở dải dưới cùng, góc phải.

Trang donate của bạn sẽ có thêm tab Donate (nước ngoài): người xem nhập số USD, viết lời nhắn và thanh toán bằng nút PayPal hoặc thẻ.

Kiểm tra webhook (tự có, không cần thêm)

VTPay tự đăng ký webhook trên app PayPal của bạn khi kết nối. Muốn kiểm tra: mở lại app trên developer.paypal.com, kéo xuống mục Live Webhooks (hoặc Sandbox Webhooks), sẽ thấy dòng https://vtpay.vn/api/v1/webhooks/paypal với 5 sự kiện.

Thử bằng tiền ảo (Sandbox)

1. Trên developer.paypal.com chọn Sandbox, tạo app như bước 1–3 để lấy mã Sandbox.
2. Trên VTPay chọn chế độ Sandbox, dán mã Sandbox và kết nối.
3. Lấy tài khoản người mua thử ở Testing Tools → Sandbox Accounts (dòng Personal).
4. Mở trang donate của bạn, tab Donate (nước ngoài), donate $5 bằng tài khoản người mua thử.
5. Thành công khi: trang hiện Donate Thành Công, OBS hiện thông báo $5, Lịch sử donate có nhãn PayPal.

Thử xong, Gỡ kết nối rồi kết nối lại bằng mã Live để nhận tiền thật.

Cần biết

• Phí PayPal cho giao dịch quốc tế và phí đổi tiền khi rút về VND do bạn chịu, theo biểu phí của PayPal. Phí dịch vụ VTPay tính như donate thường — xem Phí dịch vụ.
• Người donate có thể khiếu nại hoặc hoàn tiền qua PayPal; khi đó Lịch sử donate hiện nhãn "PayPal · đã hoàn tiền" hoặc "PayPal · đang khiếu nại".
• Tài khoản PayPal mới có thể bị PayPal tạm giữ tiền ở những giao dịch đầu.
• Muốn dừng nhận donate PayPal: tắt công tắc rồi bấm Cập nhật. Muốn đổi tài khoản PayPal: Gỡ kết nối rồi kết nối mã mới.