Name Mismatch Handling

Overview

For Pay Out transactions, Xenith provides a Name Mismatch Handling feature that validates the recipient’s bank account name you submitted against the bank records. There are three available configurations:

  • Automatic Cancellation – Transactions with mismatched names are automatically cancelled, the account name returned by the bank (based on official records) will be included in the cancelled callback.
  • Manual Review – Mismatched transactions are flagged for your team to review in the dashboard, where you can choose to approve or cancel them.
  • Hybrid Handling – Transactions with mismatched names are handled using a combination of automatic cancellation and manual review based on configurable mismatch thresholds. You can define which threshold range should trigger automatic cancellation and which range should require manual review. This is useful for grey-area cases where the mismatch may be caused by minor differences, such as titles or abbreviations.

Currently, only IDR, MYR, and VND are supported for Name Mismatch Handling.

By default, Name Mismatch Handling is configured as Automatic Cancellation with a similarity threshold of 70%. This means any Pay Out transaction with a mismatch and similarity score below 70% will be automatically cancelled.

If you prefer to handle name mismatches using Manual Review or Hybrid Handling, you may request to change this setting by contacting us through your communication channel or by emailing [email protected]

Validation Logic

To determine whether there's a name mismatch between the name you submitted and the actual name from the bank, we follow this process:

  1. Preprocessing

    1. Trim all blank spaces (leading, trailing, and in-between multiple spaces).
    2. Remove stop words, honorifics, titles, symbols.
    3. Convert all characters to lowercase to avoid case sensitivity issues.
  2. Character Sorting

    1. Alphabetically sort the characters in both the submitted name and the actual name returned from the bank.
    2. This helps reduce issues due to transposition or different name orders.
  3. Smart Name Matching

    We use two methods to determine whether the submitted name matches the bank account holder's name:

    1. Levenshtein Similarity: After normalization and sorting, we calculate the similarity between both names. A score of 70% or higher is considered a match by default. Check Levenshtein similarity between two names using tools like https://awsm-tools.com/levenshtein-distance. You can request a different threshold through your communication channel or at [email protected].

    2. AI-Assisted Name Matching: Our AI engine checks whether both names belong to the same person, considering common name variations and regional naming conventions. This includes names shortened by banks (truncation), titles and honorifics, abbreviations, different name orders, and spelling differences.
      Both results are combined to determine whether the payout proceeds, is cancelled, or requires manual review, based on your Name Mismatch Handling settings. A similarity score above the configured threshold does not guarantee approval, as both checks contribute to the final decision.

      Submitted NameActual Bank NamePreprocessed & Sorted (Submitted Name)Preprocessed & Sorted (Actual Bank Name)Levenshtein Similarity (70% Threshold)AI-Assisted Name MatchingFinal Outcome
      Wiranto AndiAndi Wirantoaadiinnortwaadiinnortw100%MatchedApproved
      Nguyễn Thị MaiMai Nguyen Thiyaeghiimnntuyaeghiimnntuyy92.31%MatchedApproved
      Andi Wiranto HadiAndi Wiraaaaddhiiinnortwaadiinrw53.33%UncertainManual Review
      Nguyễn Thị MaiNguyen Maiaeghiimnntuyaegimnnuy75%UncertainManual Review
      Mohd Rizal bin AhmadMuhammad Rizal bin Ahmadaaabddhhiilmmnorzaaaaabddhhiilmmmmnruz71.43%Matched (abbreviation)Approved
      Mohammad Ahmad Hafiz bin RoslanMOHAMMAD AHMAD HAFIaaaaaabddfhhhiilmmmmnnoorszaaaaaddfhhhimmmmo62.96%Matched (bank truncation)Approved
      Bapak Andi PratamaAndi Pratamaaaaadimnprtaaaadimnprt100%Matched (title/honorific)Approved
      Faizal bin HamidFaizal binti Hamidaaabdfhiiilmnzaaabdfhiiiilmntz87.5%Uncertain (different naming meaning)Manual Review
      Damar WicaksanaPT DAMAR WICAKSANAaaaaacdikmnrswaaaaacdikmnprstw87.5%Uncertain (individual vs. company)Manual Review

      Illustrative examples only. AI decisions are illustrative, not confirmed engine outputs.

Handling Name Mismatch (Automatic Cancellation)

