Virtual Accounts

Generate virtual account to collect payments

Overview

Virtual accounts are digital sub-accounts linked to a primary account, allowing businesses to manage funds more efficiently. They can be used for customer payments, reconciliation, and automated financial operations. SingleView API enables users to create and manage virtual accounts seamlessly within their ERP systems.

Create a Virtual Account

Try in API Reference ➜

Endpoint details

Endpoint URL	Method	Authentication requirements
`/v1/api/erp/svVAService`	POST	1. `clientid` 2. `clientsecret` 3. `signature`

Sample request

  curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svVAService' \
  --header 'clientid: abcdef83643f61c975' \
  --header 'clientsecret: zyxvw95cE163C03b7d1' \
  --header 'signature: UMEH9M8tXknuRnnkrzRjDHaxFRLyZJwDNAl408nUMEH9M8tXknuRnnkrzRjDHaxFRLyZJwDNAl408n' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "svVAServiceRQ": {
    "groupCode": "1000",
    "company": [
      {
        "companyCode": "1101",
        "userName": "muhammad_1278",
        "type": "create",
        "virAccount": [
          {
            "acERPcode": "1000000050",
            "va_acERPcode": "VA10000000501",
            "alias": "GOLDEN GLORYS FOR ADVERTISING",
            "customerRef": "11000044",
            "capLimit": "100000",
            "clientId": "34535345",
            "schemId": "12345",
            "merchantId": "3453555"
          }
        ]
      }
    ]
  }
  }'

Request description

JSON Tag	Description	Data Type
clientid Mandatory	Unique client identification details Length of input: Min 3 Characters Max 20 Characters_	String
clientsecret Mandatory	Unique client secret code Length of input: Min 3 Characters Max 20 Characters_	String
signature Mandatory	64-Bit string obtained by processing client signature key through Base-64 and SHA-256	String
svVAServiceRQ Mandatory	Tag carrying information on request to create virtual account	Object
groupCode Mandatory	Unique group identification code Length of input: Min 3 Characters Max 20 Characters_	Numeric
company Mandatory	Tag carrying information about company	Object
companyCode Mandatory	Unique company identification code Length of input: Min 3 Characters Max 20 Characters_	Numeric
userName Mandatory	Unique user identification name Length of input: Min 3 Characters Max 20 Characters_	String
virAccount Mandatory	Tag carrying information on virtual account creation request	Object
acERPcode Mandatory	Unique account ERP identification code Length of input: Min 3 Characters Max 20 Characters_	Numeric
va_acERPcode Mandatory	Unique account ERP identification code for virtual account	Alphanumeric
alias Mandatory	Alias information Length of input: Min 3 Characters Max 20 Characters_	String
customerRef Mandatory	Unique customer reference details	Numeric
capLimit Mandatory	Maximum limit of the amount in virtual account	Numeric
clientId Conditional for SAB	Unique client identification provided by the bank	Numeric
schemId Conditional for Alinma & SNB	Unique identification number for the virtual account services provided by the Alinma and SNB banks	Numeric
merchantId Conditional for Alinma & SNB	Unique merchant identification details provided by the Alinma and SNB banks	Numeric

Sample response

{
  "svVAServiceRS": {
    "company": [
      {
        "companyCode": "1101",
        "userName": "muhammad_1278",
        "virAccount": {
          "acERPcode": "1000000050",
          "alias": "GOLDEN GLORYS FOR ADVERTISING",
          "customerRef": "11000044",
          "virtualIBAN": "79471000014301",
          "va_acERPcode": "VA10000000501",
          "accountNumber": "79471000014301"
        }
      }
    ]
  }
}

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
va_acERPcode	Unique account ERP identification code for virtual account	String
accountNumber	Unique account number allocated to the newly created virtual account	String

Add a Virtual Account

Try in API Reference ➜

Endpoint details

Endpoint URL	Method	Authentication requirements
`/v1/api/erp/svVAService`	POST	1. `clientid` 2. `clientsecret` 3. `signature`

Sample request

curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svVAService' \
--header 'clientid: abcdef83643f61c975' \
--header 'clientsecret: zyxvw95cE163C03b7d1' \
--header 'signature: UMEH9M8tXknuRnnkrzRjDHaxFRLyZJwDNAl408nUMEH9M8tXknuRnnkrzRjDHaxFRLyZJwDNAl408n' \
--header 'Content-Type: application/json' \
--data-raw '{
"svVAServiceRQ": {
  "groupCode": "1000",
  "company": [
    {
      "companyCode": "1101",
      "userName": "muhammad_1278",
      "type": "add",
      "virAccount": [
        {
          "acERPcode": "1000000050",
          "va_acERPcode": "va1234",
          "alias": "GOLDEN GLORYS FOR ADVERTISING",
          "customerRef": "11000044",
          "capLimit": "100000",
          "virtualAccountNumber": "34567894567",
          "clientId": "34535345",
          "schemId": "12345",
          "merchantId": "3453555"
        }
      ]
    }
  ]
}
}'

Request description

JSON Tag	Description	Data Type
clientid Mandatory	Unique client identification details Length of input: Min 3 Characters Max 20 Characters_	String
clientsecret Mandatory	Unique client secret code Length of input: Min 3 Characters Max 20 Characters_	String
signature Mandatory	64-Bit string obtained by processing client signature key through Base-64 and SHA-256	String
svVAServiceRQ Mandatory	Tag carrying information on request to create virtual account	Object
groupCode Mandatory	Unique group identification code Length of input: Min 3 Characters Max 20 Characters_	Numeric
company Mandatory	Tag carrying information about company	Object
companyCode Mandatory	Unique company identification code Length of input: Min 3 Characters Max 20 Characters_	Numeric
userName Mandatory	Unique user identification name Length of input: Min 3 Characters Max 20 Characters_	String
virAccount Mandatory	Tag carrying information on virtual account creation request	Object
acERPcode Mandatory	Unique account ERP identification code Length of input: Min 3 Characters Max 20 Characters_	Numeric
va_acERPcode Mandatory	Unique account ERP identification code for virtual account	Alphanumeric
alias Mandatory	Alias information Length of input: Min 3 Characters Max 20 Characters_	String
customerRef Mandatory	Unique customer reference details	Numeric
capLimit Mandatory	Maximum limit of the amount in virtual account	Numeric
virtualAccountNumber Mandatory	Bank account number of the virtual account to be added to the ERP system	Alphanumeric
clientId Conditional for SAB	Unique client identification provided by the bank	Numeric
schemId Conditional for Alinma & SNB	Unique identification number for the virtual account services provided by the Alinma and SNB banks	Numeric
merchantId Conditional for Alinma & SNB	Unique merchant identification details provided by the Alinma and SNB banks	Numeric

Sample response

{
  "svVAServiceRS": {
    "company": [
      {
        "companyCode": "1101",
        "userName": "muhammad_1278",
        "virAccount": {
          "acERPcode": "1000000050",
          "alias": "GOLDEN GLORYS FOR ADVERTISING",
          "customerRef": "11000044",
          "virtualIBAN": "79471000014301",
          "va_acERPcode": "VA10000000501",
          "accountNumber": "79471000014301"
        }
      }
    ]
  }
}

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
va_acERPcode	Unique account ERP identification code for virtual account	String
accountNumber	Unique account number of the virtual account	String

Updated about 1 month ago