Skip to main content

Transfers

Introduction​

A transfer is the movement of funds between two wallet accounts. Each transfer consists of two transactions.

  • TRANSFER_OUT - debit transaction for moving money from sender customer balance
  • TRANSFER_IN - credit transaction for moving money into the recipient customer's balance

A fee transfer is a special type of transfer used specifically for standalone fees. Each fee transfer consists of two transactions, both of type STANDALONE_FEE:

  • debit transaction for moving money from sender customer balance
  • credit transaction for moving money into the recipient customer's balance

There are three types of participants in a transfer:

  • Customer wallets - regular users onboarded on embedded wallets solution
  • Legal Entity wallets - wallets, that belong to legal entities
  • Merchant wallets - wallets belonging to the merchant

These types of participants are treated differently from a regulatory perspective but used the same way for performing transfers.

For performing a transfer you need the following parameters:

  • amount - the amount in minor units
  • currencyCode - currency of the amount
  • email or customerId of the recipient
  • deviceInfo - device profiling information

For successful transfer the following conditions must be met:

  • Sender customer should have enough balance in the requested currency and must not be restricted
  • Recipient customer must exist in the system and must not be restricted

For more information check:

Currency conversion​

The transfer currency must always match the sender account currency. By default, the recipient account also must be in the same currency.

warning

Currency conversion is not implicitly enabled. For currency conversion during transfers, contact a Paysafe sales representative.

Merchant Fee collection​

A fee can be collected by the merchant for each successful transfer. These fees are collected in a preconfigured merchant fee collection account in the corresponding fee currency.

There are two approaches to collecting fees:

Transfers to unregistered users
Feature in development
​

A transfer to unregistered user is defined as a transfer by a merchant or existing user to a user that is not yet present in our system.

As such it has the following requirements:

The sender should:

  • Exist in the system
  • Not be restricted
  • Have enough balance in the requested currency

The recipient should:

  • Not exist in the system
  • Be eligible upon registration to receive funds in the requested currency

Since creating transactions depends on all parties being present, transfers to unregistered users can only progress to SCHEDULED status prior to recipient registration.

Transfers are automatically processed upon recipient party registration. As such SCA is conducted prior to scheduling the transfer.

warning

Transfers to unregistered users are not implicitly enabled. Please contact a Paysafe sales representative for further information.