Giao dịch và thử lại
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
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ả
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.