Wallet to Wallet Transfers

curl --request PUT \
  --url https://waas-staging.embedly.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>"
}
'

{
  "code": "00",
  "success": true,
  "message": "Transfer processed successfully",
  "data": 0
}

Wallet

Wallet to Wallet Transfers

This endpoint enables fund transfers between wallets within the same organization profile.

It can be used for:

Allowing customers to send funds to your organization wallet(s) and vice versa.
Collecting charges or fees from customer wallets.
Performing intra-organization transfers between customer wallets and organization wallets.
Any use case that involves movement of funds within your organization.

Each request must include a unique transactionReference. We recommend using a GUID or any randomly generated unique string of at least 10 characters.

Transfers are instant. A successful response means the transfer has been completed immediately. For verification, a dedicated requery endpoint is available to check the status of any transaction. See the next section for details.

PUT

wallets

wallet

transaction

wallet-to-wallet

Wallet to Wallet Transfers

curl --request PUT \
  --url https://waas-staging.embedly.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>"
}
'

{
  "code": "00",
  "success": true,
  "message": "Transfer processed successfully",
  "data": 0
}

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. Remarks here should not be more than 100 characters. Example: “For Holidays”

{
  "code": "00",
  "success": true,
  "message": "Transfer processed successfully",
  "data": 0
}

Get Wallet By Customer ID Get Wallet to Wallet Transfer Status