PayPal

Những gì bạn cần

Vì sao chúng tôi hỏi mỗi trường

Client ID

Nhận diện ứng dụng PayPal của bạn trên các lệnh gọi API. Nó chỉ hoạt động khi đi kèm với Client secret.

Client secret

Nửa riêng tư của xác thực API. Cùng với Client ID, nó cho phép chúng tôi tạo đơn hàng, để khoản thanh toán chạy qua tài khoản của bạn.

Webhook ID

Cách chúng tôi xác nhận một webhook thực sự từ PayPal: PayPal nhận diện mỗi webhook bằng một ID, và chúng tôi dùng nó để hỏi PayPal trực tiếp xem một thông điệp nhất định có xác thực không. Điều đó ngăn bất cứ ai giả mạo một sự kiện "đã trả tiền".

Success và Cancel URL

Cài đặt thông thường: nơi người mua đáp xuống sau khi trả tiền hoặc rút lui. Không bí mật.

Thiết lập

1. Mở bảng điều khiển PayPal Developer

   Đăng nhập tại developer.paypal.com. PayPal cung cấp cho bạn Sandbox miễn phí với các tài khoản doanh nghiệp và người mua giả, nên bạn có thể kiểm tra mà không di chuyển tiền thật. Hướng dẫn này đi theo luồng Sandbox; luồng Live giống hệt, chỉ cần chuyển nút bật/tắt Sandbox / Live (trên cùng bên trái) và dùng tài khoản PayPal for Business. Từ bảng điều khiển, mở Apps & Credentials.

   ⤢
2. Tạo một ứng dụng

   Trên trang API Credentials, xác nhận nút bật/tắt Sandbox được chọn, rồi nhấp Create App (trên cùng bên phải).

   ⤢
3. Đặt tên và chọn Merchant

   Nhập App Name (ví dụ "Coin Moebius"), để Type là Merchant, chọn tài khoản doanh nghiệp sandbox của bạn, và nhấp Create App.

   ⤢
4. Sao chép Client ID và Client secret của bạn

   PayPal mở ứng dụng mới của bạn. Sao chép Client ID và hiện rồi sao chép Secret key. (Bạn cũng có thể sao chép cả hai từ hàng Default Application trong danh sách API Credentials.) Giữ chúng lại.

   ⤢

   ⤢

   Client secret là bí mật, hãy coi nó như mật khẩu. Ứng dụng sandbox và ứng dụng live mỗi cái có một cặp riêng, nên đừng trộn chúng.

5. Thêm webhook

   Cuộn xuống trang ứng dụng đến phần Sandbox Webhooks và nhấp Add Webhook. Trong trường Webhook URL, dán địa chỉ webhook PayPal của dự án bạn (bên dưới). Rồi chọn các sự kiện mà Coin Moebius lắng nghe, và Save.

   • Thanh toán một lần: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
   • Gói đăng ký (chỉ khi bạn bán chúng): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Nếu bạn không thanh toán định kỳ, hãy bỏ qua.
   • Vội vàng? Chọn All Events (ký tự đại diện ở trên cùng) cũng được, chúng tôi bỏ qua những gì không dùng.

   https://api.coinmoebius.com/webhook/paypal/<your project id>

   ⤢

   ID dự án của bạn nằm dưới tên dự án trong bảng điều khiển Coin Moebius; điền vào địa chỉ ở trên. Thẻ nhà cung cấp đã kết nối (bước cuối) hiển thị cùng URL đó để tham khảo.

6. Sao chép Webhook ID

   Webhook của bạn giờ xuất hiện trong danh sách Sandbox Webhooks. Sao chép Webhook ID hiển thị bên cạnh nó. Đây là cách Coin Moebius hỏi PayPal để xác nhận mỗi webhook là chính xác. Đăng ký một webhook riêng ở sandbox và ở live.

   ⤢
