Skip to main content
Return Payment Service:
  • The return payment service is used to post reverse card and ACH transactions (This is a different service from API Return).
  • This service handles single and bulk requests.
  • The bulk request can be done through the vf_bulkReturnPmt :
The CSV file has to contain the following structure: Obs - The chargeback and ACH have the same CSV structure, the only difference is that for ACH returns, the column New Transaction ID has to match the Trans ID column.
  • The single transaction return can be done from the original transaction record:
  • Chargeback: Click Return PMT Apex and the page below will be displayed:
  • ACH: Click Return PMT Apex and the page below will be displayed:
LOGIC:
  1. Finding the Original Payments:
Using the original tran_Id field, the query finds the original transactions that were processed in the past 60 days. The reason for the 60-day limit is to avoid any duplicate IDs being reversed from old transactions.
  1. Payment Gateway Code:
The code will query the Payment Gateway Code object based on the reject code from the CSV file or dropdown selection on the vf page.
  1. Handling Loan Issues:
Closed Loans: If a loan is closed (and the status is notUAS - Transfer Account), the method reopenContract in the ContractService class reopens the loan and creates the new statement. Transfer Account Loans: If the loan status is UAS - Transfer Account, accounting needs to manually review the transaction and the contract.
  1. STMT Handling: If a contract is in active status and does not have a current STMT, the method createCurrentStmt in the contractService class.
  2. Create Rev Transaction:
The new return trans will be created based on the original transaction. Based on the Payment Gateway Code, an NSF fee transaction will be created. If needed, a reverse payment map will be created for the transaction.
  1. Create Case:
The case will be created based on the Payment Gateway Code object, the Create Case field will either create a “Dispute” case or a “Chargeback” case.
  1. Buckets:
After transactions are inserted, the returnPaymentDlqEval code will evaluate if a bucket is needed for the current STMT. Running Locally: POST request: https://test-api.uportal360.com/reversePayment Body:
Things to look for:
  • Return code
  • Original transaction processed date
  • Return amount
  • Possible duplicate trans ID
Additional Services Used:
  • contractService : Used for reopening contracts and creating current statements.
  • pmtMapService : Used for generating reverse payment maps.
  • returnPaymentDlqEval : Used for triggering delinquency evaluation.

History