Đánh dấu khoản thanh toán đã được thực hiện
post https://api.cryptomus.com/v1/payment/mark-as-paid Sao chép
Cho phép người dùng đánh dấu một khoản thanh toán là đã thanh toán.
Thao tác này chỉ khả dụng đối với các khoản thanh toán có các tổ hợp trạng thái sau: status = active và payment_status = wrong_amount_waiting, hoặc status = completed và payment_status = wrong_amount.
Do quy trình xử lý thanh toán là bất đồng bộ, nên việc cập nhật trạng thái ngay lập tức không được đảm bảo. Khi điểm cuối được gọi, một tác vụ bất đồng bộ tương ứng sẽ được tạo ra để xử lý tiếp.
Lời yêu cầu
Tham số truy vấn
| Tên | Kiểu tham số | Sự định nghĩa |
|---|---|---|
| uuid | stringuuidrequired_without: order_id | uuid của thanh toán |
| order_id | stringrequired_without: uuid | ID đơn hàng trong hệ thống của bạnTham số phải là một chuỗi bao gồm các ký tự chữ cái, số, dấu gạch dưới và dấu gạch ngang. Chuỗi không được chứa bất kỳ khoảng trắng hoặc ký tự đặc biệt nào. |
Kiểu tham số
stringuuidrequired_without: order_idSự định nghĩa
uuid của thanh toánKiểu tham số
stringrequired_without: uuidSự định nghĩa
ID đơn hàng trong hệ thống của bạnTham số phải là một chuỗi bao gồm các ký tự chữ cái, số, dấu gạch dưới và dấu gạch ngang. Chuỗi không được chứa bất kỳ khoảng trắng hoặc ký tự đặc biệt nào.
Ví dụ yêu cầu
curl --location 'https://api.cryptomus.com/v1/payment/mark-as-paid' \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"order_id": "test_107"
}'Phản ứng
Ví dụ phản hồi
1{
2 "state": 0,
3 "result": {
4 "success": true,
5 "message": "The request has been accepted and queued for processing."
6 }
7}Lỗi có thể xảy ra
Lỗi xác thực
mã số : 422
ví dụ phản hồi:
1{
2 "message": "Payment not found.",
3 "state": 1
4}Lỗi máy chủ nội bộ
mã số : 500
ví dụ phản hồi:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}