Open BankingB2B SuiteERP Integration
GuidesChangelog
Menu

Categories

Open BankingB2B SuiteERP Integration


  • GENERAL INFORMATION

    • Documentation guide
    • Documentation guide
    • SingleView B2B Core APIs
    • SingleView Open Banking
    • Platform architecture
    • KSAOB standards
    • Security best practices
  • Getting started

    • Introduction
    • Become a User
    • Quick Lookup
  • GETTING STARTED

    • Integration guide
    • Become a user
    • Integration guide
    • Prerequisites for Sandbox
    • Developer console
    • Establishing secure connection
    • Establish secure connection
    • Authenticating your request
    • Generate access token
    • Making your first test api call
    • Make test raw data API call
    • Prerequisites for production
    • Make test data use case API call
    • Moving to production
  • Authentication

    • Generate Signature
  • ERP API Services

    • Configure API Account
    • Create Group & Company
    • Supplier Services
    • Account Services
    • Balance Enquiry
    • Statements
    • IBAN Validation
    • POS Transactions
  • CONSENT MANAGEMENT

    • Overview
    • Create a consent
    • Retrieve consent details
    • Revoke a consent
  • AUTHENTICATION

    • Header parameters
    • Obtain access token
    • Generate signature
  • Data APIs

    • Account statement
    • Balance enquiry
    • IBAN verification
    • POS transactions
    • Raw statement
  • Raw Data APIs

    • Introduction
    • View accounts
    • View balance
    • View transactions
    • Identify account holders (Parties)
    • Review direct debits
    • Review scheduled payments
    • Review standing orders
  • Payment APIs

  • DATA USE CASE APIS

  • SADAD

  • Plug-and-Play Integrations

    • Payly
  • RESOURCES

    • POR Details
    • Error codes
    • Errors & codes
    • Collections
    • API version management
    • Bank connectivity
  • API Archives


Account Services

Enlist your company's and suppliers' bank accounts

Account services allows you to add your own bank accounts as well as manage beneficiary bank accounts (supplier bank accounts).

Add new account

Endpoint details

Endpoint URL

Method

Authentication requirements

/v1/api/erp/svAccService

POST

  1. clientid
  2. clientsecret
  3. signature

Sample request

A request in the following format should be posted to the mentioned URL endpoint.

Add account services
curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svAccService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svAccServiceRQ": {
  "groupCode": "Enter_Group_Code",
  "company": [
    {
      "companyCode": "Enter_Company_Code",
      "userName": "Enter_Username",
      "account": [
        {
          "bankCode": Enter_OSV_Bank_Code_Identifier,
          "accountNum": "Enter_Bank_Account_Number",
          "corpId": "Enter_Corporate_Bank_Code",
          "holderName": "Enter_Bank_Account_Holder_Name",
          "iban": "Enter_International_Bank_Account_Number",
          "address": "Enter_ Bank_Address",
          "currency": "Enter_Currency",
          "acERPcode": "Enter_Unique_ERP_Account_Code"
        }, 
        {
          "bankCode": Enter_OSV_Bank_Code_Identifier,
          "accountNum": "Enter_Bank_Account_Number",
          "corpId": "Enter_Corporate_Bank_Code",
          "holderName": "Enter_Bank_Account_Holder_Name",
          "iban": "Enter_International_Bank_Account_Number",
          "address": "Enter_ Bank_Address",
          "currency": "Enter_Currency",
          "acERPcode": "Enter_Unique_ERP_Account_Code" // EX : ACC002
        }
      ],
      "beneficiary": [
        {
          "type": "Enter_Type",
          "nickName": "Enter_Nickname",
          "bankCode": Enter_OSV_Bank_Code_Identifier,
          "accountNum": "Enter_Bank_Account_Number",
          "name": "Enter_Bank_Account_Name",
          "iban": "Enter_International_Bank_Account_Number",
          "currency": "Enter_Currency",
          "benERPcode": "Enter_Unique_ERP_Beneficiary_Code",
          "description": "Enter_Description",
          "country": "Enter_Country",
          "supplierCode": "Enter_Unique_ERP_Supplier_Code",
          "isPrimary": Enter_True/False
        },
        {
          "type": "Enter_Type",
          "nickName": "Enter_Nickname",
          "bankCode": Enter_OSV_Bank_Code_Identifier,
          "accountNum": "Enter_Bank_Account_Number",
          "name": "Enter_Bank_Account_Name",
          "iban": "Enter_International_Bank_Account_Number",
          "currency": "Enter_Currency",
          "benERPcode": "Enter_Unique_ERP_Beneficiary_Code",
          "description": "Enter_Description",
          "country": "Enter_Country",
          "supplierCode": "Enter_Unique_ERP_Supplier_Code",
          "isPrimary": Enter_True/False
        }
      ]
    }
  ]
}
}'

