Virtual Accounts
Generate virtual account to collect payments
Overview
SingleView Virtual Accounts API services offer a comprehensive set of tools for creating, managing, and controlling virtual bank accounts. These APIs enable real-time access to virtual account data, automation of financial workflows, and seamless integration with your ERP systems.
Create a Virtual Account
Endpoint details
Endpoint URL | Method | Authentication requirements |
---|---|---|
/v1/api/erp/svVAService | POST | 1. clientid 2. clientsecret 3. signature |
Create Virtual Account
Sample request
curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svVAService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svVAServiceRQ": {
"groupCode": "Enter_Group_Code",
"company": [
{
"companyCode": "Enter _Company_Code",
"userName": "Enter_Username",
"virAccount": [
{
"acERPcode": "Enter_Account_ERP_Code",
"alias" : "Enter_Alias",
"customerRef" : "Enter_Customer_Reference",
"capLimit" : "Enter_Cap_Limit"
}
]
}
]
}
}
Request description
JSON Tag | Description | Data Type |
---|---|---|
clientid Mandatory | Unique client identification | String |
clientsecret Mandatory | Unique client secret key | String |
signature Mandatory | 64-Bit encrypted signature code | String |
svVAServiceRQ Mandatory | Tag carrying information on request to create virtual account | Object |
groupCode Mandatory | Unique group code | Numerical |
company Mandatory | Tag carrying information about company | Object |
companyCode Mandatory | Unique company code | Numerical |
userName Mandatory | Unique user identification name | String |
virAccount Mandatory | Tag carrying information on virtual account creation request | Object |
acERPcode Mandatory | Unique account ERP identification code | Numerical |
alias Mandatory | Alias information | String |
customerRef Mandatory | Unique customer reference details | Numerical |
capLimit Mandatory | Cap limit | Numerical |
Sample response
{
"svVAServiceRS": {
"company": [
{
"companyCode": "Company_Code",
"userName": "Username",
"virAccount": {
"acERPcode": "Account_ERP_Code",
"alias": "Alias_Info",
"customerRef": "Customer_Reference",
"virtualIBAN": "Virtual_IBAN"
}
}
]
}
}
Response description
JSON Tag | Description | Data Type |
---|---|---|
svVAServiceRS | Tag carrying information on process response of Virtual Account services | Object |
company | Tag carrying information on company | Object |
companyCode | Unique company identification code | Numerical |
userName | Unique username | String |
virAccount | Tag carrying information on virtual account | Object |
acERPcode | Unique ERP account code | Numerical |
alias | Unique alias details | String |
customerRef | Unique customer reference number | Numerical |
virtualIBAN | Unique virtual IBAN | String |
Updated 3 months ago