PUT
/
wallets
/
wallet
/
transaction
/
v2
/
wallet-to-wallet
curl --request PUT \
  --url https://waas-staging.cafeone.ng/api/v1/wallets/wallet/transaction/v2/wallet-to-wallet \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "fromAccount": "<string>",
  "toAccount": "<string>",
  "amount": 123,
  "transactionReference": "<string>",
  "remarks": "<string>",
  "transactionTypeId": 123
}'

​
Request Body

​
fromAccount
string
required

The source account number for the transfer. Example: “3025831139”

​
toAccount
string
required

The destination account number for the transfer. Example: “211651183”

​
amount
number
required

The amount to transfer. Example: 100000

​
transactionReference
string
required

A unique reference identifier for the transaction. Example: “retw33344556670900”

​
remarks
string

Additional notes or description for the transaction. Example: “For Holidays”

​
transactionTypeId
number

Identifier for the type of transaction. Example: 0

​
Response

✅ Success Response

Status Code: 200 OK
{
  "code": "200",
  "success": true,
  "message": "Transaction completed successfully.",
  "data": {
    // Additional transaction details if applicable
  }
}

​
❌ Error Responses

Status Code: 401 Unauthorized

{
  "code": "401",
  "success": false,
  "message": "x-api-key is missing in the header",
  "data": null
}

Status Code: 400 Bad Request

{
  "code": "400",
  "success": false,
  "message": "Invalid request data",
  "data": null
}

Status Code: 500 Internal Server Error

{
  "code": "500",
  "success": false,
  "message": "An unexpected error occurred",
  "data": null
}