Bu sayfada
Hata Kodları
Merchant API hatalarını kararlı, makine tarafından okunabilir kodlar, alan düzeyi doğrulama ayrıntıları ve belgelenmiş kurtarma yollarıyla yönetin.
Kod kataloğu
code içinde (ve alan bazında errors[].code içinde) döndürülen kararlı, makine tarafından okunabilir tanımlayıcılar. Bu canlı kümedir — aşağıdaki her kod, çalışan API'de en az bir işleyici, doğrulayıcı veya middleware tarafından üretilir; teorik bir üst küme değildir. Mevcut kodların anlamı asla değişmez; yeni senaryolar ortaya çıktıkça yeni kodlar eklenir. Bir kod yalnızca ender durumlarda yeniden adlandırılır ve her yeniden adlandırma changelog'da duyurulur.
Programatik işleme için code üzerinden switch yapın. detail yalnızca İngilizce'dir ve log / yedek UI için tasarlanmıştır; istemcide code ile yerelleştirin.
Alan düzeyi kodlar
İstek doğrulaması tarafından üretilir. Aşağıdaki her kod, field alanını hatalı alanın snake_case adına ayarlar. Birden fazla alan aynı anda başarısız olduğunda, üst düzey code validation_failed olur ve her alan bazlı hata errors[] içine düşer.
| Kod | Ne zaman | Ne yapmalı |
|---|---|---|
validation_failed |
Birden fazla alan aynı anda başarısız olduğunda üst düzey code. Her alan bazlı hata, errors[] içinde kendi code ve field değerini taşır. |
errors[] içini inceleyin ve listelenen her field değerini düzeltin. |
field_required |
Zorunlu bir alan boş, null veya yalnızca boşluk karakterinden oluşuyor. | field için bir değer sağlayın. |
field_too_long |
Alan, izin verilen azami uzunluğu aşıyor. | O uç nokta için belgelenen sınıra kısaltın. |
field_out_of_range |
Sayısal değer, izin verilen aralığın dışında. | Değeri belgelenen aralığa çekin. |
field_invalid_enum |
Değer, kabul edilen enum üyelerinden biri değil (örn. bilinmeyen currency / network veya proje için etkinleştirilmemiş bir token). |
Enum referansını kontrol edin; token'lar için projede token+ağ çiftinin etkin olduğundan emin olun. |
field_invalid_format |
Değer, alanın beklediği biçime uymuyor — ayrıştırılamayan bir ID (örn. inv_… öneki olmayan invoice_id) veya "10.00" gibi düz bir ondalık dize olmayan bir amount. |
Alanı belgelenen biçimde gönderin; API'nin döndürdüğü ID'leri olduğu gibi kullanın. |
entity_id_empty |
Sağlanan ID tamamen sıfırlardan oluşan / boş bir GUID (00000000-0000-…). field, hatalı ID'yi adlandırır — örn. invoice_id veya withdrawal_id. |
API'nin döndürdüğü ID'yi olduğu gibi gönderin; asla sıfırlanmış veya boş ID kullanmayın. |
field_must_be_positive |
Ondalık/tamsayı değer 0'dan büyük olmalı. | Pozitif bir değer gönderin. |
field_percentage_out_of_range |
Yüzde, 0 ile 100 arasında (sınırlar dahil) olmalı. | Değeri [0, 100] aralığına çekin. |
query_parameter_unknown |
Liste isteği, uç noktanın desteklemediği bir sorgu parametresi içeriyor. | Parametreyi kaldırın veya belgelenen snake_case adını kullanın. |
pagination_cursor_invalid |
Cursor bozuk, süresi dolmuş, değiştirilmiş, başka bir kaynağa ait veya farklı filtrelerle birleştirilmiş. | cursor olmadan sayfalamayı yeniden başlatın, ardından next_cursor'u izlerken aynı filtreleri koruyun. |
amount_too_many_decimals |
Fiat akışlı faturalarda amount, para biriminin küçük biriminden fazla ondalık basamak içeriyor (örn. USD için 23.345, JPY için 23.01). |
Para biriminin küçük birimine yuvarlayın. |
amount_too_large |
Fatura veya ödeme çıkışı oluşturmadaki amount, desteklenen aralığın dışında — API'nin sakladığı 20 tam basamak tavanının üzerinde. |
Desteklenen aralık içinde bir tutar gönderin. |
Genel HTTP durum yedekleri
Hatanın bağlı olduğu özel bir iş kodu olmadığında döner. Bunların her biri bir HTTP durumu için yedektir: istek başarısız olmuştur, ancak nedeni tanımlayan daha ince taneli bir kod yoktur.
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
forbidden |
403 | Kimlik doğrulandı, ancak bu kimlik bilgisi işlemi gerçekleştiremez — kapsamı (yeteneği) veya ortamı buna izin vermiyor; örneğin yalnızca Production'a açık bir uç noktayı çağıran bir Sandbox anahtarı. | Yeteneği ve ortamı işlemle eşleşen bir kimlikle çağırın. Sahiplik asla 403 değildir: başka bir işyerine ait kaynak forbidden değil, not_found (404) döndürür. |
payment_key_required |
403 | Uç nokta bir Payment (pk_) anahtarı gerektiriyor, ancak istek bir Payout (rk_) anahtarıyla yapılmış — örneğin fatura listeleme. |
Payment anahtarıyla çağırın. |
payout_key_required |
403 | Uç nokta bir Payout (rk_) anahtarı gerektiriyor, ancak istek bir Payment (pk_) anahtarıyla yapılmış — örn. bakiye okuma. |
Payout anahtarıyla çağırın. Payout anahtarının çalışması için ayrıca bir IP beyaz listesi gerektiğini unutmayın. |
internal_error |
500 | Bizim tarafımızda beklenmeyen bir hata veya bug. | Bir kez yeniden deneyin. Devam ederse destekle iletişime geçin ve yanıtın saatini ekleyin. |
validation_failed |
400 | İstek doğrulamayı geçemedi, ancak tek bir alan düzeyi kod uymadı. | detail alanını okuyun — neyin reddedildiğini söyler. |
Kimlik doğrulama
Yalnızca HMAC kimlik doğrulama işleyicisinden dönen 401 Unauthorized yanıtlarında görülür. Her kod belirli bir hata noktasını tanımlar; böylece istemciler genel bir "kimlik doğrulama başarısız" yerine uygulanabilir bir mesaj gösterebilir.
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
unauthorized |
401 | Aşağıdaki özel kodlardan hiçbiri uymadığında kullanılan genel yedek — tipik olarak, Authorization başlığı olmadan (veya tanınmayan bir auth şemasıyla) kimlik doğrulaması gerektiren bir uç noktaya yapılan istek. |
Geçerli bir HMAC Authorization başlığı gönderin; imzalama akışını uçtan uca yeniden kontrol edin. |
authorization_missing |
401 | Authorization başlık değeri boş (gönderilmiş ama boş). |
Tam Authorization: HMAC-SHA256 {apiKeyId}:{base64signature} başlığını gönderin. |
authorization_malformed |
401 | Başlık var ama bozuk: şema ayrışıyor ancak kimlik kısmında iki nokta eksik, API anahtarı ID'si ayrıştırılamıyor veya imza boş. | Başlığı Kimlik Doğrulama bölümüne göre yeniden kurun; en yaygın neden API anahtarı ID'sindeki bir yazım hatasıdır. |
timestamp_missing |
401 | X-Request-Timestamp başlığı eksik veya pozitif bir tamsayı olarak ayrıştırılamıyor. |
Başlığı, saniye cinsinden geçerli Unix zaman damgasına ayarlayın. |
timestamp_expired |
401 | Zaman damgası, izin verilen saat kayması penceresinin dışında (varsayılan 5 dakika). | Saatinizi NTP ile eşitleyin; taze bir zaman damgasıyla yeniden imzalayın. |
invalid_credentials |
401 | Kimlik bilgisi kullanılamaz: bilinmeyen anahtar ID'si, iptal edilmiş anahtar, saklanan anahtarla eşleşmeyen bir ortam/tür öneki veya doğrulanamayan bir imza. Dört durum için kasıtlı olarak tek kod — ayırt edilebilir bir yanıt, secret'a sahip olmayan bir çağırana hangi anahtar ID'lerinin var olduğunu doğrular. | API anahtarı ID'sinin doğru ve etkin olduğunu, imzanın eşleşen secret ile hesaplandığını kontrol edin. En yaygın neden imzalamadır: string-to-sign birleştirmenizi ({ts}\n{METHOD}\n{path}\n{query}\n{bodyHash}) ve boş gövdelerde bodyHash'in boş olduğunu doğrulayın (boş dizeyi hash'lemeyin). |
ip_not_allowed |
401 | Bir Payout anahtarında IP beyaz listesi yapılandırılmış ve çağıran IP'niz listede değil. Yalnızca Payout anahtarları IP denetimi taşır — Payment anahtarları herhangi bir IP'den çağrılabilir. Denetim imza geçtikten sonra yapılır; bu yüzden yanlış ağdan gelen geçerli bir imza bile başarısız olur. | Çağıran IP'yi (veya CIDR bloğunu) panelde Payout anahtarının beyaz listesine ekleyin. |
payout_whitelist_required |
401 | Yeni üretilmiş bir Payout anahtarında henüz IP beyaz listesi yapılandırılmamış. Payout anahtarları, işyeri en az bir izinli IP ekleyene kadar etkin kalmaz — ip_not_allowed'dan ayrıdır; böylece istemciler "panel yapılandırması eksik" ile "yanlış kaynak IP"yi birbirinden ayırabilir. |
Paneli açın, API anahtarları sayfasına gidin ve Payout anahtarının IP beyaz listesine en az bir IP veya CIDR ekleyin. |
Rate limit
Bir istek işyeri başına rate limit'i aştığında 429 Too Many Requests ile döner. Sayım, anahtar başına değil işyeri başına ve bir saniyelik pencerede yapılır; kaç API anahtarınız olursa olsun hepsi aynı bütçeden harcar. API'nin önünde, IP adresi başına çalışan ayrı bir limit daha vardır; burada anlatılan, işyeri limitidir.
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
rate_limited |
429 | İşyeri başına rate limit aşıldı. İki limit uygulanır: her uç noktada genel bir tavan (varsayılan 30 istek/sn) ve fatura oluşturmada — POST /v1/invoices — daha sıkı bir tavan (varsayılan 5 istek/sn). Yanıt hangisinin, hangi limitle devreye girdiğini söyler. |
Retry-After başlığını okuyun (saniye cinsinden geri çekilme) ve süresi dolunca yeniden deneyin; retry middleware'li çoğu HTTP istemcisi bunu otomatik olarak uygular. |
Transport / framework
İstek normal bir işleyiciye hiç ulaşmadığında framework hata işleyicisi tarafından döndürülür.
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
malformed_request |
400 | İstek gövdesi ayrıştırılamadı — bozuk JSON. | Gövdenin geçerli JSON olduğunu doğrulayın. |
payload_too_large |
413 | İstek gövdesi 1 MiB sınırını aşıyor. | Daha küçük bir yük gönderin; büyük iş yüklerini ayrı isteklere bölün. |
unsupported_media_type |
415 | Content-Type application/json değil. |
Content-Type: application/json ayarlayın. |
method_not_allowed |
405 | Yol var, ancak bu HTTP metodu için değil. | Uç nokta için belgelenen metodu kullanın (örn. oluşturmak için POST). |
route_not_found |
404 | İstek yoluyla eşleşen uç nokta yok. | URL'yi API referansıyla yeniden kontrol edin. |
Faturalar
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
invoice_not_found |
404 | Fatura ID'si hiçbir şeye çözülmüyor veya başka bir işyerine ait bir faturaya çözülüyor. | POST /v1/invoices'un döndürdüğü ID'yi olduğu gibi kullanın. |
project_not_found |
404 | Fatura oluşturma isteğindeki project_id, çağıranın görebildiği hiçbir şeye çözülmüyor. |
Panelden bir proje ID'si kullanın (aktif olmalı ve API anahtarıyla aynı işyerine ait olmalı). |
invoice_terminal |
410 | Confirm-payment, expired veya cancelled durumdaki bir faturada çağrıldı. (paid bir fatura invoice_not_awaiting_client döndürür, 409 — bu kodu değil.) |
Fatura durumunu yenileyin; yapılacak başka bir şey yok. |
invoice_deadline_passed |
410 | Confirm-payment, faturanın son tarihinden sonra çağrıldı. | Yeni bir fatura oluşturun. |
requested_amount_invalid |
400 | Fatura amount değeri eksik, bozuk, desteklenen ondalık aralığın dışında veya pozitif değil. |
amount değerini, seçilen currency ve isteğe bağlı network ile pozitif bir ondalık dize olarak gönderin. |
invoice_amount_below_minimum |
400 | Faturanın hesaplanan USD değeri, katalogdaki token başına / ağ başına minimumun altında. | Tutarı, seçilen token için gösterilen minimumun üzerine çıkarın. |
deposit_amount_exceeds_limit |
400 | Beklenen ödemenin hesaplanan USD değeri, işyerinin depozito başına MaxDepositAmount politika tavanını aşıyor. Onay anında kote edilen fatura tutarını sınırlar; zincir üzerindeki gerçek girişleri değil. |
Fatura tutarını düşürün veya limiti artırmak için destekle iletişime geçin. |
currency_not_enabled_for_project |
400 | İstenen kripto para birimi, projenin etkin token listesinde (herhangi bir ağda) yok. | Para birimini projede etkinleştirin veya projenin enabled_tokens listesinden birini seçin. |
tokens_required |
409 | Hiç etkin token'ı olmayan bir projede fatura oluşturma veya ödeme onayı. | Panelde projede en az bir token etkinleştirin. |
acceptance_disabled |
503 | İstenen token şu anda kabul edilmiyor. | Farklı bir token kullanın veya daha sonra tekrar deneyin. |
exchange_rate_unavailable |
503 | Kur sağlayıcısında token / fiat çifti için taze fiyat yok. | Yeniden deneyin; kurlar kısa aralıklarla yenilenir. |
network_unavailable |
503 | Otomatik onay, seçilen ağı kullanamadı. | Otomatik onayı bırakın; müşterinin hosted sayfa üzerinden token seçmesine izin verin. |
payment_method_unavailable |
503 | Seçilen token veya ağ şu anda ödeme kabul edemiyor. 23.08.2026 tarihinden itibaren no_available_address, address_lease_failed ve bridge_unavailable kodlarının yerini alır. |
Yeniden deneyin veya müşterinin farklı bir token ya da ağ seçmesine izin verin. |
client_confirmation_failed |
409 | Müşteri tarafı onayı (token seçimi, otomatik onay) reddedildi. detail alanı özel nedeni içerir. |
detail alanını inceleyin; yaygın durumlar: fatura awaiting_client durumunu geçmiş, token izin verilmiyor. |
invoice_not_awaiting_client |
409 | Confirm-payment, artık awaiting_client durumunda olmayan bir faturada çağrıldı. |
Fatura durumunu yenileyin; müşteri seçim aşamasını geçmiş. |
invoice_cannot_be_cancelled |
409 | Fatura artık awaiting_client durumunda değil — müşteri zaten bir token seçmiş ya da fatura ödenmiş ya da süresi dolmuş. Zaten iptal edilmiş bir faturayı yeniden iptal etmek bu hatayı değil, 200 döndürür. |
Geçerli durumu inceleyin; iptal yalnızca awaiting_client durumunda çalışır. |
simulate_payment_failed |
409 | Yalnızca sandbox'ta kullanılabilen simulate_payment reddedildi. |
detail alanını inceleyin; genellikle yanlış durum veya tutar uyuşmazlığıdır. |
not_sandbox |
403 | simulate-payment (sandbox simülatörü) bir production faturasında çağrıldı. |
Yalnızca sandbox faturaları simüle edilebilir — bir sandbox faturası kullanın veya canlı bir faturayı gerçek bir zincir üstü ödemeyle ilerletin. |
Widget faturaları
POST /public/v1/sdk (Low-Code SDK fatura oluşturma) tarafından döndürülür.
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
widget_key_missing |
401 | Widget auth gerektiren bir uç noktada X-Sdk-Key başlığı yok veya boş. |
Public SDK anahtarını X-Sdk-Key içinde gönderin. |
widget_key_invalid |
401 | X-Sdk-Key var ancak bir Paymos API anahtarı ID'si olarak ayrıştırılamıyor. |
Anahtarı panelden kopyalayın; başındaki/sonundaki boşlukları, yanlış öneki veya yanlışlıkla yapılmış URL-encoding'i kontrol edin. |
widget_key_not_found |
401 | Anahtar ayrışıyor ancak etkin bir kimliğe çözülmüyor — iptal edilmiş, silinmiş veya Payment türünde değil (Payout anahtarları widget'ı çalıştıramaz). | Panelden etkin bir Payment anahtarı kullanın. |
widget_inactive |
403 | Hedef projenin widget'ı kapalı veya widget'ı hiç başlatılmamış. | Proje ayarlarında widget'ı etkinleştirin. |
terminal_not_enabled |
403 | İstek source=terminal ile geldi, ancak projenin entegrasyon yöntemi Terminal değil. |
Terminal türünde bir proje oluşturun ya da Low-Code projeden source=embed gönderin. |
embed_not_enabled |
403 | İstek source=embed ile geldi, ancak projenin entegrasyon yöntemi Low-Code değil. |
Projenin kendi entegrasyon yöntemini kullanın ya da Low-Code proje oluşturun. |
origin_not_allowed |
401 | Tarayıcı Origin'i izin verilen origin politikasıyla eşleşmiyor. Denetim iki kez çalışır — auth katmanı origin'i anahtardaki tüm etkin-widget projelerinin birleşimiyle, işleyici ise tam hedef projeyle eşleştirir — ve ikisi de aynı 401, aynı kod ve aynı detay ile yanıt verir. Bu bilinçli: ikinci denetimin farklı bir durum döndürmesi, herkese açık ve kazınabilir pk_ anahtarını elinde tutan bir çağırana origin'in aynı satıcının başka bir projesinde kayıtlı olduğunu söylerdi; staging host'ları ve duyurulmamış markalar tek tek sorgulanarak sayılabilirdi. |
Alan adını widget'ın izin verilen origin'lerine ekleyin. Aynı-origin istekler — örn. aynı host'tan servis edilen bir POS terminali — denetimi atlar. |
Ödeme kanalları
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
payment_channels_disabled |
503 | Ödeme kanalları, bu ortamda hesabınız için etkin değil. Sandbox simülatörü dahil her kanal ve yatırma uç noktası bu yanıtı verir. | Etkinleştirme için destekle iletişime geçin. Yeniden denemek yanıtı değiştirmez. |
payment_channel_not_found |
404 | pc_ kimliği, bu kimlik bilgisinin görebileceği hiçbir şeye çözülmüyor — kayıt yok, başka bir işyerine ait, diğer ortamda ya da anahtarın kapsamı dışındaki bir projede. Dördü de bilinçli olarak ayırt edilemez. |
POST /v1/payment-channels'ın döndürdüğü kimliği olduğu gibi, aynı ortam ve proje için üretilmiş bir anahtarla imzalayarak kullanın. |
payment_channel_deposit_not_found |
404 | pcd_ kimliği, bu kimlik bilgisinin görebileceği hiçbir şeye çözülmüyor. Nedenler yukarıdakiyle aynı dört başlıktır. |
Webhook yükündeki veya sorgu akışındaki kimliği olduğu gibi kullanın. |
payment_channel_external_id_invalid |
400 | external_id boş, yalnızca boşluk ya da 128 karakterden uzun — oluşturmada veya liste filtresinde. |
En fazla 128 karakterlik, boş olmayan bir kimlik gönderin. |
payment_channel_project_has_no_supported_tokens |
409 | Proje, bir ödeme kanalının tahsil edebileceği hiçbir token'ı etkinleştirmiyor; bu yüzden kanalın tek bir rotası bile olmazdı. | Projede desteklenen en az bir token'ı etkinleştirin, sonra kanalı oluşturun. |
payment_channel_simulation_sandbox_only |
403 | simulate-deposit, bir production kanalında çağrıldı. |
Simülasyon yalnızca sandbox kanalları içindir. Production kanalını gerçek bir transferle ilerletin. |
payment_key_required |
403 | İstek, Payout (rk_) anahtarıyla imzalandı. Kanal erişimi Payment anahtarına bağlıdır; tıpkı çekimlerin Payout anahtarına bağlı olması gibi. |
Aynı ortamın pk_ anahtarıyla imzalayın. |
pagination_cursor_invalid |
400 | Liste veya akış imleci bozuk, 24 saatten eski ya da farklı filtrelere bağlı — akışta ayrıca farklı bir işyerine, ortama veya proje kapsamına. | İlk sayfadan yeniden başlayın. pcd_ kimliğiyle yinelenenleri ayıkladığınız için tam bir yeniden senkronizasyon zarar vermez. |
currency_not_enabled_for_project |
400 | simulate-deposit'e verilen token, projenin etkin token listesinde yok. |
Token'ı projede etkinleştirin ya da kanalın networks[].tokens içinde zaten döndürdüğü bir token seçin. |
acceptance_disabled |
503 | İstenen token için tahsilat şu anda platform genelinde kapalı. | Farklı bir token kullanın veya kabul yeniden açılana kadar bekleyin. |
amount_too_many_decimals |
400 | Simüle edilen tutar, token'ın desteklediğinden fazla ondalık basamak içeriyor. Satıcı parası hiçbir zaman sessizce yuvarlanıp başka bir sayıya dönüşmez. | Tutarı, göndermeden önce token'ın hassasiyetine yuvarlayın. |
Ödeme çıkışları
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
withdrawal_not_found |
404 | Ödeme çıkışı ID'si hiçbir şeye çözülmüyor veya başka bir işyerine ait bir ödeme çıkışına çözülüyor. | POST /v1/withdrawals'ın döndürdüğü ID'yi olduğu gibi kullanın. |
insufficient_balance |
409 | İşyerinin kullanılabilir bakiyesi amount + fee toplamının altında. |
Bakiye yükleyin veya ödeme çıkışı tutarını düşürün. |
whitelist_required |
403 | Hedef adres, seçilen ağ için beyaz listede değil. (Ağ beyaz listeyi destekliyor; bu adres henüz eklenmemiş.) | Adresi beyaz listenize ekleyin, ardından yeniden deneyin. |
destination_address_invalid |
400 | Adres, ağın biçim / checksum doğrulamasını geçemiyor. | Adresi ağın spesifikasyonuna göre yeniden kontrol edin. |
withdrawal_amount_below_minimum |
400 | Tutar, seçilen token için politika minimumunun altında. | Tutarı minimumun üzerine çıkarın (detail içinde döndürülür). |
withdrawal_quota_exceeded |
409 | Aktif ödeme çıkışı sayısı, işyerinin politika limitine ulaştı. | Devam eden ödeme çıkışlarının tamamlanmasını bekleyin veya limiti artırmak için destekle iletişime geçin. |
withdrawal_amount_exceeds_limit |
400 | Ödeme çıkışı anaparasının USD karşılığı, işyerinin işlem başına MaxWithdrawalAmount politika tavanını aşıyor. |
Tutarı düşürün veya limiti artırmak için destekle iletişime geçin. |
exchange_rate_unavailable |
503 | İşyerinde MaxWithdrawalAmount tavanı tanımlı, ancak anaparayı buna karşı denetlemek için taze token/USD fiyatı yok — limit doğrulanamıyor, bu yüzden istek kapalı başarısız olur. |
Yeniden deneyin; kurlar kısa aralıklarla yenilenir. |
withdrawal_not_enabled |
400 | Paymos, istediğiniz token/ağ çiftinde ödeme yapmıyor. detail çifti adlandırır — örn. Withdrawals are not available for USDT on TRC20. Hangi çiftlerin ödenebilir olduğu bizim yapılandırmamızdır, sizinki değil. |
Token'ı Paymos'un ödeme yaptığı bir ağda çekin veya ihtiyacınız olan çifti sormak için destekle iletişime geçin. |
withdrawal_cannot_be_cancelled |
409 | Ödeme çıkışı, iptal edilebileceği durumu geçmiş. | Geçerli durumu inceleyin. Pencere, yürütme başladığı anda kapanır — hâlâ created içindeyken, herhangi bir şey imzalanmadan önce. |
withdrawal_simulation_failed |
409 | Yalnızca sandbox'ta kullanılabilen simulate_completion reddedildi. |
detail alanını inceleyin. |
merchant_suspended |
403 | İşyeri hesabı giden akışlar için askıya alınmış; bu yüzden ödeme çıkışı oluşturulamaz. | Askıyı kaldırmak için destekle iletişime geçin. |
outbound_frozen |
503 | Giden transferler dondurulmuş — ya platform genelinde ya da çekim yaptığınız belirli ağ ve token için. | Dondurmanın kalkmasını bekleyin, farklı bir ağ/token deneyin veya destekle iletişime geçin. |
withdrawal_network_unavailable |
503 | Bu token'ın bu ağdaki ödeme çıkışları şu anda gerçekleştirilemiyor. | Farklı bir hedef ağ deneyin veya daha sonra tekrar deneyin. |
Proje durumu
Proje, mevcut durumunda fatura kesemiyorsa fatura oluşturma ve ödeme onayı tarafından döndürülür.
| Kod | HTTP | Ne zaman | Ne yapmalı |
|---|---|---|---|
project_state_invalid |
409 | Proje Active değil — Suspended veya Archived. Yanıt hangisi olduğunu söylemez. |
Panelde projenin durumunu kontrol edin: arşivlendiyse geri yükleyin, askıya alındıysa etkinleştirin. Ya da isteği zaten aktif olan bir projeye gönderin. |