Những gì bạn cần
| Trường | Nó làm gì |
|---|---|
| API key | Cho phép chúng tôi gọi NOWPayments để tạo khoản thanh toán. Bí mật. |
| IPN secret | Xác nhận một thông báo thanh toán thực sự đến từ NOWPayments. Bí mật. |
| Success URL / Cancel URL | Nơi người mua đáp xuống sau khi trả tiền hoặc rút lui. |
IPN (Instant Payment Notification) là tên của NOWPayments cho webhook mà họ gửi khi trạng thái thanh toán thay đổi.
Vì sao chúng tôi hỏi mỗi trường
API key
Cho phép tạo khoản thanh toán, để tiền về tài khoản của bạn.
IPN secret
Chứng minh một thông báo đến thực sự từ NOWPayments, nên không ai có thể giả mạo một sự kiện "đã trả tiền". Nó là một giá trị riêng tách khỏi API key.
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
- Kiểm tra: không có sandbox
NOWPayments không có sandbox hay môi trường thử nghiệm. Để kiểm chứng trọn vẹn đầu cuối, gửi một khoản thanh toán thật nhỏ bằng một đồng coin phí thấp và xác nhận nó xuất hiện trong bảng điều khiển của bạn. Coi khoản thanh toán nhỏ đầu tiên đó là bài kiểm tra của bạn. Một tài khoản NOWPayments là miễn phí; bạn chỉ trả phí mạng và phí dịch vụ thông thường trên các khoản thanh toán thật.
- Mở Cài đặt Thanh toán trong NOWPayments
Đăng nhập tại account.nowpayments.io và vào Settings → Payments. Màn hình này chứa ba thứ bạn cần: Payout wallets (nơi tiền về), API keys, và Instant payment notifications. Bạn sẽ lần lượt truy cập từng mục.
NOWPayments → Settings → Payments - Thêm ví thanh toán
NOWPayments chỉ mở khóa API khi bạn đã có một ví thanh toán. Trên trang Payout wallets, nhấp Add new wallet, chọn một đơn vị tiền tệ, dán một địa chỉ ví bạn kiểm soát, và nhấp Add wallet. Đây là địa chỉ mà tiền điện tử của bạn sẽ được chuyển về.
NOWPayments → Payout wallets → Add new wallet - Tạo một API key
Mở API keys và nhấp Add new API key. Các khóa của bạn được liệt kê ở đây, mỗi cái có biểu tượng sao chép, nên bạn có thể quay lại và sao chép lại một khóa bất cứ lúc nào.
NOWPayments → Settings → API keys - Sao chép API key của bạn
NOWPayments hiển thị khóa mới trong hộp thoại "API key created". Nhấp biểu tượng sao chép bên cạnh Your API key và giữ lại. (Khóa công khai bên dưới không cần thiết cho Coin Moebius.) Bạn có thể thêm nhãn tùy chọn, rồi nhấp Save.
NOWPayments → API key created Đây là API key bí mật của bạn. Hãy coi nó như mật khẩu.
- Thiết lập callback IPN và sao chép IPN secret
Mở Instant payment notifications. IPN (Instant Payment Notification) là tên của NOWPayments cho webhook họ gửi khi trạng thái thanh toán thay đổi.
- Trong trường Webhook URL, dán địa chỉ webhook NOWPayments của dự án bạn (bên dưới), rồi nhấp Save.
- Sao chép IPN secret key hiển thị ở trên cùng (dùng Regenerate nếu chưa có giá trị).
- Dưới Choose webhook format, chọn Classic way để số tiền và ID giữ định dạng số thông thường.
https://api.coinmoebius.com/webhook/nowpayments/<your project id>NOWPayments → Instant payment notifications 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 đó, nên bạn có thể sao chép lại bất cứ lúc nào.
- Trong Coin Moebius: Thêm nhà cung cấp → NOWPayments
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 NOWPayments. Dán API key và IPN secret của bạn, đặt Success URL và Cancel URL (nơi người mua đến sau khi trả tiền hoặc rút lui), rồi nhấp Save.
Coin Moebius → Thêm nhà cung cấp → NOWPayments - Bạn đã kết nối
NOWPayments giờ xuất hiện trên tab Nhà cung cấp với ngày kết nối. Thẻ hiển thị cùng URL webhook bạn đã dán vào NOWPayments, cộng với Chỉnh sửa và Ngắt kết nối. Vì NOWPayments không có sandbox, chúng tôi không thể tự động xác minh IPN secret, nên thẻ cung cấp bài kiểm tra thanh toán nhỏ: gửi một khoản thanh toán thật nhỏ để xác nhận mọi thứ hoạt động trọn vẹn đầu cuối.
Coin Moebius → Nhà cung cấp → NOWPayments (đã kết nối)
Sau khi bạn kết nối
Không có sandbox, nên khoản thanh toán thật nhỏ đầu tiên của bạn chính là bài kiểm tra:
- Tạo một sản phẩm và đặ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.
- Trả một khoản nhỏ bằng một đồng coin phí thấp.
- Mở tab Giao dịch. Khi trạng thái hàng mới đạt succeeded, API key và IPN secret của bạn đều hoạt động trọn vẹn đầu cuối.
Khắc phục sự cố
Thanh toán hoàn tất nhưng đơn hàng vẫn đang chờ.
IPN không đến hoặc không xác minh được. Xác nhận URL callback khớp và rằng IPN secret trong bảng điều khiển khớp với IPN Secret Key trong cài đặt NOWPayments của bạn.
Không có cách nào để kiểm tra mà không trả tiền.
Đúng vậy, không có sandbox. Gửi một khoản thanh toán thật nhỏ bằng một đồng coin phí thấp để kích hoạt một IPN thật, rồi quan sát đơn hàng cập nhật.
Trạng thái chỉ thay đổi khi có hoạt động thật.
Trạng thái NOWPayments phản ánh các lần gửi IPN, nên một tài khoản im ắng không hiện trạng thái nào cho đến khi một khoản thanh toán thật di chuyển.
Cần biết
Không có chế độ thử nghiệm. Kiểm chứng bằng một khoản thanh toán thật nhỏ, không phải một sandbox.
Xoay secret. Tạo một API key hoặc IPN secret mới bất cứ lúc nào, rồi dán giá trị mới.
Câu hỏi? Join our Discord