重新發送 webhook
post https://api.cryptomus.com/v1/payment/resend 複製
按發票重新發送 webhook。您只能為已完成的發票(即處於下列狀態的發票)重新傳送 webhook:wrong_amount、paid、paid_over。
若要重新傳送發票上的 webhook,必須在建立發票時指定 url_callback。
要求
查詢參數
姓名 | 參數類型 | 定義 |
---|---|---|
uuid* | uuidrequired_without: order_id | 發票 UUID |
order_id* | stringmin:1max:128alpha_dashrequired_without: uuid | 發票訂單ID |
參數類型
uuidrequired_without: order_id定義
發票 UUID參數類型
stringmin:1max:128alpha_dashrequired_without: uuid定義
發票訂單ID
* - 必需參數
您需要傳遞其中一個必需參數,如果同時傳遞兩個參數,則該帳戶將透過 order_id
請求範例
curl https://api.cryptomus.com/v1/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"
}'
複製回覆
回應範例
1{
2 "state": 0,
3 "result": []
4}
複製可能的錯誤
驗證錯誤
程式碼 : 422
範例回覆:
如果您不傳遞 uuid 和 order_id,您將收到此訊息。這意味著至少需要一個參數。
1{
2 "state": 1,
3 "errors": {
4 "uuid": ["validation.required_without"],
5 "order_id": ["validation.required_without"]
6 }
7}
複製如果找不到發票
1{
2 "state": 1,
3 "message": "Payment not found"
4}
複製如果建立發票時未指定 url_callback,且未發送通知,則無需重新發送任何內容,並且您將收到以下錯誤訊息:
1{
2 "state": 1,
3 "message": "Notification not found"
4}
複製重新發送的次數上限為 10 次,如果超過此限制,您將收到錯誤訊息。如果您需要重新發送超出限制的通知,請聯絡客服。
1{
2 "state": 1,
3 "message": "Too much resend"
4}
複製