Skip to navigation

Giao dịch và thử lại

View as Markdown

Rút tiền là một hoạt động kinh doanh không đồng bộ. Phản hồi HTTP thành công có nghĩa là yêu cầu đã được xử lý; nó không chứng minh rằng tiền đã đến trên chuỗi.

Duy trì một mã định danh doanh nghiệp

Tạo và lưu trữ client_request_id trước khi gửi yêu cầu rút tiền. Sử dụng lại nó để thử lại thao tác dự định tương tự, kể cả sau khi khởi động lại quá trình. Giữ các trường của giao dịch nhất quán; việc triển khai hiện tại từ chối một mã định danh lặp lại có các thông số kinh doanh xung đột.

Đừng chỉ dựa vào tiêu đề Idempotency-Key. SDK được cung cấp có thể thêm tiêu đề đó, nhưng hợp đồng rút tiền trùng lặp hiện tại dựa trên trường nội dung client_request_id.

Hiểu dữ liệu yêu cầu

Cánh đồngNghĩa
chain_id, asset_idGiá trị nhận dạng trong môi trường đã thỏa thuận
to_address, amountĐích và số thập phân dương được biểu thị dưới dạng chuỗi
client_request_idĐịnh danh yêu cầu kinh doanh ổn định
dest_memo_type, dest_memoChi tiết bản ghi nhớ đích nơi mạng yêu cầu chúng
client_authorizationỦy quyền giao dịch của khách hàng đối với việc rút tiền được thực hiện bằng API
end_user_idMã định danh người dùng doanh nghiệp tùy chọn trong luồng API doanh nghiệp

Bảng này nêu bật các trường cốt lõi chứ không phải lược đồ yêu cầu hoàn chỉnh. Xác nhận xem trước, xác nhận phí và các yêu cầu cụ thể về quyền lưu ký đối với phiên bản tích hợp. Tránh số lượng dấu phẩy động nhị phân và không sao chép chuỗi ví dụ hoặc số nội dung giữa các môi trường.

Theo dõi kết quả

Ví dụ trạng tháiPhiên dịch
pending_approval, pending_platform_reviewPhê duyệt hoặc đánh giá của doanh nghiệp chưa được xử lý
approved, pending_signPhê duyệt và ký là các giai đoạn riêng biệt
broadcasting, pending_chainViệc phát sóng hoặc xác nhận chuỗi đang được tiến hành
broadcast_unverified, recoveringKết quả vẫn chưa chắc chắn; không tạo chuyển khoản khác
awaiting_reauthorizationCó thể cần phải có ủy quyền khách hàng mới cho cùng một yêu cầu
confirmedHệ thống đã ghi nhận xác nhận chuỗi

Danh sách này mang tính minh họa và có thể phát triển. Giữ lại các trạng thái chưa biết để điều tra thay vì ánh xạ chúng tới thành công hay thất bại. Chỉ một nhãn hiệu bị lỗi hoặc bị từ chối thôi thì chưa đủ bằng chứng cho thấy không có gì được ký kết hoặc phát sóng.

Khôi phục sau một thời gian chờ

Truy vấn GET /api/v1/withdrawals/by-request bằng cách sử dụng tham số truy vấn client_request_id ban đầu. Tiếp tục bỏ phiếu hoặc đối chiếu hoạt động ban đầu trong khi kết quả của nó không chắc chắn. Nếu cần gia hạn ủy quyền, hãy sử dụng cùng một mã định danh và quy trình gia hạn đã thỏa thuận.

Việc hủy tùy thuộc vào giai đoạn ký thực tế và việc kiểm tra của máy chủ. Chỉ bắt đầu hoạt động kinh doanh thay thế sau khi doanh nghiệp ban đầu được xác định là không được chuyển nhượng và không thể chuyển nhượng. Nhận sự kiện thông qua webhooksvà giữ lại các truy vấn API dưới dạng đường dẫn đối chiếu.