Gửi lại webhook

post https://api.cryptomus.com/v2/payment/resend Sao chép

Gửi lại webhook theo hóa đơn. Bạn chỉ có thể gửi lại webhook cho các hóa đơn đã thanh toán, tức là các hóa đơn có trạng thái: wrong_amount, paid, paid_over.

Để gửi lại webhook trên hóa đơn, url_callback phải được chỉ định tại thời điểm tạo hóa đơn.

Lời yêu cầu

Tham số truy vấn

TênKiểu tham sốSự định nghĩa
uuid*uuidrequired_without_all: order_id, txidHóa đơn uuid
order_id*stringmin:1max:128alpha_dashrequired_without_all: uuid, txidID đơn hàng hóa đơn
txid*stringmin:1max:256required_without_all: uuid, order_idID giao dịchBắt buộc trừ khi uuid hoặc order_id được cung cấp.

Kiểu tham số

uuidrequired_without_all: order_id, txid

Sự định nghĩa

Hóa đơn uuid

Kiểu tham số

stringmin:1max:128alpha_dashrequired_without_all: uuid, txid

Sự định nghĩa

ID đơn hàng hóa đơn

Kiểu tham số

stringmin:1max:256required_without_all: uuid, order_id

Sự định nghĩa

ID giao dịchBắt buộc trừ khi uuid hoặc order_id được cung cấp.

* - tham số bắt buộc

Bạn phải cung cấp ít nhất một trong các tham số bắt buộc. Nếu bạn cung cấp ba tham số, tài khoản sẽ được xác định bằng order_id.

Ví dụ yêu cầu


curl https://api.cryptomus.com/v2/payment/resend \
    -X POST \
    -H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
            "uuid": "8b03432e-385b-4670-8d06-064591096795"
        }'
Sao chép

Phản ứng

Ví dụ phản hồi


1{
2    "state": 0,
3    "result": []
4}
Sao chép

Lỗi có thể xảy ra

Lỗi xác thực

mã số : 422

ví dụ phản hồi:

Nếu bạn không truyền uuid, order_idtxid, bạn sẽ nhận được thông báo này. Điều này có nghĩa là ít nhất một tham số là bắt buộc.


1{
2      "state": 1,
3      "errors": {
4        "uuid": ["validation.required_without_all"],
5        "order_id": ["validation.required_without_all"],
6        "txid" : ["validation.required_without_all"]
7      }
8}
Sao chép

Nếu không tìm thấy hóa đơn


1{
2	"state": 1,
3	"message": "Payment not found"
4}
Sao chép

Nếu url_callback không được chỉ định khi tạo hóa đơn và không có thông báo nào được gửi, sẽ không có thông tin nào để gửi lại và bạn sẽ nhận được thông báo lỗi này:


1{
2	"state": 1,
3	"message": "Notification not found"
4}
Sao chép

Số lần gửi lại tối đa là 10. Nếu vượt quá giới hạn này, bạn sẽ nhận được thông báo lỗi. Nếu bạn muốn gửi lại thông báo vượt quá giới hạn, vui lòng liên hệ với bộ phận hỗ trợ.


1{
2	"state": 1,
3	"message": "Too much resend"
4}
Sao chép