Transactions with recipient name mismatches are automatically cancelled. The cancellation callback will include the account name returned by the bank based on official records (see "errorMessage"). Example:

{
  "data": {
    "id": "payout-360-01KMMX4RZ2A6NZVZMKK6ZMWCEH",
    "status": "CANCELLED",
    "currency": "IDR",
    "feeAmount": "0",
    "sentAmount": "0",
    "createdTime": "2026-03-26T11:05:47.19135Z",
    "description": "",
    "updatedTime": "2026-03-26T11:06:02.811752266Z",
    "errorCode": "ACCOUNT_NAME_MISMATCH",
    "errorMessage": "Account name mismatch: The provided bank account name is 'Jc Boehm Test', but the bank records show 'Jc Boehm'.",
    "referenceCode": "ref-payout-20260326-1774523144923",
    "initiatedAmount": "10000",
    "customerReference": "ref-payout-20260326-1774523144923",
    "destinationPayoutMethod": "BANK_TRANSFER",
    "destinationPayoutChannel": "CENAIDJA"
  },
  "timestamp": "2026-03-26T11:06:06.309161274Z",
  "schemaVersion": "1.0.1"
}

Handling Name Mismatch (Manual Review)

Transactions with recipient name mismatches are routed for review in the merchant dashboard, where you can choose to approve or cancel them.

  • Transactions are labeled as "Name Mismatch" instead of failing immediately.

  • You can manage these transactions in the "Name Mismatch" tab on the dashboard.

  • On the transaction details page, you can take one of the following actions:

Important: If you choose Manual Review to handle Name Mismatch, subscribe to Pay Out Name Mismatch notifications to receive an email notification whenever a payout transaction is flagged. For more details, please refer to Notification module here.

Approving a Name Mismatch Transaction

To approve a transaction despite a name mismatch:

  1. Select the Transaction: Click on the transaction you want to approve.
  2. Click "Approve": In the transaction details page, click "Approve".
  3. Review and Verify: Check the recipient’s details, including provided account name, provided account number, and bank’s recorded name. (Optional) Add remarks if needed. If all details are correct, click "Approve".
  4. Trusted Beneficiaries Confirmation: A confirmation pop-up will appear asking whether to add this account to your Trusted Beneficiaries. Click "Yes, Continue" to approve and whitelist the account. Once whitelisted, future Pay Outs matching this account will be auto-approved. Click "No, approve this one only" to approve only this transaction without whitelisting.
  5. Trusted Beneficiaries Review (optional): Once you choose "Yes, Continue" in step 4, a confirmation pop-up will appear. Remarks is mandatory to continue. If all details are correct, click “Save”.
  6. Transaction Processing: The transaction will be processed using the bank’s recorded name. You can track its progress in the transaction timeline.

In cases where an approved Name Mismatch transaction is also added as a trusted beneficiary, the approver’s username will be recorded in the Transaction Timeline.

For future transactions involving the already recorded trusted beneficiary, the approver will be recorded as "System," with remarks indicating that the transaction was auto-approved as part of the trusted beneficiary process.

To learn more about accounts whitelisting, kindly refer to Trusted Beneficiaries module.

Cancelling a Name Mismatch Transaction

To reject a transaction due to a name mismatch:

  1. Select the Transaction: Click on the transaction you want to reject.
  2. Click "Cancel": In the transaction details page, click "Cancel".
  3. Review and Verify: Confirm that the names belong to different individuals. (Optional) Add remarks if needed. If you are sure the details are incorrect, click "Cancel".
  4. Confirm Rejection: A confirmation pop-up will appear. Click "Continue" to finalize rejection.
  5. Transaction Failed: The transaction status will update to "Cancelled". You can check the history in the transaction timeline.

Handling Name Mismatch (Hybrid Handling)

With Hybrid Handling, transactions with name mismatches are handled based on the configured similarity threshold ranges. Depending on the similarity score, a transaction may be either handled through Automatic Cancellation or routed for Manual Review. For example, you may request to configure Hybrid Handling as follows:

Levenshtein SimilarityHandling
Below 70%Automatic Cancellation
70% – 80%Manual Review
80% and aboveConsidered matched and processed normally

Important: If you choose Hybrid Handling to handle Name Mismatch, subscribe to Pay Out Name Mismatch notifications to receive an email notification whenever a payout transaction is flagged for manual review. For more details, please refer to Notification module here.


Did this page help you?