DojaPay API
  1. Virtual Account
DojaPay API
  • Authentication
    • Generate Access Token
      POST
  • Virtual Account
    • Create Virtual Account
      POST
    • Get Virtual Account Details
      GET
  • Transactions
    • Verify Transaction
      POST
  • Payout
    • Request Payout
      POST
    • Get Bank List
      GET
  1. Virtual Account

Create Virtual Account

POST
/virtual-account/create

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.dojapay.com/api/v1/virtual-account/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
	"amount": "", // Required only if amountType is one of ['\''EXACT'\'', '\''HIGHEROREXACT'\'', '\''LOWEROREXACT'\'']; must be numeric and ≥ 0
	"amountType": "", // Required if accountType is '\''DYNAMIC'\''; must be one of: '\''EXACT'\'', '\''ANY'\'', '\''HIGHEROREXACT'\'', '\''LOWEROREXACT'\''
	"accountType": "", // Required; must be either '\''DYNAMIC'\'' or '\''STATIC'\''
	"firstName": "", // Required; must be a string
	"lastName": "",  // Required; must be a string
	"email": "",     // Required; must be a valid email address
	"bvn": "",       // Optional; must be exactly 11 digits if provided
	"nin": "",       // Required if BVN is not provided; must be exactly 11 digits
	"expiryHours": "", // Required only if accountType is '\''DYNAMIC'\''; must be integer between 1 and 24
	"bank": "" // Required; must be a string (9psb)
}'
Response Response Example
{
    "success": true,
    "code": "string",
    "message": [
        "string"
    ],
    "data": {
        "event_type": "string",
        "account": {
            "name": "string",
            "number": "string",
            "type": "string",
            "bank": "string",
            "expiry": null
        },
        "order": {
            "amount": 0,
            "currency": "string",
            "description": "string",
            "country": "string",
            "amounttype": "string"
        },
        "customer": {
            "email": "string",
            "nin": "string"
        }
    },
    "errors": null,
    "reference": "string",
    "timestamp": "string"
}
Modified at 2025-11-03 14:32:41
Previous
Virtual Account
Next
Get Virtual Account Details
Built with