Gate Pay Callback Notification API Documentation: https://docs.gate.com/api-reference/version/100/en/common/asyncNotification
Giải thích Thông tin Trạng thái Callback Thanh toán
Loại Địa chỉ Động
1. Thông báo Tiền về Địa chỉ Động (biztype = TRANSFER_ADDRESS)
TRANSFERRED_ADDRESS_IN_TERM: Tiền được ghi có ngay lập tức trong thời hạn hiệu lực của đơn hàng.
TRANSFERRED_ADDRESS_DELAY: Nếu thanh toán được ghi có sau thời hạn hiệu lực, số tiền thực tế sẽ được cộng vào tài khoản số dư của merchant (ghi có ngay sau thời hạn hiệu lực).
2. Thông báo Thay đổi Trạng thái Đơn hàng Thanh toán Địa chỉ Động (biztype = PAY_ADDRESS)
PAY_SUCCESS: Thanh toán thành công.
PAY_CLOSE: Đơn hàng hết hạn.
PAY_EXPIRED_IN_PROCESS: Đang chờ xác nhận tiền trên chuỗi.
Loại Địa chỉ Tĩnh
1. Thanh toán Thành công qua Địa chỉ Tĩnh (biztype=PAY_FIXED_ADDRESS)
PAY_SUCCESS: Thanh toán thành công và tiền đã được ghi có.
2. Địa chỉ Tĩnh bị Đánh dấu là Địa chỉ Rủi ro (biztype=FIXED_ADDRESS_RISK)
RISK_ADDRESS: Địa chỉ tĩnh đã bị đánh dấu là địa chỉ rủi ro.
Loại Thanh toán Địa chỉ Bất thường
Đối với mỗi giao dịch thanh toán bất thường, Gate Pay sẽ gửi một thông báo webhook đến merchant tương ứng.
bizType cho loại thanh toán này luôn là PAY_UNRESOLVED.
Merchant cần xác định vấn đề hóa đơn dựa trên trường errorType trong dữ liệu và tham khảo Hướng dẫn Xử lý Thanh toán Bất thường Gate Pay hoặc liên hệ với quản lý tài khoản Gate Pay của mình.
- address_risk_address
— Địa chỉ động rủi ro cao - address_error_currency
— Sai loại tiền cho địa chỉ động - address_error_chain
— Sai mạng blockchain cho địa chỉ động - fix_error_currency
— Sai loại tiền cho địa chỉ tĩnh - fix_error_chain
— Sai mạng blockchain cho địa chỉ tĩnh - fix_risk_address
— Địa chỉ tĩnh rủi ro cao - fix_delete
— Địa chỉ tĩnh đã bị xóa - fix_partial_delete
— Địa chỉ tĩnh bị xóa một phần
Về Thông tin Callback cho Thanh toán Địa chỉ Động
Tại Sao Có Hai Loại Thông tin Callback Thanh toán?
- Thông báo Tiền về (TRANSFER_ADDRESS): Thông báo về số tiền thực tế đã được ghi có.
- Thông báo Thay đổi Trạng thái Đơn hàng (PAY_ADDRESS): Thông báo về thay đổi trạng thái đơn hàng.
Merchant cần sử dụng cả hai loại thông tin này để xác định đơn hàng có thành công hay không, từ đó quyết định giao hàng hoặc xử lý đơn thất bại.
Khi Nào Callback Được Gửi?
- Thông báo Tiền về: Sau khi xác nhận thanh toán thành công trên chuỗi, tiền sẽ được ghi có cho merchant theo thời gian thực và callback sẽ được gửi đến merchant.
- Thông báo Thay đổi Trạng thái Đơn hàng: Được kích hoạt khi trạng thái đơn hàng thay đổi.
Các Kịch bản Thanh toán Địa chỉ Động và Xác định Trạng thái Đơn hàng
1. Thanh toán Đủ hoặc Thừa Một lần Trong Thời hạn Hiệu lực
Mô tả: Miễn là người dùng thanh toán đủ hoặc thừa số tiền trong thời hạn hiệu lực của đơn hàng, callback sẽ được gửi theo thời gian thực sau khi xác nhận trên chuỗi.
Trạng thái Đơn hàng: Ban đầu, hệ thống chờ xác nhận tiền trên chuỗi và gửi callback với trạng thái trung gian: bizStatus là PAY_EXPIRED_IN_PROCESS. Sau khi xác nhận trên chuỗi, đơn hàng thành công và callback được gửi với bizStatus là PAY_SUCCESS cùng số tiền đã ghi có là doneAmountOnChain.
Thông báo Tiền về: bizStatus là TRANSFERRED_ADDRESS_IN_TERM, số tiền ghi có là transferAmount.
2. Thanh toán Thiếu Trong Thời hạn Hiệu lực
Mô tả: Nếu người dùng thanh toán ít hơn số tiền đơn hàng trong thời hạn hiệu lực, sau khi xác nhận trên chuỗi, số tiền thực tế sẽ được ghi có cho merchant và callback tiền về được gửi theo thời gian thực.
Trạng thái Đơn hàng: Trong thời hạn hiệu lực, trạng thái đơn hàng không thay đổi và không có callback trạng thái đơn hàng nào được gửi.
Thông báo Tiền về: bizStatus là TRANSFERRED_ADDRESS_IN_TERM, số tiền ghi có là transferAmount.
3. Thanh toán Thiếu Trong Thời hạn Hiệu lực, Không Bù thêm
Mô tả: Nếu người dùng thanh toán ít hơn số tiền đơn hàng trong thời hạn hiệu lực và không bù thêm trong thời hạn này.
Trạng thái Đơn hàng: Khi hết thời hạn hiệu lực, callback trạng thái đơn hàng sẽ được gửi. bizStatus là PAY_CLOSE, số tiền ghi có là doneAmountOnChain.
Thông báo Tiền về: Callback tiền về đã được gửi sau khi thanh toán, sẽ không gửi lại.
4. Thanh toán Thiếu Trong Thời hạn Hiệu lực, Sau đó Bù thêm
4.1 Bù thêm Trong Thời hạn Hiệu lực:
Sau khi người dùng bù thêm số tiền còn thiếu:
Trạng thái Đơn hàng: Hệ thống chờ xác nhận tiền trên chuỗi và gửi callback với trạng thái trung gian: bizStatus là PAY_EXPIRED_IN_PROCESS.
Thông báo Tiền về: Không có thông báo tiền về khi đang chờ xác nhận trên chuỗi cho khoản bù thêm.
Sau khi Xác nhận Trên Chuỗi:
Trạng thái Đơn hàng: Khi tiền trên chuỗi được xác nhận và tổng số tiền đủ, đơn hàng được coi là thành công. bizStatus là PAY_SUCCESS, số tiền ghi có là doneAmountOnChain (tổng tất cả các khoản thanh toán).
Thông báo Tiền về: bizStatus là TRANSFERRED_ADDRESS_IN_TERM, số tiền ghi có là transferAmount.
4.2 Bù thêm Sau Thời hạn Hiệu lực:
Trạng thái Đơn hàng: Vì không đủ số tiền trong thời hạn hiệu lực, callback trạng thái đơn hàng sẽ được gửi khi hết hạn. bizStatus là PAY_CLOSE, số tiền ghi có là doneAmountOnChain.
Thông báo Tiền về: Callback tiền về đã được gửi sau khi thanh toán, sẽ không gửi lại.
Nếu người dùng bù thêm sau thời hạn hiệu lực: một callback tiền về sẽ được gửi với bizStatus là TRANSFERRED_ADDRESS_DELAY, số tiền ghi có là transferAmount. (Trong trường hợp này, không có callback trạng thái đơn hàng bổ sung và callback cuối cùng sẽ không có trường doneAmountOnChain. Nếu người dùng hoàn thành thanh toán bằng nhiều giao dịch, merchant cần cộng tất cả giá trị transferAmount từ các callback để xác nhận tổng số tiền đã ghi có.)
5. Thanh toán Sau khi Hết hạn
Mô tả: Nếu người dùng thanh toán sau khi đơn hàng hết hạn, dù là thanh toán một phần, đủ hoặc thừa, tiền sẽ được ghi có theo thời gian thực sau khi xác nhận trên chuỗi.
Thay đổi Trạng thái Đơn hàng: Vì không có khoản thanh toán nào trong thời hạn hiệu lực, callback sẽ được gửi với bizStatus là PAY_CLOSE khi hết hạn.
Tiền về: Không có thông báo tiền về.
Thanh toán Sau khi Hết hạn: Sau khi hết hạn, với mỗi khoản thanh toán được thực hiện, một callback tiền về sẽ được gửi với bizStatus là TRANSFERRED_ADDRESS_DELAY, số tiền ghi có là transferAmount. (Trong trường hợp này, không có callback trạng thái đơn hàng bổ sung và callback cuối cùng sẽ không có trường doneAmountOnChain. Nếu người dùng hoàn tất thanh toán bằng nhiều giao dịch, merchant cần cộng tất cả giá trị transferAmount từ các callback để xác nhận tổng số tiền đã ghi có.)
Merchant cần sử dụng cả thông tin trạng thái đơn hàng và callback tiền về để xác định đơn hàng có thành công hay không.
6. Thông tin Callback Đơn hàng Bất thường cho Thanh toán Địa chỉ Động
6.1 Thanh toán bằng Loại tiền hoặc Mạng Blockchain khác với Đơn hàng
Merchant sẽ nhận được callback với Biztype=PAY_UNRESOLVED và data.errorType=address_error_currency hoặc address_error_chain.
6.2 Tiền bị Đánh dấu Rủi ro và Bị Chặn
Merchant sẽ nhận được callback với biztype=PAY_UNRESOLVED và data.errorType=address_risk_address.
Về Thông tin Callback cho Địa chỉ Tĩnh
1. Thanh toán Thành công Được Ghi có
Merchant sẽ nhận được thông báo PAY_SUCCESS, cho biết thanh toán thành công và tiền đã được ghi có.
2. Callback Thanh toán Bất thường
2.1 Thanh toán bằng Loại tiền/Mạng khác với Đơn hàng
Merchant sẽ nhận được callback với biztype=PAY_UNRESOLVED và data.errorType=fix_error_currency hoặc fix_error_chain.
2.2 Tiền Rủi ro
Merchant sẽ nhận được callback với biztype=PAY_UNRESOLVED và data.errorType=fix_risk_address.
2.3 Thanh toán gửi đến Địa chỉ Tĩnh đã bị xóa
Merchant sẽ nhận được callback với biztype=PAY_UNRESOLVED và data.errorType=fix_delete hoặc fix_partial_delete.
3. Thông báo Rủi ro Địa chỉ Tĩnh
Merchant sẽ nhận được thông báo với bizType=FIXED_ADDRESS_RISK và bizStatus=RISK_ADDRESS, cho biết địa chỉ nhận tĩnh đã liên kết với merchant bị xác định là địa chỉ rủi ro. Merchant cần xóa ngay địa chỉ tĩnh tương ứng. Nếu người dùng tiếp tục thanh toán vào địa chỉ này, tiền sẽ không được ghi có.
Miễn trừ trách nhiệm
Nội dung được cung cấp ở đây chỉ mang tính chất tham khảo và cung cấp kiến thức, không cấu thành bất kỳ lời khuyên tài chính, đầu tư, giao dịch hoặc pháp lý nào, cũng như không phải là lời đề nghị hoặc lời mời mua hoặc bán bất kỳ tài sản kỹ thuật số nào. Gate không đưa ra bất kỳ tuyên bố hoặc bảo đảm nào, dù rõ ràng hay ngụ ý, về tính chính xác, đầy đủ hoặc kịp thời của thông tin được cung cấp ở đây. Các tính năng sản phẩm, giao diện, quy tắc và cấu trúc phí có thể được cập nhật hoặc điều chỉnh bất cứ lúc nào. Vui lòng tham khảo các thông báo mới nhất và thông tin thực tế được hiển thị trên nền tảng Gate để biết chi tiết chính xác nhất.
Đầu tư vào tài sản kỹ thuật số tiềm ẩn rủi ro đáng kể và giá cả có thể biến động mạnh. Bạn có thể mất toàn bộ số tiền đầu tư. Vui lòng đưa ra quyết định thận trọng dựa trên tình hình tài chính và khả năng chấp nhận rủi ro của riêng bạn sau khi hiểu đầy đủ các rủi ro liên quan. Nếu cần, bạn nên tham khảo ý kiến của cố vấn tài chính hoặc pháp lý chuyên nghiệp độc lập.
Để biết thêm thông tin về các rủi ro tiềm ẩn, vui lòng tham khảo Tuyên bố về Rủi ro và Thỏa thuận Người dùng của Gate.
