Skip to content

Delete Payer

Overview

The delete payer interface is used to remove secondary payment entities under the merchant that are no longer in use. Once deleted, the payer's payerId will become invalid and can no longer be used for subsequent payment requests.

Important Reminder

Deletion operations are usually irreversible, please proceed with caution!

Applicable Scenarios

ScenarioDescriptionRecommendation
Business TerminationSub-merchant business terminated, need to remove associated accountRecommend deletion
Test DataPayers created during testing need cleanupRecommend deletion
Compliance CleanupCompliance requires regular cleanup of expired sub-merchant informationRegular cleanup
Institutional AdjustmentOrganizational restructuring, certain entities no longer neededRecommend deletion
Account ConsolidationConsolidating multiple accounts into oneCarefully evaluate before deletion

Pre-Deletion Checks

Before deleting a payer, please confirm the following:

Checklist

Must Check

  • Confirm no payment tasks in process - If there are transactions being processed, please wait for completion before deletion
  • Confirm no planned payments - Check if there are scheduled tasks or scheduled payments
  • Confirm necessary historical records are saved - Financial reconciliation, audit records, tax vouchers, etc.
  • Evaluate impact on business - Are there other systems or processes depending on this payer

Operation Process

Step 1: Obtain Payer ID and Detailed Information

  1. Call query interface Query Payer Interface to get corresponding payer list and corresponding payerId.
  2. If there are many payers, you can filter by name, country, registration time, etc. to locate the payer to be deleted.
  3. View detailed information of target payer, confirm entity identity, business type and current status to ensure correct deletion target.

Step 2: Execute Deletion Operation

  1. Call delete interface Delete Payer Interface
  2. Pass payerId

Step 3: Confirm Deletion Result

After deletion:

  • Call query interface, query the payerId, return result is empty [Query Payer Interface]
  • Can no longer be used to initiate payments
  • Historical records can still be queried (for auditing)

Delete vs Other Operations

When Should You Delete?

Recommended Deletion Situations:

  • Sub-merchant permanently stops operating
  • Test data needs cleanup
  • Compliance requires data cleanup
  • Confirmed no longer need this payment entity

When Should You Not Delete?

Not Recommended Deletion Situations:

  • Information needs update (recommend update)
  • There are incomplete transactions
  • During financial audit period

FAQ

Q1: Can it be recovered after deletion?

Answer

Cannot be recovered, needs to be recreated Recommend confirming deletion type clearly before deletion.

Q2: Can historical transaction records still be found after deletion?

Answer

Yes. Even if the payer is deleted, historical transaction records are usually retained for:

  • Financial reconciliation
  • Audit tracing
  • Compliance reporting

Q3: Can it be deleted when there are transactions in process?

Answer

No. The system will prevent the deletion operation, must wait for all transactions to complete before deletion.

This is to ensure:

  • Transaction integrity
  • Fund security
  • Record traceability

Q4: Can payerId be reused after deletion?

Answer

No. Each payerId is unique and will not be reassigned to new payers after deletion.

Q5: What if deleted by mistake?

Answer

Need to recreate the payer

Q6: Is batch deletion of payers supported?

Answer

The system currently does not support batch deletion interface.