Skip to main content

TransferDetails

Represents the details of a transfer.

reasonTransferReason (string)required

The actual purpose of the transfer.

  • INITIAL_BALANCE_MIGRATION - After customer onboarding, migrations of existing balances.
  • CRYPTO_BUY - The customer is buying crypto or other assets.
  • CRYPTO_SELL - The customer is selling crypto or other assets.
  • TRADING_PAIR - The transfer represents a trading pair transaction between customers with wallets.
  • DEPOSIT - Crediting the customer's wallet via non-Paysafe deposit options.
  • WITHDRAWAL - Debiting the customer's wallet via non-Paysafe withdrawal options.
  • MERCHANT_FEE - Charging a merchant fee.
  • REFUND - Refunding the customer on a previous transaction.
  • CANCELATION - Cancelation of a previous transaction.
  • BONUS - Customer is granted a bonus.
  • CURRENCY_EXCHANGE - Converting one currency to another.
  • PURCHASE - The customer is purchasing goods or services from a merchant.
  • PAYOUT - The merchant is compensating a customer for goods or services.
  • PEER_TRANSFER - Money transfer between customers with wallets.
  • OTHER - Any reason not explicitly mentioned in the transfers.
  • CARD_REPLACEMENT_FEE - Fee for replacing a card that is lost, stolen, or damaged.
  • CARD_FEE - Fee charged on funds paid on to the card.
  • ATM_FEE - Fee for funds withdrawal on ATM.
  • INACTIVITY_FEE - Fee charged for lack of transactions or authorizations.
  • FX_FEE - Fee related to currency exchange.
  • DISPUTE_FEE - Fee charged for resolving disputes related to payments, such as suspected fraud or unfulfilled goods/services.

Possible values: [INITIAL_BALANCE_MIGRATION, CRYPTO_BUY, CRYPTO_SELL, TRADING_PAIR, DEPOSIT, WITHDRAWAL, MERCHANT_FEE, REFUND, CANCELATION, BONUS, CURRENCY_EXCHANGE, PURCHASE, PAYOUT, PEER_TRANSFER, OTHER, CARD_REPLACEMENT_FEE, CARD_FEE, ATM_FEE, INACTIVITY_FEE, FX_FEE, DISPUTE_FEE]

descriptionstring

Human readable description for the transfer.

Possible values: <= 200 characters

TransferDetails
{
  "reason": "INITIAL_BALANCE_MIGRATION",
  "description": "string"
}