redirectUrl hoạt động thế nào trong trang thanh toán crypto

redirectUrl là gì

Bạn tạo thanh toán bằng một POST tới https://api.qvard.com/api/v1/payment (header x-api-key, số đơn hàng làm id, số tiền làm price bằng đô la Mỹ). Phản hồi là 201 với hai trường: id, mã định danh thanh toán ở Qvard, và redirectUrl, có dạng https://my.qvard.com/pay/<id>.

Địa chỉ dẫn tới một trang thanh toán được lưu trữ: trang do Qvard vận hành, không phải máy chủ của bạn. Bạn không xây, không lưu trữ hay bảo trì nó. Việc của bạn là đưa khách tới địa chỉ đó và biết kết quả sau đó qua webhook.

Khách thấy gì

Trên trang, khách:

1. chọn tài sản và mạng (hoặc thấy cái bạn đã chọn trước bằng paymentSystemId);
2. thấy địa chỉ và số tiền chính xác cần gửi, với mạng hiển thị cạnh địa chỉ;
3. gửi giao dịch chuyển từ ví hoặc sàn của mình.

Tỷ giá trên trang được cố định trong một giờ, nên số tiền không đổi khi khách đang trả. Trang giống nhau dù cửa hàng của bạn trông thế nào, và đó chính là điểm mấu chốt: bạn có một trang thanh toán crypto chạy được mà không phải xây. Để xem trước khi tích hợp, hãy mở một hóa đơn demo.

Dùng liên kết ở bước thanh toán

Cách dùng tiêu chuẩn là chuyển hướng phía máy chủ hoặc một nút, trong ba bước:

1. Khách chọn «Thanh toán bằng crypto». Máy chủ của bạn tạo đơn hàng của bạn và thanh toán Qvard.
2. Máy chủ của bạn trả lời bằng redirectUrl, dưới dạng chuyển hướng HTTP hoặc giá trị để front-end của bạn điều hướng.
3. Trình duyệt tới trang đó; khách trả tiền ở đó.

Hãy tạo thanh toán sau khi khách bấm nút, không phải khi dựng giỏ hàng. Đừng bao giờ gửi khóa API bí mật tới trình duyệt: trình duyệt chỉ nhận redirectUrl. Ví dụ nút đầy đủ nằm trong nút thanh toán crypto cho website.

Dùng liên kết ngoài bước thanh toán

Vì trang được lưu trữ ở một địa chỉ thông thường, liên kết cũng dùng được ngoài trang thanh toán web:

• Trong email hoặc PDF hóa đơn, cạnh thông tin ngân hàng, để khách doanh nghiệp có thể chọn trả bằng crypto (xem thanh toán stablecoin cho hóa đơn B2B).
• Trong cuộc trò chuyện hoặc tin nhắn hỗ trợ, cho một khoản thanh toán đơn lẻ bạn tạo thủ công bằng công cụ của mình.
• Sau một mã QR, nếu hệ thống của bạn tạo mã từ địa chỉ.

Hãy coi liên kết là cổng vào đúng một khoản thanh toán. Gửi cho khách mà nó thuộc về và đừng công khai. Liên kết thanh toán như một sản phẩm riêng không cần mã đang được phát triển; hôm nay bạn tạo thanh toán qua API và chia sẻ địa chỉ nó trả về.

Lặp lại, thử lại và điều gì xảy ra sau thanh toán

• Cùng một đơn hai lần. Gửi cùng id cho cùng phương thức thanh toán trả về khoản thanh toán hiện có, nên nhấp đúp hay yêu cầu thử lại cho cùng một khoản thanh toán chứ không phải khoản thứ hai.
• Chưa có URL quay lại. Sau khi trả, khách không được tự động đưa về trang của bạn; URL quay lại chưa khả dụng. Hãy cho họ trang đơn hàng hiển thị trạng thái thực và tự làm mới khi còn đang chờ.
• Kết quả là webhook. Qvard gọi callback URL của bạn khi thanh toán hoàn tất, kèm id của bạn và trạng thái. Endpoint phải trả lời đúng HTTP 200 và an toàn khi chạy hai lần. Khách quay lại trang không phải bằng chứng thanh toán. Xem cách bảo mật webhook thanh toán crypto.

Những gì liên kết không làm

Để bạn khỏi tìm kiếm:

• Nó không cho bạn biết trạng thái thanh toán; không có route đọc thanh toán theo id, nên hãy dùng webhook và bản ghi của bạn.
• Nó không đưa khách quay lại trang của bạn; URL quay lại chưa khả dụng.
• Nó không thay thế trang đơn hàng của bạn: bạn vẫn cần một trang hiển thị «đang chờ», «một phần» hay «đã trả».

Định dạng yêu cầu và phản hồi nằm trong API thanh toán crypto cho nhà phát triển, còn toàn bộ luồng trong cách nhận thanh toán crypto trên website.

FAQ