Intra Transfer

Move funds between your collection and transfer balances for a specified currency.

Header	Value
Authorization	Bearer SECRET_KEY
Content-Type	application/json

The secret key can be gotten from the 'Settings' page on your Startbutton dashboard.

Post a request to the URL below. See Environments & Base URLs for the base URL.

Endpoint: POST - {{baseurl}}/transaction/s2s/intra-transfer

Param	Required?	Description
currency	Yes	The currency in which funds are being moved between the collection and payout balances.
amount	Yes	The amount to be moved.
toWalletType	Yes	This should be set to payout
fromWalletType	Yes	This should be set to collection

Sample Request:

{
  "currency": "NGN",
  "amount": 15000,
  "fromWalletType": "collection",
  "toWalletType": "payout"
}

Sample Response — Success:

{
  "success": true,
  "message": "Intra-wallet transfer is processing",
  "data": {
    "transactionReference": "f5f87ec4321a"
  }
}

Sample Response — Insufficient Balance:

{
  "success": false,
  "message": "User has insufficient balance.",
  "data": {}
}