Payment generator

VeilPay hỗ trợ hai phương thức thanh toán:

Phương thức trực tiếp là cách dễ nhất để bắt đầu chấp nhận thanh toán. Bạn tạo một liên kết thanh toán và gửi cho người dùng. Người dùng mở liên kết và hoàn tất giao dịch. Phương thức này không yêu cầu tích hợp backend. Tuy nhiên, vì các tham số giao dịch (số tiền, địa chỉ, v.v.) có thể bị người dùng thay đổi, bạn nên luôn xác minh rằng thanh toán đã được nhận đúng địa chỉ trước khi giao hàng hoặc dịch vụ.

Phương thức gián tiếp cho bạn nhiều quyền kiểm soát hơn đối với giao dịch. Trong luồng này, trước tiên bạn tạo giao dịch và nhận được một transaction ID. Sau đó bạn hiển thị thông tin thanh toán cho người dùng. Vì giao dịch được tạo trước, người dùng không thể thay đổi các tham số thanh toán. Điều này cũng cho phép bạn theo dõi trạng thái giao dịch bằng transaction ID. Các giao dịch được tạo theo phương thức này phải được bắt đầu trong vòng 72 giờ, nếu không sẽ tự động bị xóa khỏi cơ sở dữ liệu.

Sử dụng phương thức giao dịch được tạo trước nếu bạn muốn:

kiểm soát nhiều hơn đối với luồng thanh toán

khả năng theo dõi trạng thái giao dịch

bảo vệ tốt hơn trước việc thay đổi tham số

Sử dụng phương thức liên kết trực tiếp nếu bạn muốn:

tích hợp nhanh nhất

không cần phát triển backend

luồng liên kết thanh toán đơn giản

Giao dịch VeilPay hiện bị giới hạn tương đương 5 BTC mỗi giao dịch.

Giới hạn này giúp giảm thiểu độ trễ xử lý và giảm rủi ro liên quan đến KYC.

Nếu người dùng gửi đúng loại tiền điện tử mà bạn chọn để nhận, sẽ không cần trao đổi.

Veil không tính bất kỳ khoản phí nào cho các giao dịch này.

Nếu thông báo email được bật khi tạo giao dịch, bạn sẽ nhận được thông báo khi thanh toán hoàn tất.

VeilPay không xử lý thanh toán bằng tiền pháp định trực tiếp.

Tuy nhiên, bạn có thể xác định giá của một giao dịch bằng tiền pháp định (USD, EUR, v.v.).

VeilPay sẽ tự động quy đổi số tiền thành giá trị tương đương bằng tiền điện tử theo tỷ giá hiện tại.

Phương thức được tạo trước (gián tiếp) được xây dựng cho tích hợp server-to-server. Backend của bạn tạo một khoản thanh toán qua REST API của chúng tôi, nhận lại một anonpay_id, và bạn hiển thị hoặc nhúng widget VeilPay theo id đó. Tất cả tham số thanh toán được lưu trữ ở phía chúng tôi, vì vậy khách hàng không thể thay đổi số tiền, địa chỉ, hoặc bất kỳ trường nào khác.

Tất cả các endpoint nằm dưới /api/anonpay trên tên miền VeilPay của bạn. Chúng công khai — không cần API key hoặc chữ ký để tạo thanh toán.

Từ server của bạn, gửi yêu cầu POST đến /api/anonpay/prepare kèm loại coin và mạng bạn muốn nhận, địa chỉ ví của bạn, và số tiền. Chưa có đơn hàng nào được tạo tại thời điểm này — bạn chỉ đặt trước một ý định thanh toán.

Chuyển hướng khách hàng đến trang thanh toán cho id đó, hoặc nhúng vào trang của bạn dưới dạng iframe. Widget mở ra với số tiền và địa chỉ đã bị khóa — khách hàng chỉ chọn loại coin để thanh toán.

Kiểm tra trạng thái hiện tại bất cứ lúc nào bằng yêu cầu GET. Trạng thái chuyển qua prepared → waiting_deposit → deposit_received → exchanging → sending → completed.

Thay vì thăm dò liên tục, hãy truyền một URL webhook khi tạo thanh toán để nhận POST mỗi khi trạng thái thay đổi: