1. Can merchant retrieve information from API?

Yes, merchants can easily retrieve Pay Out transaction details, including the list of transactions and specific transaction information, via our APIs. This flexibility allows you to use the Xenith Merchant Dashboard or build your own custom dashboard. Refer to our API documentation for details on endpoints and sample requests.

2. When the transaction is failed, is there any error context?

Yes, when a Pay Out transaction fails, we provide detailed error code contexts and explanations. For API requests to create a payout, common reasons for failure include: Duplicate transactions, exceeding amount limits, and insufficient balance. In these cases, the payout request is not created, and the API response includes an error message explaining the issue. You can refer to our API documentation for a full list of error codes and troubleshooting tips.

For transactions that have already been created, the system performs additional checks, such as verifying the recipient's bank account name. If the name mismatch occurs, the payout transaction will fail, and a callback will be sent with details of the failure.

The name mismatch validation uses the Levenshtein Distance algorithm to compare the provided name with the bank's records. A transaction fails if the similarity falls below our threshold of 80%. For example, if the submitted name is "Nguyen Thi Thanh" and the bank records show "Thanh Nguyen," the transaction will fail.

3. Can merchants access recipient information?

Yes, if a Pay In transaction is successful and you have the necessary permissions to access customer information (refer to User Management), you can view recipient details, including: Account Holder Name and Account Number. This information is available on the Xenith Merchant Dashboard and is included in the CSV export.