Update Payer
Overview
The update payer interface is used to modify existing payer information. When the payer's address, contact person, email or ID validity period changes, you can update the relevant information through this interface.
Important Note
The update operation will not change payerId, only modify the payer's related information.
Applicable Scenarios
| Scenario | Description | Example |
|---|---|---|
| Incorrect Information | Information filled incorrectly during creation needs correction | Address, phone, email errors |
| ID Update | ID expiration requires re-upload | Business license, ID card expiration |
| Address Change | Sub-merchant's registered address changes | Office relocation, registered address change |
| Contact Change | Contact person or contact information update | Responsible person change, phone change |
| Regular Maintenance | Regularly update information to maintain accuracy | Annual information verification |
Operation Process
Step 1: Query Current Information
- Call query interface Query Payer Interface
- Get current complete payer information
Why Query First?
Querying first ensures you understand the current complete information, avoiding overwriting fields that don't need modification.
Step 2: Prepare Update Data
Determine fields to be modified Update Payer Interface:
- Address information
- Contact information
- Contact email
- Contact phone
- ID information
Step 3: Submit Update Request
- Call update interface Update Payer Interface
- Pass payerId + update fields
Step 4: System Verification
System verifies update content:
- Data format verification
- Required field check
- Compliance verification
Update vs Recreate
| Comparison | Update Payer | Recreate Payer |
|---|---|---|
| payerId | Remains unchanged | Will generate new ID |
| Historical Records | Retained | Lost |
| Associated Transactions | Maintain association | Need to re-associate |
| Review Duration | Usually faster | Requires complete review |
| Applicable Scenario | Information change | Completely new legal entity |
Recommendation
Unless it's a completely different legal entity, prioritize using the update interface rather than delete and recreate.
FAQ
Q1: How soon after updating can it be used for payment?
Answer
- Takes effect immediately
Q2: Can only partial fields be updated?
Answer
Yes. You only need to pass the fields that need to be updated, other fields remain unchanged.
Q3: What if update fails?
Answer
Check the following:
- Are required fields complete
- Is data format correct
- Are newly uploaded IDs clear and valid
- Is signature correct
- Does payerId exist
Q4: Will update operation affect payments in process?
Answer
- Will not affect payments in process
Q6: Can updates be revoked?
Answer
Cannot be automatically revoked. If you need to restore original information, you need to call the update interface again with the original data.
Recommendation: Save original information before updating for restoration if necessary.