Những gì bạn cần
| Trường | Nó làm gì |
|---|---|
| API key ID | Xác định API key của MakePay để chúng tôi gọi đúng tài khoản. Bí mật. |
| API key secret | Cho phép chúng tôi tạo khâu thanh toán MakePay trên tài khoản của bạn. Bí mật. |
| Webhook secret | Xác nhận một webhook thực sự đến từ MakePay. Bí mật. |
| Success URL | Nơi người mua đáp xuống sau khi thanh toán hoàn tất. |
| Failure URL | Nơi người mua đáp xuống nếu thanh toán thất bại hoặc họ hủy. |
MakePay phát hành API key ID và secret cùng nhau khi bạn tạo một khóa; webhook secret là một giá trị riêng tách khỏi cài đặt callback của nó.
Vì sao chúng tôi hỏi mỗi trường
API key ID
Xác định khóa MakePay nào chúng tôi xác thực với. Không bí mật độc lập, nhưng nó được ghép với secret bên dưới.
API key secret
Cho phép tạo khâu thanh toán, để khoản phí chạy qua tài khoản MakePay của bạn và về ví của bạn. MakePay hiển thị nó một lần, ngay sau khi bạn tạo khóa.
Webhook secret
Chứng minh một webhook đến thực sự từ MakePay, 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à Failure URL
Cài đặt thông thường: nơi người mua đáp xuống sau khi trả tiền hoặc sau khi thanh toán bị lỗi hoặc bị hủy. Không bí mật.
Thiết lập
- Tạo một API key trong MakePay
Đăng nhập MakePay và mở API & SDK → API integrations. Dưới API keys, nhấp Generate API Key, đặt tên nó như "Coin Moebius", và tạo nó. MakePay hiển thị API key ID và secret của nó một lần, ngay sau khi tạo — sao chép cả hai ngay, vì secret không được hiển thị lại.
MakePay → API & SDK → API integrations → Generate API Key Coi API key secret như một mật khẩu. Nếu bạn mất nó, tạo một khóa mới thay vì cố phục hồi cái cũ.
- Tìm ID dự án Coin Moebius của bạn
Trong một tab riêng, mở dự án của bạn trong bảng điều khiển Coin Moebius và sao chép Project ID từ dưới tên dự án. Callback URL MakePay của bạn là ID đó chèn vào địa chỉ bên dưới — bạn sẽ dán nó vào MakePay ở bước tiếp theo.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → dự án của bạn → Project ID 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.
- Đặt callback URL và sao chép webhook secret
Quay lại MakePay, cuộn đến Delivery → Callback URL configuration. Nhấp Edit Callback URL, dán webhook URL Coin Moebius của bạn làm đích đến đang hoạt động, và lưu. Sau đó, dưới Webhook signing, sao chép signing secret (sử dụng Regenerate secret nếu chưa có giá trị) — đó là Webhook secret mà Coin Moebius yêu cầu.
MakePay → Delivery → Callback URL configuration MakePay gửi cập nhật giao hàng đến địa chỉ này sau mỗi thay đổi trạng thái mà thương nhân thấy. Signing secret là riêng biệt từ API key — bạn cần cả hai.
- Kết nối trong bảng điều khiển Coin Moebius
Trong Coin Moebius, mở Nhà cung cấp → Thêm nhà cung cấp → MakePay. Dán API key ID, API key secret, và Webhook secret của bạn, rồi đặt Success URL và Failure URL (nơi người mua đáp xuống sau khi trả tiền hoặc sau khi thanh toán bị lỗi). Nhấp Save.
Coin Moebius → Thêm nhà cung cấp → MakePay Các secret đã lưu vẫn ẩn. Để thay đổi một cái sau này, chọn Replace và nhập giá trị mới.
- Bạn đã kết nối
MakePay giờ xuất hiện trên tab Nhà cung cấp với ngày kết nối và webhook URL mà nó mong đợi. Nếu bạn chưa làm vậy, dán URL đó vào cài đặt callback MakePay. Sử dụng Chỉnh sửa để xoay khóa hoặc Ngắt kết nối để xóa nó, và bật tắt Chế độ thử nghiệm để đi qua một đơn hàng mà không ảnh hưởng đến các con số thật của bạn.
Coin Moebius → Nhà cung cấp → MakePay (đã kết nối)
Sau khi bạn kết nối
Chạy một đơn hàng trước khi chạy thật:
- Bật Chế độ thử nghiệm trên thẻ MakePay đã kết nối để đi qua một đơn hàng mà không ảnh hưởng đến các con số thật của bạn.
- 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.
- Hoàn tất thanh toán qua MakePay.
- Mở tab Giao dịch. Khi trạng thái của hàng mới đạt succeeded, khóa và webhook của bạn đều hoạt động trọn vẹn đầu cuối.
Tắt Chế độ thử nghiệm khi bạn sẵn sàng cho thanh toán thật.
Khắc phục sự cố
Bắt đầu trong bảng điều khiển: xác nhận thẻ MakePay hiển thị kết nối và webhook URL khớp với đích đến callback được lưu trong MakePay.
Thanh toán hoàn tất nhưng đơn hàng vẫn đang chờ.
Webhook không đến hoặc không xác minh được. Xác nhận callback URL trong MakePay khớp với webhook URL dự án của bạn chính xác, và Webhook secret trong Coin Moebius khớp với signing secret trong MakePay.
Lưu nhà cung cấp bị từ chối.
API key ID, API key secret, và Webhook secret đều được yêu cầu. Sao chép lại chúng từ MakePay — secret chỉ được hiển thị một lần, nên tạo một khóa mới nếu bạn không còn có nó.
Một đơn hàng thử nghiệm không bao giờ xuất hiện trong Giao dịch.
Bật bộ chuyển đổi Chế độ thử nghiệm cho thẻ MakePay trước khi bạn chạy nút mua, và đảm bảo sản phẩm trỏ về cùng dự án.
Cần biết
Không lưu giữ tài sản. MakePay định cư tiền điện tử thẳng vào ví của riêng bạn. Coin Moebius không bao giờ giữ quỹ và không thể di chuyển chúng.
Xoay secret. Tạo một API key mới hoặc tạo lại webhook signing secret bất cứ lúc nào, rồi chọn Replace trong bảng điều khiển và dán giá trị mới. Các trường bí mật vẫn để trống khi chỉnh sửa.
Câu hỏi? Join our Discord