7. Trong Coin Moebius: Thêm nhà cung cấp → PayPal

   Trong dự án của bạn, mở tab Nhà cung cấp, nhấp Thêm nhà cung cấp, chọn Kết nối dịch vụ, và chọn PayPal. Đặt Success URL và Cancel URL của bạn. Đang kiểm tra với thông tin xác thực sandbox? Dùng tab Test (tùy chọn) và dán Client ID, Client secret và Webhook ID vào đó, rồi nhấp Save. Muốn đi thẳng vào live? Dùng tab Live. Nhóm Test là tất-cả-hoặc-không-gì: cả ba trường, hoặc không trường nào.

   ⤢
8. Bạn đã kết nối

   PayPal giờ xuất hiện trên tab Nhà cung cấp với ngày kết nối (gắn nhãn TEST khi bạn dùng thông tin xác thực sandbox). Thẻ hiển thị cùng URL webhook bạn đã dán vào PayPal, cộng với Chỉnh sửa và Ngắt kết nối.

   ⤢
9. Kiểm tra với một người mua sandbox

   Để trả qua một khâu thanh toán thử nghiệm, bạn cần thông tin đăng nhập người mua sandbox. Trong PayPal, mở Testing Tools → Sandbox Accounts để xem các tài khoản Business và Personal giả của bạn.

   ⤢
10. Lấy thông tin đăng nhập người mua

    Mở tài khoản Personal (người mua) để xem Login Info: URL sandbox, email và mật khẩu. Đăng nhập tại sandbox.paypal.com bằng những thông tin đó khi một khâu thanh toán thử nghiệm yêu cầu bạn trả tiền. Không có tiền thật nào di chuyển.

    ⤢

Sau khi bạn kết nối

Chạy một khoản thanh toán thử nghiệm trước khi chạy thật:

1. Tạo một sản phẩm và đặt Môi trường của nó thành Testing. Việc đó chạy sản phẩm trên thông tin xác thực sandbox của bạn, nên bạn có thể đặt một đơn hàng đầy đủ mà không di chuyển tiền. (Nếu bạn bỏ qua bộ sandbox, một sản phẩm Testing sẽ quay về live, nên hãy thêm nó trước.)
2. Đặt nút mua lên một trang (một tệp HTML cục bộ cũng được) trỏ về dự án của bạn.
3. Hoàn tất thanh toán bằng cách trả với tài khoản người mua sandbox của bạn.
4. Mở tab Giao dịch. Một hàng mới xuất hiện, gắn nhãn Testing. Khi trạng thái của nó đạt succeeded, thông tin xác thực và webhook của bạn đều hoạt động trọn vẹn đầu cuối.

Chuyển Môi trường sản phẩm sang Live khi bạn sẵn sàng cho thanh toán thật.

Khắc phục sự cố

Bắt đầu với Xác minh. Trong bảng điều khiển, nhấp Xác minh (hoặc Xác minh thông tin xác thực thử nghiệm cho sandbox) để kiểm tra thông tin xác thực client của bạn.

Xác minh thất bại.

Sao chép lại Client ID và Client secret. Ứng dụng sandbox và ứng dụng live có các cặp khác nhau, nên đừng trộn chúng.

Thanh toán hoàn tất nhưng đơn hàng vẫn đang chờ.

Webhook ID phải đến từ cùng ứng dụng và môi trường với thông tin xác thực client của bạn. Thông tin xác thực live cần webhook id live. Xác nhận URL webhook khớp.

Xác nhận nó trọn vẹn đầu cuối.

PayPal Developer Dashboard → Webhooks Simulator: gửi một sự kiện mẫu đến URL webhook của bạn, rồi quan sát đơn hàng cập nhật.

Cần biết

Xoay secret. Tạo một client secret mới bất cứ lúc nào, rồi dán nó vào. Các trường bí mật vẫn để trống khi chỉnh sửa.

Câu hỏi? Join our Discord