Fees and Rates

Understand ONERWAY Transfer fee calculation methods and exchange rate mechanisms

Amount Explanation

Payments involve two core amount fields. Understanding their relationship helps you set payment parameters correctly.

Field	API Parameter	Meaning
Payment Amount	sourceAmount	Total amount actually deducted from payer's account (including fees)
Expected Payout Amount	targetAmount	Amount the beneficiary actually receives

Same Currency Payment: Payment Amount = Payout Amount + Fees

Cross-currency Payment: Payment amount first deducts fees, then converts to payout currency at exchange rate. i.e., Payout Amount = (Payment Amount - Fees) × Exchange Rate

Fee Bearing Mode

ONERWAY supports two fee bearing modes, determining whether fees are borne by the payer or beneficiary.

Beneficiary Bears (chargeFlag=N): Fees are deducted from the payment amount (sourceAmount); beneficiary receives the amount after fee deduction. Merchant specifies sourceAmount; system automatically calculates targetAmount.

Payer Bears (chargeFlag=Y): Ensures beneficiary receives the full amount (targetAmount); system automatically calculates the total amount payer needs to pay (sourceAmount = targetAmount + Fees).

From a fund flow perspective, fees are always deducted from the payer's account balance. The difference between the two modes is who bears this cost.

Parameter Mapping

API, batch template, and Portal operations correspond to different parameter settings. Below is the parameter mapping for fee bearing modes.

Operation Method	Beneficiary Bears	Payer Bears
API	`chargeFlag=N`	`chargeFlag=Y`
Batch Template	`Transfer amount specified as` = Source currency	`Transfer amount specified as` = Target currency
Portal	Enter in "You Pay" field	Enter in "Beneficiary Receives" field

SWIFT Fee Bearing:

Operation Method	Payer Bears All Bank Fees	Shared
API	`feeBearing=OUR`	`feeBearing=SHA`
Batch Template	`SWIFT charge bearer` = OUR	`SWIFT charge bearer` = SHA

OUR mode includes platform service fee + all SWIFT intermediary bank fees. In SHA mode, intermediary bank fees are deducted from beneficiary's principal.

Exchange Rate

For cross-currency payments, the system converts at real-time exchange rates. You can query current rates through the following API.

Query Exchange RateTransfer API POST /api/v1/acct/queryExchangeRate

Failure and Return

When a payment fails or is returned after success, fees are handled as follows.

Transaction Result	Fee Handling
Failed	Not charged; system automatically refunds deducted fees
Returned	Depends on billing agreement

Batch Payment

Process multiple payments at once via Excel template, suitable for monthly payroll, batch settlements, marketing campaign rewards, and more

Error Codes

Error codes for ONERWAY Transfer beneficiary and payment APIs