重新發送 webhook

post https://api.cryptomus.com/v2/payment/resend 複製

按發票重新發送 webhook。您只能為已完成的發票(即處於下列狀態的發票)重新傳送 webhook:wrong_amountpaidpaid_over

若要重新傳送發票上的 webhook,必須在建立發票時指定 url_callback

要求

查詢參數

姓名參數類型定義
uuid*uuidrequired_without_all: order_id, txid發票 UUID
order_id*stringmin:1max:128alpha_dashrequired_without_all: uuid, txid發票訂單ID
txid*stringmin:1max:256required_without_all: uuid, order_id交易 ID除非提供了 uuid 或 order_id,否則為必填項。

參數類型

uuidrequired_without_all: order_id, txid

定義

發票 UUID

參數類型

stringmin:1max:128alpha_dashrequired_without_all: uuid, txid

定義

發票訂單ID

參數類型

stringmin:1max:256required_without_all: uuid, order_id

定義

交易 ID除非提供了 uuid 或 order_id,否則為必填項。

* - 必需參數

您必須至少提供一項必填參數。如果您提供三項,系統將使用以下方式識別帳戶: order_id.

請求範例


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"
        }'
複製

回覆

回應範例


1{
2    "state": 0,
3    "result": []
4}
複製

可能的錯誤

驗證錯誤

程式碼 : 422

範例回覆:

如果您不傳遞 uuidorder_idtxid 參數,您將收到此訊息。這意味著至少需要一個參數。


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}
複製

如果找不到發票


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}
複製