401 authentication_required
Bearer anahtarı eksik veya geçersiz.
Authorization başlığında doğru test veya canlı gizli anahtarı kullanın.
Daha hızlı hata ayıkla
Her API hatasını bir sonraki adıma çevirin.
Entegrasyon sorunlarının çoğu kimlik doğrulama, doğrulama, webhook, rota desteği veya yoklama davranışıyla ilgilidir. Bu rehber belirtiyi çözüme eşler.
400 validation_error
Zorunlu alan eksik veya geçersiz.
Tutarı, para birimini, ağı, webhook URL'ini, cüzdan adresini ve JSON biçimini kontrol edin.404 not_found
Ödeme oturumu veya uç nokta bulunamadı.
Oturum kimliğini ve rota yolunu doğrulayın. Herkese açık durum için /payments/{id}/status kullanın.409 fee_delegation_unavailable
Ücret devri ayarları, rota veya ağ desteği aktif değil.
Standart cüzdan ödemesini kullanın veya önce satıcı politikasını ve desteklenen rotayı etkinleştirin.422 webhook teslimi başarısız oldu
Satıcı uç noktası 2xx durumu döndürmedi.
HTTPS, ham gövde ayrıştırma, imza doğrulama, zaman aşımı ve güvenlik duvarı kurallarını kontrol edin.429 rate_limited
Çok fazla kimlik doğrulamalı API isteği.
Bekleyin, sonra tekrar deneyin ve çok sık yoklama yapmaktan kaçının.Hâlâ takıldınız mı?
İstek kimliğini, uç noktayı, oturum kimliğini, yanıt kodunu ve temizlenmiş veriyi gönderin. Özel anahtarları veya webhook gizli anahtarlarını asla göndermeyin.
Desteğe ulaşın API dokümanlarını aç MCP Oyun Alanında JSON-RPC Hatalarını İnceleyin 422 Webhook İmzalarını Ayıklayın
Resmi NPM SDK'ları (v0.2.0) ve Uzak MCP Sunucusu
Resmi XPayr Paketleri ve Kurulumsuz MCP ile Daha Hızlı Entegre Olun
Kurulum: @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)veya @xpayr/mcp-server (v1.0.0) paketlerini NPM'den yükleyin veya şu araçla canlı JSON-RPC 2.0 çağrıları yürütün: POST https://xpayr.com/api/mcp.