Request details:

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 identification 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

svAccServiceRQ Mandatory

Tag carrying information on request to add beneficiary or supplier account

Object

groupCode Mandatory

Unique group identification code

String

company Mandatory

Tag carrying information on the company

Object

companyCode Mandatory

Unique identification code of the company Length of input: Min 3 Characters Max 20 Characters

String

userName Mandatory

Unique SingleView's username of the request initiator Length of input: Min 3 Characters Max 20 Characters

String

account Mandatory

Object carrying information on accounts to be added

Object/Array

accountNum Mandatory

Unique bank account number of the beneficiary/supplier

Alphanumeric

corpID Mandatory

Corporate identification code as per bank records of the debit account Length of input: Min 3 Characters Max 20 Characters

Alphanumeric

holderName Mandatory

Registered name of the account holder as per bank records Length of input: Min 3 Characters Max 20 Characters

Alphabetic

currency Mandatory

Default currency code in ISO format

Alphabertic

acERPcode Mandatory

Unique ERP code assigned to the bank account
Min: 9 Characters

Alphanumeric

bankCode Mandatory

Unique bank identification code (SingleView identifier code) Length of input: Min 3 Characters Max 20 Characters

String

iban Optional

Unique International Bank Account Number (IBAN) Length of input: Max 24 Characters

Alphanumeric

address Mandatory

Address of the bank where the beneficiary holds the specified account Length of input: Min 3 Characters Max 20 Characters

String

beneficiary Mandatory

Tag carrying an array of beneficiaries bank accounts

Object/Array

iban Mandatory

International Bank Account Number/Beneficiary bank account number

Alphanumeric

type Mandatory

Type of beneficiary; International or local Length of input: Min 3 Characters Max 20 Characters

Alphanumeric

name Mandatory

Name of beneficiary as per bank account Length of input: Min 3 Characters Max 35 Characters

Alphabetic

currency Mandatory

Beneficiary bank account currency in ISO format

Alphanumeric

benERPCode Mandatory

Unique beneficiary code as per ERP

String

bankCode Mandatory

Unique SingleView bank code identifier Length of input: Min 3 Characters Max 20 Characters

Alphanumeric

supplierCode Mandatory

Unique supplier code for beneficiary

String

address Optional

Address of the beneficiary Length of input: Min 3 Characters Max 35 Characters

String

swiftCode Mandatory

Unique swift identification code of the beneficiary bank account

Alphanumeric

isPrimary Mandatory

Set true or false to set the account as a primary account for the beneficiary

Boolean

nickName Optional

Nickname of the beneficiary Length of input: Min 3 Characters Max 20 Characters

Alphanumeric

accountNum Optional

Bank account number of the beneficiary

Alphanumeric

corpID Optional

Unique corporate identification details of the beneficiary Length of input: Min 3 Characters Max 20 Characters

Alphanumeric

description Optional

Description of the beneficiary Length of input: Min 3 Characters Max 20 Characters

String

country Optional

Bank account country Length of input: Max 35 Characters

String

Sample response

Add account services success response
{
  "svAccServiceRS": {
    "groupCode": "Group_Code",
    "company": [
      {
        "companyCode": "Company_Code",
        "userName" : "Username",
        "account": [
          {
            "acERPcode": "Account_ERP_Code",
            "status":  Status_Code,
            "message": "Process/Status_Message"
          },
          {
            "acERPcode": "Account_ERP_Code",
            "status": Status_Code,
            "message": "Process/Status_Message",
            "errorCode": "Error_Code"
          }
        ],
        "beneficiary": [
          {
            "benERPcode": "Beneficiary_ERP_Code",
            "status": Status_Code,
            "message": "Process/Status_Message"
          },
          {
            "benERPcode": "Beneficiary_ERP_Code",
            "status": Status_Code,
            "message": "Process/Status_Message",
            "errorCode": "Error_Code"
          }
        ]
      }
    ]
  }
}

Response details:

JSON Tag

Description

Data type

svAccServiceRS

Add account services Response Tag

Object

groupCode

Unique group code

String

company

Array of companies

Array

companyCode

Unique company code

String

userName

SingleView Account's username

String

account

Array of accounts

Array

acERPCode

Account ERP Code

Alphanumeric

status

Status code

Numerical

code

Unique company code

String

message

Process display message

String

errorCode

Error code

String

 

Updated July 16, 2026

Was this helpful?