Skip to main content
Use this endpoint to generate a temporary virtual account for a single collection event. When the virtual account receives a credit, the funds are automatically swept into the pool account you designate. Share the returned account_number with your customer as a unique payment address for that transaction.

​
Endpoint

POST /api/v1/account/web/create_virtual

​
Authentication

Include your JWT access token in the Authorization header. 
Authorization: Bearer <access_token>
Obtain a token via POST /auth/web/login.

​
Request body

​
pool_account_number
string
required
The 10-digit account number of the pool account that will receive funds when this virtual account is credited. Must be an account owned by your business.
​
account_name
string
An optional label for the virtual account (e.g., "Invoice #12345" or "Order #987"). Defaults to "Virtual Dynamic Account" if not provided. Maximum 255 characters.

​
Example request

curl --request POST \
  --url https://baasapi.payrepmfb.com/api/v1/account/web/create_virtual \
  --header "Authorization: Bearer <access_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "pool_account_number": "7801234567",
    "account_name": "Invoice #12345"
  }'

​
Response

A successful request returns the newly created virtual account.
​
status
boolean
true when the request succeeds.
​
response_code
string
"00" on success.
​
message
string
Human-readable result message, e.g. "Virtual account created successfully".
​
data
object
The created virtual account object.
{
  "status": true,
  "message": "Virtual account created successfully",
  "response_code": "00",
  "data": {
    "account_number": "9990000001",
    "account_name": "Invoice #12345",
    "status": "active",
    "account_type": "virtual"
  }
}

​
Error codes

Response codeMeaning
41Customer not found — your session credentials are invalid.
42Pool account not found — the pool_account_number does not belong to your business.
61Customer not verified — your business account must be active.
80Service unavailable — the core banking provider is temporarily down.
83Provider error — the core banking system rejected the request.