Skip to main content
Whop, bir kullanıcıdan ek bir şeye (bir belge, vergi kimlik numarası veya işletme ayrıntısı) ihtiyaç duyduğunda bir Bilgi Talebi (RFI) oluşturur. Her açık RFI, doğrulamanın requested_information dizisinde görünür. Kullanıcı her öğeyi yanıtlayana kadar doğrulamanın status değeri action_required olarak kalır. Her öğe toplanacak bir şeyi temsil eder ve tek bir yazma işlemiyle yanıtlanır. requirement neyin gerektiğini adlandırır, girdi type değeri bunu nasıl toplayacağınızı söyler ve label kullanıcıya gösterilecek metni sağlar. Yanıt, bir öğe için geçerli olmayan anahtarları içermez. Tam katalog için her gereksinim bölümüne bakın.

RFI’ler nasıl çalışır

1

Bilgi talep edilir

Whop bir şeyin gerektiğini işaretler. Doğrulama durumu action_required olarak değişir ve bir identity_profile.updated webhook’u tetiklenir. (identity_profile.needs_action da bu geçiş için tetiklenir, ancak identity_profile.updated her durum değişikliğini kapsayan genel olaydır; ona abone olun ve neyin beklediğini görmek için doğrulamayı yeniden getirin.)
2

Öğeleri okursunuz

GET /api/v1/verifications?account_id={biz_ tag} çağrısını yapın. Her doğrulamadaki requested_information dizisi neyin gerektiğini ve ne tür bir yanıt toplanacağını listeler.
3

Toplar ve gönderirsiniz

Bilgiyi kullanıcınızdan alın ve bir requested_information dizisiyle PATCH /api/v1/verifications/{id} üzerinden geri gönderin. Whop her yanıtı doğru yere yönlendirir.
4

İnceleme devam eder

Yanıtlanan öğeler diziden çıkar. Dizi boşaldığında, yanıtlar incelenirken doğrulama processing durumuna geçer; bu durumda gönderilecek bir şey yoktur. Sonuç approved olur veya bir uyumluluk incelemesi açılırsa manual_review olur. Bir yanıt reddedilirse öğe, nedenini açıklayan errors ile action_required durumuna döner. Yeniden gönderin.

RFI’leri okuma

cURL
Bekleyen RFI’ler olduğunda doğrulama şöyle görünür:

Öğe alanları

Yanıt yalnızca bir öğe için geçerli olan anahtarları döndürür; bu nedenle bir öğe hiçbir zaman kontrol etmeniz gereken boş bir dizi veya null taşımaz. Yanıt yalnızca açık öğeleri döndürür; yanıtlanan öğeler diziden çıkar, bu nedenle dizide bulunan her şey kullanıcının hâlâ sağlaması gereken şeydir. Dizi boşalana kadar doğrulama action_required olarak kalır.

RFI’leri yanıtlama

Doğrulamanın idpf_ etiketine bir requested_information dizisiyle PATCH gönderin. Her girdi, öğe id değerini ve öğenin type değeriyle eşleşen tam olarak bir yanıt yükünü gerektirir: Yanıt öğeden başka hiçbir şeyi yansıtmaz; kategori veya belge türü yoktur. Öğe id değeri, Whop’a yanıtın nereye ait olduğunu söyler. Tek bir istekte birden fazla öğeyi yanıtlayabilirsiniz:
cURL

Metin, tarih, telefon ve seçim değerleri

Yanıtı value olarak iletin. Tarihler YYYY-MM-DD, telefon numaraları E.164 biçimini (+12125550123) kullanır ve seçim değerleri öğenin options değerlerinden biri olmalıdır.

Adresler

Bir address nesnesi iletin:
cURL
Kişisel veya işletme adresleri için posta kutuları kabul edilmez.

Belgeler

Önce dosyayı yükleyin, ardından kimliğini files içinde iletin:
cURL
Her girdi, yükleme akışından bir file_ kimliği veya doğrudan bir yüklemeden bir direct_upload_id alır. Belgeler en fazla 32 MB boyutunda Joint Photographic Experts Group (JPEG), Portable Network Graphics (PNG) veya PDF dosyaları olmalıdır. Tek sayfalık bir belge, tek öğeli bir listedir; ayrı bir tek dosya alanı yoktur. requirement, Whop’un ihtiyaç duyduğu belgeyi adlandırır ve gerisini Whop halleder; ne tür bir belge yüklediğinizi hiçbir zaman belirtmezsiniz.

Birden fazla sayfalı belgeler

Birden fazla sayfası olan bir belge, sayfa sırasına göre aynı files listesine girer:

Kimlik belgeleri

Bir id_document öğesi hangi kimlik olduğunu sorar. İncelemenin kabul ettiği kimlik türlerini listeleyen options taşır ve yanıt, her yuvayı Create Verification ile aynı anahtarlarla adlandırır:
cURL
Anahtar hem belgeyi hem de yüzü aynı anda adlandırır; bu nedenle belgenin hangi kimliği temsil ettiği için ayrı bir alan yoktur, Whop bunu anahtarlardan çıkarır. Yüklediğiniz kimlik için her yuvayı gönderin: Whop, iki belgeden karışık yuvaları veya eksik bir belgeyi herhangi bir şey saklamadan önce reddeder. Öğedeki options, o incelemenin hangi kimlik türlerini kabul ettiğini belirtir. Bir dosya öğesinin options değeri yoksa value gerektirmez.

Hassas değerler

Vergi ve devlet kimlik numaralarını (ssn, ein, company_tax_id, personal_id_number) diğer değerler gibi gönderin. Whop bunları aktarım sırasında güvenli belirteçlerle değiştirir ve yalnızca güvenli referansı saklar:
cURL
Değerleri zaten kendiniz tokenize ediyorsanız (Basis Theory), bunun yerine belirteç kimliğini value_type: "vault_token" ile iletin.

Reddedilen yanıtlar

Whop gönderilen bir yanıtı reddederse, öğe errors ayarlanmış olarak requested_information içine geri döner:
reason değerini kullanıcınıza gösterin ve gerekirse code değerine göre dallanın. Tanınmayan kodları genel bir ret olarak ele alın. Temeldeki sorunu düzeltin ve aynı öğe id değeriyle yeniden gönderin. Whop düzeltilmiş yanıtı kabul edene kadar doğrulama action_required olarak kalır.

Belge reddi kodları

Whop yüklenen bir belgeyi reddettiğinde, code belgede neyin yanlış olduğunu adlandırır. Alabileceğiniz kodlar şunlardır: Buradaki her kod, yüklemeyle ilgili düzeltilebilir bir sorunu tanımlar. Whop’un bunlardan birine bağlayamadığı bir ret, kullanılamaz bir kod yerine hiç errors döndürmez. errors içermeyen bir öğeyi her zaman ele alın ve kullanıcıya gösterilecek metin için reason değerini tercih edin.

Her gereksinim

Her öğenin requirement değeri aşağıdaki değerlerden biridir.

Kişisel ayrıntılar

Vergi ve devlet kimlik numaraları

Whop bu değerleri aktarım sırasında güvenli belirteçlerle değiştirir; bkz. hassas değerler.

Kimlik belgeleri

İşletme ayrıntıları

İşletme belgeleri

Ödeme hesabı belgeleri

Bir ödeme hedefini doğrulamak için talep edilen bir belge, belgenin kendisini adlandırır. Tek bir dosya yükleyin; label, kullanıcınıza belgenin hangi hesap için olduğunu söyler.

İnceleme soruları