İçeriğe atlayın

API

Bu sayfada

Engelle

Kanalı silmeden, adreslerini bırakmadan ve alınmış ödemelere dokunmadan yeni yatırmaların o kanala işlenmesini durdurun.

POST/v1/payment-channels/:payment_channel_id/block

API anahtarı: Payment

Bir kanalı kullanımdan kaldırmanın yolu engellemektir. Silme yoktur: müşterinin kaydettiği bir adres asla başkasına ait olmaya başlamamalıdır. Kayıt da rotalar da yerinde kalır; değişen tek şey, yeni yatırmaların artık bu kanala işlenmemesidir.

İstek gövdesi yoktur.

Engelleme ne yapar

  • Yeni yatırmalar artık bu kanala işlenmez.
  • status blocked, is_accepting_payments ise false olur.
  • Adresler ne serbest bırakılır ne de yeniden atanır. Sonsuza dek bu kanalda kalırlar.
  • Alınmış yatırmalara dokunulmaz. Engellediğiniz anda hâlâ confirming olan bir yatırma yine confirmed durumuna ulaşır, yine deftere işlenir, webhook'unu yine tetikler ve akışta yine görünür.
  • Adres hazırlığı durmaz. Kurulumu süren ağlar ilerlemeye devam eder; böylece engeli sonradan kaldırdığınızda tamamen hazır bir kanal bulursunuz.

Zaten engellenmiş bir kanalda çağrıyı tekrarlamak hiçbir şeyi değiştirmez; aynı kanalı 200 OK ile döndürür.

Yanıt (200 OK)

Ödeme Kanalı Getir ile aynı biçimde tam kanal nesnesi; status artık blocked, is_accepting_payments artık false. networks dizisinin tamamı dahil diğer her alan değişmeden kalır.

Hatalar

Kod HTTP Ne zaman
payment_channels_disabled 503 Ödeme kanalları, bu ortamda hesabınız için etkin değil.
payment_key_required 403 İstek, Payout (rk_) anahtarıyla imzalandı.
payment_channel_not_found 404 Kimlik, bu kimlik bilgisinin görebileceği hiçbir şeye çözülmüyor.
field_invalid_format 400 Yol parçası geçerli bir pc_ kimliği değil.

Tam katalog için bkz. Hata Kodları; bu işlemi geri almak için Ödeme Kanalının Engelini Kaldır.