POST
/
v1
/
virtual-account
/
dynamic
curl --request POST \
  --url https://sandboxapi.me-cash.com/v1/virtual-account/dynamic \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "currency": "NGN",
  "country": "NG",
  "amount": 5000,
  "duration": 30,
  "reference": "TXN_REF_DYNAMIC_12345678"
}'
{
  "status": "success",
  "message": "Operation completed successfully.",
  "data": {
    "id": "30fe4022-09da-46fb-bafa-xxxxxxxxxxxxx",
    "reference": "<string>",
    "account": {
      "bankName": "<string>",
      "sortCode": "<string>",
      "number": "<string>"
    },
    "expiryTime": 123,
    "status": "ACTIVE",
    "currency": "<string>",
    "country": "<string>",
    "created": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
currency
string
required

Currency code (e.g., NGN).

​
country
string
required

Country code (e.g., NG).

​
amount
number
required

The exact amount expected for the transaction.

​
duration
integer
required

The time in minutes for which the account will remain active.

​
reference
string
required

A unique reference for the transaction.

Response

Dynamic virtual account created successfully.

​
status
string
required
Example:

"success"

​
message
string
required
Example:

"Operation completed successfully."

​
data
object

The payload of the successful response.