Erişebileceğiniz hesapları filtreleyin

Merchant Accounts API'sini kullanarak, alt hesaplar dahil olmak üzere erişiminizin olduğu hesapların filtrelenmiş bir listesini görüntüleyebilirsiniz. Görünen adlara ve diğer hesaplarla ilişkilere göre filtreleme yapabilirsiniz. Örneğin, hesap bağlama isteğini henüz kabul etmeyen tüm mağazalarınızı görmek için görünen adları "store" dizesini içeren ve bağlantı durumu PENDING olan hesapları filtreleyebilirsiniz.

Tüm alt hesaplarınızı görüntülemek için accounts.v1beta.accounts.listSubAccounts numaralı telefonu arayın.

Alt hesaplar ve User olarak kullandığınız hesaplar da dahil olmak üzere erişiminiz olan tüm hesapların filtrelenmiş listesini görüntülemek için accounts.v1beta.accounts.list numaralı telefonu arayın ve filter alanında filtre ölçütlerinizi belirtin.

filter alanının söz dizimiyle ilgili ayrıntılar için filtre söz dizimi referansına bakın.

Kullanabileceğiniz filtre türleri şunlardır:

Hesap filtreleri

account düzeyinde filtreleme yapmak için aşağıdaki alanları kullanabilirsiniz:

• accountName: account kaynağının accountName değerine göre filtreler.
• relationship(...): Hesabın başka bir hesapla olan ilişkisinin türüne göre filtreleme yapar. Tek bir isteğe birden fazla relationship(...) filtresi ekleyebilirsiniz.

İlişki filtreleri

relationship(...) işlevini kullanarak aşağıdaki ölçütlere göre filtre uygulayabilirsiniz:

• providerId: Servis sağlayıcının satıcı kimliği. Örneğin, filtrenin yalnızca account/123 tarafından sağlanan bir hizmete sahip hesapları döndürmesi gerekiyorsa providerId = 123 değerini kullanın.
• callerHasAccessToProviderFilter(): Erişiminiz olan bir servis sağlayıcıyla ilişkisi olan hesapları filtreler.
• externalAccountId: Servis sağlayıcının, hizmet sağladığı hesaba ait harici hesap kimliği.
• accountIdAlias: İlişki için yapılandırılan hesap kimliği takma adı.
• service(...): İlişkinin bir parçası olarak sağlanan hizmet. Bir relationship(...) işlevine birden fazla service(...) işlevi ekleyebilirsiniz.

Hizmet filtreleri

Hesapları, ilişkilerine ve sağladıkları hizmet türlerine göre daha fazla filtrelemek için service(...) işlevini kullanabilirsiniz:

• handshakeState: İki hesap arasındaki hizmet sözleşmesinin durumudur. Aşağıdaki değerleri kabul eder:
  • PENDING
  • APPROVED
• type: Sağlayıcı tarafından verilen hizmetin türü. Aşağıdaki değerleri kabul eder:
  • ACCOUNT_MANAGEMENT Hesabı sağlayıcı yönetir.
  • ACCOUNT_AGGREGATION Sağlayıcı, hesabı toplayan bir kuruluştur.

Örnekler

Aşağıda, deneyebileceğiniz filtre örnekleri verilmiştir.

Görünen adları "mağaza" kelimesini içeren hesapları ve "123" kimliğine sahip sağlayıcıları filtreleyin:

accountName = "*store*" AND relationship(providerId = 123)

"123" hesabının tüm alt hesapları için filtre uygulayın:

relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))

Onaylı hesap yönetim hizmetleri sunan hesapları filtreleyin:

relationship(service(handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))

Belirli bir takma ada ve kimliğe sahip olan, bir sağlayıcıya erişimi olan hesapları filtreleyin. Bu istek için sağlayıcıya da erişiminiz olmalıdır:

relationship(callerHasAccessToProviderFilter() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")

Sırada ne var?

• Hesapları filtreleme hakkında daha fazla bilgi için Filtre söz dizimi bölümüne bakın.