Geliştirici belgeleri

Onaylı ödeme bildirimini yeniden gönderme

Alıcı düzeltildikten sonra CONFIRMED / COMPLETED için yeniden gönderin. Kuyruğa alma teslim anlamına gelmez.

POST /api/v1/webhooks/resend

Kimlik doğrulama iste

X-Bolt-Key, X-Bolt-Timestamp ve X-Bolt-Signature'yi dahil edin. Geçerli bir milisaniye timestamp kullanın ve bunu tam istek gövdesiyle birlikte imzalayın.

Ne zaman yeniden gönderilecek

Sisteminizin onaylanmış bir ödemeye ilişkin başka bir bildirime ihtiyacı olduğunda bu uç noktayı kullanın. Yeniden gönderme, ödeme tahsil etmez, bir transferin mutabakatını sağlamaz veya bir sipariş oluşturmaz.

Yalnızca kendi CONFIRMED veya COMPLETED siparişleriniz yeniden gönderilebilir. PENDING, PAID ve diğer eyaletler uygun değildir.

Kullanılabilir, etkin bir Webhook yapılandırması gereklidir. Hiçbir teslim görevi sürdürülmezse uç nokta QUEUED yerine bir hata döndürür.

01. İstek parametreleri

application/json
externalOrderIdGerekli
String

orderToken'yi değil, sipariş oluşturma sırasında sağlanan externalOrderId satıcısını gönderin. Yalnızca mevcut API anahtarına ait siparişler için bildirimleri yeniden gönderebilirsiniz.

Örnek değer

{"externalOrderId": "INV-20260209-99281"}

Gerekli dize, 6-64 karakter. Harflere, rakamlara, alt çizgilere (_) ve kısa çizgilere (-) izin verilir.

Body

02. Yanıt alanları (data)

application/json
notifyUrlString
Siparişte kaydedilen geri arama adresi; null olabilir. Teslimat bu adresi tercih eder ve yapılandırması olmayan eski siparişler için ilgili Webhook yapılandırmasına geri döner.
externalOrderIdString
externalOrderId isteğiyle eşleşen, bu yeniden gönderimle ilişkili ID satıcı siparişi.
triggerTypeEnum
Bu uç noktanın yanıtında her zaman MANUAL, satıcı tarafından talep edilen bir yeniden gönderimi belirtir. Bu ödeme ödeme türü değil.
statusEnum
Yeniden gönderme isteği durumu. QUEUED, görevin devam ettiği anlamına gelir; bu ne ödeme durumu ne de teslimat kanıtıdır.

QUEUED, görevin eşzamansız gönderim için kaydedildiğini belirtir; bildirimin ulaştığını göstermez. Satıcı panelindeki gönderim kayıtlarını ve alıcının HTTP 2xx yanıtını kontrol edin.

🚀
Alıcı yönetimi

X-Bolt-Webhook-Timestamp ve X-Bolt-Webhook-Signature'yi doğrulayın, ardından yerine getirmeden önce eventId veya satıcı siparişi ID ile tekilleştirin. Zaten başarıyla işlenen yinelenen bildirimler için HTTP 2xx değerini döndürün.

  • triggerType: MANUAL, yeniden gönderme yanıtı ve kontrol paneli teslim kayıtlarında görünür. Geçerli Webhook istek gövdesi triggerType'yi içermiyor; bir yeniden gönderimi tanımlamak için ona güvenmeyin.
  • Her başarılı çağrı, bağımsız bir dağıtım görevi oluşturur. Tekrarlanan istekler birden fazla bildirim gönderebilir. Tekrar göndermeden önce teslimat günlüklerini kontrol edin. Tekrarlar mantıksal eventId değerini korur.
  • Bu uç nokta, siparişin geri çağırma hedefini yeniden kullanır ve yeni bir URL'yi kabul etmez. Kontrol paneli varsayılanını değiştirmek, siparişte önceden kayıtlı olan bir adresin yerine geçmez.
Safe

Genel hatalar

Bunlar yaygın görülen durumlardır. Arızaları teşhis etmek için gerçek HTTP durumunu ve yanıt kodunu/mesajını kullanın. Hata yanıtı bir ödeme sonucu değildir.

  • 401: API Anahtarını, ham gövde imzasını ve mevcut milisaniye timestamp'yi (sunucu saatinden sonraki 5 dakika içinde) kontrol edin.
  • 404: Sipariş eksik, başka bir satıcıya ait veya planınızın izin verdiği geçmişin dışında.
  • 400: Sipariş CONFIRMED / COMPLETED değil veya kullanılabilir bir Webhook yapılandırması ve başarıyla depolanan teslimat görevi eksik.
resend / cURL
# Run against your account only when ready; this sends an API request.
: "${BOLTUTIL_API_KEY:?Set your complete API Key}"
: "${BOLTUTIL_WEBHOOK_SECRET:?Set your Webhook secret}"
timestamp=$(python3 -c 'import time; print(int(time.time()*1000))')
body='{"externalOrderId":"INV-20260209-99281"}'
signature=$(printf '%s.%s' "$timestamp" "$body" | openssl dgst -sha256 -hmac "$BOLTUTIL_WEBHOOK_SECRET" | awk '{print $NF}')

curl --request POST "https://api.boltutil.com/api/v1/webhooks/resend" \
  --header 'Content-Type: application/json' \
  --header "X-Bolt-Key: $BOLTUTIL_API_KEY" \
  --header "X-Bolt-Timestamp: $timestamp" \
  --header "X-Bolt-Signature: $signature" \
  --data-binary "$body"

Adresler, işlem karmaları ve siparişler örnektir. Bunları kendi testiniz data ile değiştirin.

Base URL

PROD
https://api.boltutil.com