Account to Account Transfer

Withdrawals to client account

Perform payouts back to clients by transferring funds from your MiFinity merchant account to a client's MiFinity account. This is a synchronous account-to-account transfer — a 200 OK response confirms the transfer succeeded.

Request

POST https://demo.mifinity.com/api/payments/acct2acct/

Header

Parameter	Type	Description
Content-Type	String	Use value 'application/json'
Accept	String	Use value 'application/json'
x-api-version	String	Use value 1
Key	String	API key

Body Params

Field	Type	Required	Description
sourceAccount	String	true	Account number from which the amount of money will be debited
destinationAccount	String	true	Can be either email address or MiFinity account number to receive the credit
money	Money	true	Complex Money object containing transfer amount and currency
description	String	true	Description for this transfer (min 1 character, max 25 characters)
traceId	String	true	Unique transaction identifier. You can assign any value

money

Field	Type	Required	Description
currency	String	true	Currency code (ISO 4217)

Example

{
  "sourceAccount": "5001000001212099",
  "destinationAccount": "[email protected]",
  "money": {
    "amount": 10.00,
    "currency": "EUR"
  },
  "description": "Payout to client",
  "traceId": "zcsdcxsdfdcxcdsxxxdssfdfxfdccds5f"
}

✅
For withdrawals (Account to Account transfer), the flow is synchronous. A 200 OK response confirms the transfer succeeded. A callback notification (webhook) is also sent if configured.