Định dạng webhook hóa đơn

Dữ liệu được gửi trong body của HTTP request webhook đã chỉ định khi tạo thanh toán.

Để xác nhận xử lý thành công, máy chủ của bạn phải trả về HTTP 200 OK. Nếu không, hệ thống sẽ thử gửi lại webhook tối đa 5 lần với khoảng cách 15 giây.

Khi cần, webhook có thể được gửi lại bằng phương thức gửi lại webhook.

Định dạng dữ liệu webhook nhận đượcapplication/json

id

uuid

ID thanh toán đã tạo
info.currency

string | null

Mã tiền fiat của hóa đơn
info.token

string | null

Token thanh toán
info.network

string | null

Mạng thanh toán
info.address

string | null

Địa chỉ ví để thanh toán
amount.starting_price

number

Số tiền ban đầu của hóa đơn bằng fiat
amount.discount_percent

number

Mức giảm giá theo phần trăm
amount.merchant_fee_percent

number

Phí merchant theo phần trăm
amount.service_fee_percent

number | null

Phí dịch vụ nền tảng theo phần trăm
amount.total

number

Số tiền cuối cùng sau giảm giá và phí
url.webhook

string | null

URL Webhook của merchant
url.success

string | null

URL chuyển hướng sau khi thanh toán thành công
url.error

string | null

URL chuyển hướng sau khi thanh toán lỗi
url.payment

string

Liên kết trang thanh toán
options.part_payment

boolean

Có cho phép thanh toán một phần hay không
options.ignore_client_amount

boolean

Có bỏ qua số tiền chính xác của client hay không
options.payment_accuracy

number

Sai số thanh toán được phép
additional.order_id

string | null

ID đơn hàng bên ngoài
additional.info

string | null

Thông tin bổ sung của đơn hàng
status

string

Trạng thái hiện tại của hóa đơn
expired_at

string (ISO 8601, UTC)

Ngày hết hạn hóa đơn
created_at

string (ISO 8601, UTC)

Ngày tạo hóa đơn
payment.transactions

array

Danh sách giao dịch blockchain đến
payment.transactions[].txid

string | null

Hash giao dịch
payment.transactions[].from

string | null

Địa chỉ người gửi
payment.transactions[].amount

string | null

Số tiền giao dịch đến theo đơn vị nhỏ nhất của token
payment.fiat_payment_amount

number

Số tiền fiat đã thanh toán
payment.service_fee_amount

number

Phí dịch vụ đã cộng dồn bằng fiat