Filter akun yang dapat Anda akses

Anda dapat menggunakan Merchant Accounts API untuk melihat daftar akun yang difilter yang dapat Anda akses, termasuk sub-akun. Anda dapat memfilter berdasarkan nama tampilan, dan hubungan dengan akun lain. Misalnya, Anda dapat memfilter akun dengan nama tampilan yang berisi string "store", yang juga memiliki status link PENDING, untuk melihat semua toko yang belum menerima permintaan penautan akun.

Untuk melihat semua sub-akun, panggil accounts.v1beta.accounts.listSubAccounts

Untuk melihat daftar semua akun yang aksesnya Anda miliki yang difilter, termasuk sub-akun dan akun apa pun yang memiliki Anda sebagai User, telepon accounts.v1beta.accounts.list dan tentukan kriteria filter di kolom filter.

Guna mengetahui detail sintaks untuk kolom filter, lihat sintaksis filter referensi.

Berikut adalah jenis filter yang dapat Anda gunakan:

Filter akun

Anda dapat menggunakan kolom berikut untuk memfilter di tingkat account:

• accountName: Memfilter menurut accountName dari resource account.
• relationship(...): Memfilter menurut jenis hubungan yang dimiliki akun dengan akun lain. Anda dapat menyertakan beberapa filter relationship(...) dalam satu permintaan.

Filter hubungan

Anda dapat menggunakan fungsi relationship(...) untuk memfilter berdasarkan hal berikut kriteria:

• providerId: ID penjual penyedia layanan. Misalnya, jika filter seharusnya hanya menampilkan akun yang memiliki layanan yang disediakan oleh account/123, gunakan providerId = 123.
• callerHasAccessToProviderFilter(): Filter untuk akun yang memiliki dengan penyedia layanan yang dapat Anda akses.
• externalAccountId: ID akun eksternal penyedia layanan untuk akun layanan yang disediakan.
• accountIdAlias: Alias ID akun yang dikonfigurasi untuk hubungan.
• service(...): Layanan yang disediakan sebagai bagian dari hubungan. Anda dapat menyertakan beberapa fungsi service(...) dalam satu relationship(...) .

Filter layanan

Anda dapat menggunakan fungsi service(...) untuk memfilter akun lebih lanjut berdasarkan status hubungan mereka, dan jenis layanan yang terkait dengan hubungan tersebut menyediakan:

• handshakeState: Status perjanjian layanan antara dua akun. Menerima nilai berikut:
  • PENDING
  • APPROVED
• type: Jenis layanan yang diberikan oleh penyedia. Menerima persyaratan berikut nilai-nilai:
  • ACCOUNT_MANAGEMENT Penyedia mengelola akun.
  • ACCOUNT_AGGREGATION Penyedia merupakan agregator akun.

Contoh

Berikut beberapa contoh filter yang dapat Anda coba.

Filter untuk akun dengan nama tampilan yang berisi "toko" dan penyedia layanan dengan ID "123":

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

Filter semua sub-akun akun "123":

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

Filter untuk akun dengan layanan pengelolaan akun yang disetujui:

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

Filter untuk akun dengan alias dan ID tertentu, yang memiliki akses ke penyedia. Anda juga harus memiliki akses ke penyedia untuk permintaan ini:

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

Langkah berikutnya

• Untuk informasi selengkapnya tentang cara memfilter akun, lihat Filter sintaksis.