Virtual Account Generation

The Virtual Account Generation endpoint allows you to create unique, reserved bank account numbers linked to your Transactpay account. These accounts are useful for:

• 💸 Receiving customer payments
• 📊 Tracking transactions per user or department
• ⚙️ Automating financial workflows

Virtual accounts simplify reconciliation, increase automation, and enhance transaction-level visibility.

---

👍

Good to Know

• Payload must be encrypted using RSA (PKCS#1 v1.5) before making the request.
• Virtual accounts are persistent and reusable for future transactions tied to the alias

---

📮 Endpoint

HTTP

POST http://payment-api-service.transactpay.ai/payment/virtual-account/generate

---

🔐 Headers

Header	Type	Required	Description
api-key	string	✅ Yes	Your Transactpay secret API key
encryption	string	✅ Yes	Must be "RSA"
Content-Type	string	✅ Yes	Must be application/json

⚠️

Important:

Payloads must be encrypted using RSA (PKCS#1 v1.5).

---

📦 Sample Request Payload

JSON

{
  "Alias": "TestAccountViaAPI"
}

Key	Type	Required	Description
Alias	string	✅ Yes	Label or identifier for the virtual account

---

📤 Sample cURL Request

⚠️

Important:

You must encrypt the payload using RSA (PKCS#1 v1.5) before sending the request.

cURL

curl -X POST http://payment-api-service.transactpay.ai/payment/virtual-account/generate \
  -H "api-key: YOUR_PUBLIC_KEY" \
  -H "encryption: RSA" \
  -H "Content-Type: application/json" \
  --data @encrypted_payload.json

---

✅ Sample Success Response

JSON

{
  "status": true,
  "message": "Virtual account created successfully",
  "data": {
    "account_name": "Transactpay Inc",
    "account_number": "1234567890",
    "bank_name": "Transactpay Bank",
    "reference": "VAC-093823"
  }
}

---

📘 Notes

• Each virtual account is tied to the alias you provide.
• You can reuse virtual accounts to collect future payments from the same user or group.