重新發送 webhook
post https://api.cryptomus.com/v2/payment/resend 複製
按發票重新發送 webhook。您只能為已完成的發票(即處於下列狀態的發票)重新傳送 webhook:wrong_amount、paid、paid_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
範例回覆:
如果您不傳遞 uuid、order_id 和 txid 參數,您將收到此訊息。這意味著至少需要一個參數。
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}複製