Moove API
Một lệnh gọi. Nhận đủ tiền.
Tạo liên kết thanh toán từ mã của bạn. Khách hàng trả bằng bất kỳ token nào, còn bạn nhận đủ toàn bộ số tiền bằng token của mình.
Từ khóa API đến khoản thanh toán đầu tiên.
Tạo khóa API
Trong Moove Business, tạo khóa cho Moove Receive Agent. Khóa chỉ hiển thị một lần, vì vậy hãy lưu ngay vào môi trường của bạn.Tạo liên kết thanh toán
Một lệnh POST trả về URL thanh toán. Khách hàng thanh toán tại đó, bằng bất kỳ token nào, trên bất kỳ chuỗi nào.Nhận thông báo khi được thanh toán
Đăng ký một điểm cuối HTTPS, Moove sẽ gửi sự kiện có chữ ký đến đó ngay khi liên kết được thanh toán.
API gọn nhẹ. Cam kết vững chắc.
Trả bằng mọi token, nhận bằng token của bạn
Khách hàng thanh toán bằng tài sản họ đang có, trên hơn 30 mạng blockchain. Mọi khoản thanh toán đều về ví của bạn, bằng token và trên chuỗi bạn đã chọn.Hợp đồng API vững chắc để xây dựng
Phiên bản nằm trong đường dẫn, v1 chỉ bổ sung, kèm lược đồ OpenAPI luôn cập nhật.Giới hạn rõ ràng, lỗi rõ ràng
Giới hạn theo khóa và theo IP, mã 429 rõ ràng, cùng một định dạng lỗi duy nhất với mã ổn định.Bản thân API hoàn toàn miễn phí.
Không thu phí thuê bao, không tính phí theo lượt gọi. Khách hàng trả bằng token hoặc chuỗi khác sẽ chịu 0,02%, nên bạn nhận đủ toàn bộ số tiền.- Truy cập API
- Miễn phí
- Cùng token, cùng mạng
- Miễn phí
- Khác token hoặc mạng
- 0,02%
Moove so với tự xây dựng.
| Moove so với tự xây dựng. | Moove | Tự xây dựng |
|---|---|---|
| Số chuỗi hỗ trợ | Moove: Hơn 30, qua một điểm cuối duy nhất | Tự xây dựng: Mỗi chuỗi một lần tích hợp |
| Quy đổi sang token của bạn | Moove: Tích hợp sẵn trong mọi khoản thanh toán | Tự xây dựng: Tự định tuyến swap và bridge |
| Biết khi tiền đã về | Moove: Webhook có chữ ký và điểm cuối danh sách | Tự xây dựng: Listener bạn tự vận hành cho từng chuỗi |
| Trang thanh toán | Moove: Liên kết được lưu trữ sẵn, chỉ việc chia sẻ | Tự xây dựng: Tự thiết kế, xây dựng và lưu trữ |
| Nếu khóa bị lộ | Moove: Khóa chỉ có thể yêu cầu thanh toán cho bạn | Tự xây dựng: Toàn bộ tài sản trong ví nóng |
Câu hỏi thường gặp.
Làm thế nào để lấy khóa API?
Đăng nhập vào bảng điều khiển Moove Business và mở mục Khóa API. Đặt tên cho khóa và chọn Moove Receive Agent để được cấp quyền tạo và đọc liên kết thanh toán. Khóa đầy đủ chỉ hiển thị một lần khi tạo và không bao giờ hiển thị lại, vì vậy hãy lưu nó trong trình quản lý bí mật. Không có điểm cuối nào tạo khóa, nên một khóa không bao giờ có thể cấp ra khóa khác.
Khi khách hàng thanh toán, tiền sẽ về đâu?
Về ví mặc định của chủ sở hữu khóa, trên chuỗi và bằng token quyết toán của ví đó. Bên gọi API không thể chỉ định đích đến khác. Vì vậy, trước lệnh gọi đầu tiên, tài khoản cần có một Moove handle đã đăng ký và một ví mặc định có token quyết toán; thiếu một trong hai, việc tạo liên kết sẽ trả về lỗi 409 cho biết tài khoản chưa sẵn sàng nhận thanh toán.
Có API chi trả không?
Chưa có. API này nhận thanh toán, không gửi thanh toán. Để trả tiền cho nhà cung cấp hoặc nhà thầu ngay hôm nay, hãy dùng tính năng Gửi trong bảng điều khiển Moove Business. Moove Send Agent đã được công bố và sẽ có trong tài liệu khi ra mắt.
Webhook của Moove hoạt động như thế nào?
Đăng ký tối đa năm điểm cuối HTTPS trong bảng điều khiển. Mỗi điểm cuối nhận hai sự kiện: một khi khoản thanh toán cho liên kết được quyết toán, và một khi liên kết hoàn tất. Các lần gửi được ký bằng HMAC-SHA256 với một khóa bí mật chỉ hiển thị một lần. Việc gửi diễn ra ít nhất một lần, vì vậy hãy loại trùng theo id sự kiện. Lần gửi thất bại sẽ được thử lại tối đa sáu lần.
Có giới hạn tần suất gọi không?
Có. Yêu cầu được giới hạn theo khóa API và theo IP nguồn, tùy giới hạn nào chạm trước, và vượt quá sẽ trả về 429. Hãy giãn thời gian thử lại theo cấp số nhân kèm một chút jitter thay vì thử lại ngay, vì các yêu cầu bị từ chối vẫn được tính. Dùng webhook để nhận trạng thái thanh toán thay vì liên tục truy vấn một liên kết, và tính toán theo giới hạn IP nếu nhiều tích hợp dùng chung một máy chủ.
API được quản lý phiên bản như thế nào?
Trong đường dẫn. Hiện có một phiên bản công khai là v1. Các thay đổi trong một phiên bản chỉ bổ sung: điểm cuối mới, trường tùy chọn mới, trường phản hồi mới. Mọi thay đổi có thể làm hỏng client, như xóa một trường hay đổi kiểu dữ liệu, sẽ ra mắt dưới một phiên bản đường dẫn mới. Hãy xây dựng client bỏ qua các trường không xác định và rẽ nhánh theo mã lỗi, không bao giờ theo nội dung thông báo.
