Configuring withdrawal fees

When making a withdrawal on Deus X Pay via the Pay Console, a fee is applied to cover processing costs. This fee is deducted by default from the gross withdrawal amount, meaning the recipient pays this fee and receives the balance.

However, it is possible to configure your Pay profiles in such a way that the cost of withdrawals are absorbed by either the Recipient or the Merchant.

Profile Configuration

Firstly, an existing profile must be edited or a new profile should be created in order to toggle this fee setting.

Navigate to Profiles on the Deus X Pay console, and either create a new or edit an existing profile. Here you will see an option to select which party should cover the cost of withdrawal:

When the withdrawal fee is covered by the merchant, there is also an additional option to have this paid in the source (i.e. converted from) or destination (i.e. converted to) currency.

Withdrawal Creation

Depending on the configuration of the profile that is selected during withdrawal creation, the destination amount (i.e. the exact value that will reflect in the recipient wallet) will update to reflect which party (Recipient or Merchant) will absorb the fee: 

Withdrawal Fee Paid By: Recipient

Withdrawal Fee Paid By: Merchant

Note: displayed withdrawal fees are for demonstration purposes only

The associated withdrawal confirmation screen will reflect the estimated fee amount, and also specifies which party will absorb this fee.

Webhook notifications

Withdrawal webhook responses also include the following fields:  

fee

• This will specify the exact (on withdrawal completion) fee amount absorbed by the recipient
• Set to 0 if the fee is paid by the Merchant

merchant_fee

• This will specify the exact (on withdrawal completion) fee amount absorbed by the merchant
• Set to 0 if the fee is paid by the Recipient

fee_paid_by

• This will specify the party which has absorbed the fee - either “merchant” or “recipient”

For a detailed overview of these fields, as well as examples of withdrawal webhook responses, please refer to our API documentation.

Reports and Exports 

Withdrawal CSV exports (accessible via the Withdrawals tab on the Deus X Pay console) also include the following columns which are relevant to withdrawal fees:

• Withdrawal Fee Amount
• Withdrawal Merchant Fee Amount
• Fee Paid By 

Wallet transaction reports (accessible via the Reports tab on the HAYVN Pay console) include a “withdrawal-merchant-fee” transaction type, that will track all withdrawal fees absorbed by the Merchant. Whereas the "withdrawal-fee" transaction type track fees paid by the Recipient.