Query Payer
Overview
The query payer interface is used to obtain all created payer information under the primary merchant. This interface returns a full list of payers under the merchant and their corresponding payerId, used to view and manage all payer entities.
Usage Scenario
Through this interface, you can obtain basic information and status of all payers under the merchant, convenient for selecting appropriate payer to initiate payment operations.
Applicable Scenarios
| Scenario | Description |
|---|---|
| Get Available Payers | Get list of all payers under merchant, select available payerId to initiate payment |
| Payer Management | View registration information, review progress and status of all payers under merchant |
| Status Monitoring | Batch check review status and information changes of all payers |
| Data Synchronization | Synchronize payer list to business system for management |
Operation Process
Step 1: Call Query Interface
Call query interface Query Payer Interface to get payer list
Step 2: Obtain List Information
System returns all payer information under merchant, including:
- Payer ID (
payerId) - Company name
- Registered country
- Address information
- Contact information
- ID information
- Current status
Step 3: Locate Your Desired Payer
Filter your desired payer based on status and payer information
FAQ
Q1: Is there a call frequency limit for query interface?
Answer
Usually there is a frequency limit, recommended:
- List Query - Not to exceed 100 times/minute
- Recommend Using Cache - Reduce duplicate queries, can cache for 1-24 hours
Q2: What is returned if there are no payers under the merchant?
Answer
Will return empty list
Q3: After payer information is updated, how soon can the latest information be queried?
Answer
Takes effect immediately. After update interface is successfully called, query interface can immediately obtain the latest information.
Q4: Is there a quantity limit for the returned list?
Answer
Returns full payer list under merchant, no quantity limit. If the number of payers is very large (such as exceeding 100), recommend: Filter and display pagination according to business needs
Q5: How to quickly find available payers?
Answer
Filter from returned list by account status and payer information.