POST
/
account
/
virtual
/
create
/
dynamic
Dynamic Account
curl --request POST \
  --url https://devapi.withedge.co/gateway/api/v1/account/virtual/create/dynamic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'requestId: <requestid>' \
  --data '{
  "name": "<string>",
  "expTime": "<string>",
  "expDate": "<string>"
}'
{
	"statusCode": 00,
	"message": "Account successfully created",
	"data": {
		"accountNumber": "1951145523",
		"accountName": "Tony Stark",
		"reversalId": "res1324323"
	},
	"errors": []
}

​
Create Dynamic Account

Use this endpoint to create a dynamic virtual account. The account can have a defined expiration time or expiration date, but only one of these parameters should be passed.

​
Additional Information

Please note that you are to either pass expTime or expDate and not both.

​
Request Parameters

​
requestId
string
required
A unique identifier for the request, used for idempotency.
Example: e0b9f8d0-7a57-4a67-a8b2-4d7c7b5a37c9
​
name
string
required
Name to be displayed to the customer upon name enquiry on the account number via their bank app.
Example: Tony Stark/Avengers
​
expTime
string
The expiry time, in seconds, for which the dynamic virtual account is to be active. The minimum time allowed is 600 seconds (10 minutes).
Example: 3600
​
expDate
string
The expiry date at which the dynamic virtual account is to become inactive.
Format: YYYY-MM-DDThh:mm:ss
Example: 2024-12-31T23:59:59
{
	"statusCode": 00,
	"message": "Account successfully created",
	"data": {
		"accountNumber": "1951145523",
		"accountName": "Tony Stark",
		"reversalId": "res1324323"
	},
	"errors": []
}