Creating Transactions

When creating a transaction, certain restrictions must be met to ensure its success:

  • The source account must have sufficient funds to cover the transaction amount and any fees if they are not deducted from the transaction amount.
  • All accounts involved in the transaction must have ACTIVE status.
  • The currency used in the transaction must be globally active and enabled for the provider.
  • The merchant must not have any restrictions specific to the type of transaction being created.

Types of Transactions

TRANSFER

A transfer transaction is used to move funds between two accounts within the system.

  • Both the source and destination accounts must be specified in the request.
  • Both accounts must operate in the same currency.
  • Transfers can be done from one network to another.

PAYIN

A payin transaction adds funds to an account within the system from an external source.

  • Payins are triggered by an external event from the provider that initiated the deposit. Once the event is processed, the account specified as the beneficiary in the deposit will receive the funds.

PAYOUT

A payout transaction moves funds from the system to an external beneficiary.

  • A valid beneficiary must be provided, detailing where the funds will be sent.
  • The account from which the funds will be deducted must be specified.

EXCHANGE

An exchange transaction converts funds from one currency to another.

  • The transaction amount, source account, and target account must be included in the request.
  • The source account must not have any other active transactions.
  • Both accounts must have the same provider.
  • If the accounts aren't in Simple Mode, the accounts must not be of type OPERATIONS.

Fee from amount

When creating a transaction of type PAYOUT, EXCHANGE, or TRANSFER, it can be specified whether the fee should be deducted from the transaction amount or charged separately from the account.

  • If the fee is deducted from the transaction amount, the recipient receives the net amount after the fee is applied.
  • If the fee is charged separately, the transaction will fail if the source account does not have sufficient funds to cover both the transaction amount and the fee.

Did this page help you?