Webhook

Webhook là một phương pháp phản hồi thông tin thanh toán.
Khi trạng thái thanh toán thay đổi, yêu cầu POST sẽ được gửi đến url_callback được chỉ định khi tạo khoản thanh toán.

Phản ứng

Các thông số phản hồi

Tên	Kiểu tham số	Sự định nghĩa
type	string	Loại. Chỉ có thanh toán
uuid	string	uuid của khoản thanh toán
order_id	string\|null	ID đơn hàng trong hệ thống của bạn (để xác định khoản thanh toán)
amount	string	Số tiền thanh toán
merchant_amount	string\|null	Số tiền được trừ vào số dư của người bán, bao gồm tất cả hoa hồng.
commission	string\|null	Số tiền hoa hồng của Cryptomus
is_final	boolean	Việc thanh toán đã hoàn tất chưaNếu khoản thanh toán không phải là cuối cùng và không thành công, bạn vẫn có thể gửi lại thông qua bộ phận hỗ trợ.Khi quá trình thanh toán hoàn tất thì giao dịch có thể được thanh toán hoặc không thành công.
status	string	Trạng thái thanh toán nhìn thấy
fail_reason	string\|null	1. aml - Lý do từ chối thanh toán: người nhận không vượt qua xác minh AML.2. system_error - Lý do từ chối: lỗi máy chủ.3. address_error - Lý do từ chối: địa chỉ người nhận không hợp lệ.
txid	string\|null	Băm giao dịch trên blockchain.Trường txid sẽ không tồn tại nếu1) Khoản thanh toán được trả bằng p2p đến địa chỉ Cryptomus2) Thanh toán không thành công.
currency	string	Tiền tệ hóa đơn
network	string\|null	Mạng blockchain trong đó thanh toán được thực hiện
payer_currency	string\|null	Mã tiền điện tử mà khoản thanh toán thực tế sẽ được thực hiện. Địa chỉ thanh toán sẽ nhận được loại tiền thanh toán.
payer_amount	string\|null	Số tiền thanh toán bằng tiền_thanh_toán.
sign	string	Chữ ký để xác minh rằng webhook đến từ Cryptomus

: Kiểu tham số
string
Sự định nghĩa
Loại. Chỉ có thanh toán
: Kiểu tham số
string
Sự định nghĩa
uuid của khoản thanh toán
: Kiểu tham số
string|null
Sự định nghĩa
ID đơn hàng trong hệ thống của bạn (để xác định khoản thanh toán)
: Kiểu tham số
string
Sự định nghĩa
Số tiền thanh toán
: Kiểu tham số
string|null
Sự định nghĩa
Số tiền được trừ vào số dư của người bán, bao gồm tất cả hoa hồng.
: Kiểu tham số
string|null
Sự định nghĩa
Số tiền hoa hồng của Cryptomus
: Kiểu tham số
boolean
Sự định nghĩa
Việc thanh toán đã hoàn tất chưaNếu khoản thanh toán không phải là cuối cùng và không thành công, bạn vẫn có thể gửi lại thông qua bộ phận hỗ trợ.Khi quá trình thanh toán hoàn tất thì giao dịch có thể được thanh toán hoặc không thành công.
: Kiểu tham số
string
Sự định nghĩa
Trạng thái thanh toán nhìn thấy
: Kiểu tham số
string|null
Sự định nghĩa
1. aml - Lý do từ chối thanh toán: người nhận không vượt qua xác minh AML.2. system_error - Lý do từ chối: lỗi máy chủ.3. address_error - Lý do từ chối: địa chỉ người nhận không hợp lệ.
: Kiểu tham số
string|null
Sự định nghĩa
Băm giao dịch trên blockchain.Trường txid sẽ không tồn tại nếu1) Khoản thanh toán được trả bằng p2p đến địa chỉ Cryptomus2) Thanh toán không thành công.
: Kiểu tham số
string
Sự định nghĩa
Tiền tệ hóa đơn
: Kiểu tham số
string|null
Sự định nghĩa
Mạng blockchain trong đó thanh toán được thực hiện
: Kiểu tham số
string|null
Sự định nghĩa
Mã tiền điện tử mà khoản thanh toán thực tế sẽ được thực hiện. Địa chỉ thanh toán sẽ nhận được loại tiền thanh toán.
: Kiểu tham số
string|null
Sự định nghĩa
Số tiền thanh toán bằng tiền_thanh_toán.
: Kiểu tham số
string
Sự định nghĩa
Chữ ký để xác minh rằng webhook đến từ Cryptomus

Ví dụ phản hồi


1{
2    "type": "payout",
3    "uuid": "2b852d86-3cf1-43fb-b1bb-36f0b7d12151",
4    "order_id": "129359",
5    "amount": "207.00000000",
6    "merchant_amount": "207.30000000", 
7    "commission": "0.30000000",
8    "is_final": true,
9    "status": "fail",
10    "fail_reason": "AML",                 
11    "txid": null,                           
12    "currency": "USDT",
13    "network": "bsc",
14    "payer_currency": "USDT",
15    "payer_amount": "207.00000000",
16    "sign": "eff3afba8600af59c98b74155934da2d"
17}

Sao chép

Xác minh webhook

nhìn thấy