POST
/
account
/
virtual
/
create
/
dynamic
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

Was this page helpful?