Virtual Account

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 URLMethodAuthentication requirements
/v1/api/erp/svVAServicePOST1. 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 TagDescriptionData Type
clientid
Mandatory
Unique client identificationString
clientsecret
Mandatory
Unique client secret keyString
signature
Mandatory
64-Bit encrypted signature codeString
svVAServiceRQ
Mandatory
Tag carrying information on request to create virtual accountObject
groupCode
Mandatory
Unique group codeNumerical
company
Mandatory
Tag carrying information about companyObject
companyCode
Mandatory
Unique company codeNumerical
userName
Mandatory
Unique user identification nameString
virAccount
Mandatory
Tag carrying information on virtual account creation requestObject
acERPcode
Mandatory
Unique account ERP identification codeNumerical
alias
Mandatory
Alias informationString
customerRef
Mandatory
Unique customer reference detailsNumerical
capLimit
Mandatory
Cap limitNumerical

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 TagDescriptionData Type
svVAServiceRSTag carrying information on process response of Virtual Account servicesObject
companyTag carrying information on companyObject
companyCodeUnique company identification codeNumerical
userNameUnique usernameString
virAccountTag carrying information on virtual accountObject
acERPcodeUnique ERP account codeNumerical
aliasUnique alias detailsString
customerRefUnique customer reference numberNumerical
virtualIBANUnique virtual IBANString