🏦
API Doc
  • Welcome!
  • API AUTHENTICATION & SECURITY
  • Reference
    • API Reference
      • UploadOrders
      • Fundtransfer
      • CancelOrder
      • CheckOrderStatus
      • GetOrderDetails
      • GetBalance
      • CheckAccount
  • Additional Documents
    • 1. (SBR) Banks List (Including Napas and Citad, Mobile Wallet) - Update 2025
Powered by GitBook
On this page
  • Request
  • Response
  1. Reference
  2. API Reference

CheckAccount

This method is used for checking account.

Good to know: Press ">" to see detail.

Request

POST https://{SERVER}/Api/SBR/CheckAccount

Request Body

Name
Type
Description

AuthID*

Text

UserID assigned by SBR

ProtocolData*

Object

Data request

AccountID*

Text

Account number

AccountType

Text(20)

Account type: default: ACC

ACC: Payment account

PAN: Card account PAY: Sacombank Pay Account VNPTPay: VNPTPay account Zalo: ZaloPay account

ReceiverName

Text

Receiver Name of Account (required AccountType=Zalo or AccountType=VNPTPay)

CheckType

Text(20)

Check type: default: NAPAS

STB: Sacombank account

NAPAS: Napas account

BankID

Text(20)

ID of bank

Require: Check type = ‘NAPAS’

Not Require: Check type = ‘STB’

{
    // Response
}
{
    // Response
}
{
    // Response
}

Response

Parameters

Data type

Description

Status

Number

Return status of request:

0;Fail;1;Success

ProtocolData

Object

Object

TransactionID

Text

Transaction ID

AccountID

Text

Account number

AccountName

Text

Name of account

Status

Number

Response from payment gateway, ignore this value

Error

Text

Error from payment gateway

Verified

Boolean

Status when checking digital signature, ignore this value

Request Example

{
  "AuthID": "abc",
  "ProtocolData": {
    "AccountID": "Acc001",
    "AccountType": "ACC",
    "CheckType": "NAPAS",
    "BankID": "XYZ",
    
  }
}
// AccountType=ACC
{
  "AuthID": "123",
  "ProtocolData": {
    "AccountID": "060146911822",
    "AccountType": "ACC",
    "CheckType": "STB",
    "BankID": ""
  }
}

//AccountType=PAN
{
  "AuthID": "ADMIN",
  "ProtocolData": {
    "AccountID": "4221510243911065",
    "AccountType": "PAN",
    "CheckType": "STB",
    "BankID": ""
  }
}
// AccountType=ACC
{
  "AuthID": "ADMIN",
  "ProtocolData": {
    "AccountID": "1016230769",
    "AccountType": "ACC",
    "CheckType": "NAPAS",
    "BankID": "970406"
  }
}

//AccountType=PAN
{
  "AuthID": "ADMIN",
  "ProtocolData": {
    "AccountID": "9704060088114204",
    "AccountType": "PAN",
    "CheckType": "NAPAS",
    "BankID": "970406"
  }
}
// AccountType=PAY
{
  "AuthID": "ADMIN",
  "ProtocolData": {
    "AccountID": "0387789472",
    "AccountType": "PAY",
    "CheckType": "STB",
    "BankID": ""
  }
}
// AccountType=VNPTPay
{
  "AuthID": "ADMIN",
  "ProtocolData": {
    "AccountID": "0931102503",
    "AccountType": "VNPTPay",
    "ReceiverName": "TA QUANG HAI"
  }
}
// AccountType=Zalo
{
  "AuthID": "ADMIN",
  "ProtocolData": {
    "AccountID": "0931102503",
    "AccountType": "Zalo",
    "ReceiverName": "TA QUANG HAI"
  }
}

Response Example

// AccountType=ACC
{
  "Status": 1,
  "ProtocolData": {
    "TransactionID": "63783126853198821",
    "AccountID": "060146911822",
    "AccountName": "TRAN MINH HAI",
    "Status": "0",
    "Error": "",
    "Verified": true
  }
}
// AccountType=PAN
{
  "Status": 1,
  "ProtocolData": {
    "TransactionID": "63783126407431185",
    "AccountID": "422151XXXXXX1065",
    "AccountName": "NGUYEN VO PHUONG NGAN",
    "Status": "0",
    "Error": "",
    "Verified": true
  }
}
// AccountType=ACC
{
  "Status": 1,
  "ProtocolData": {
    "TransactionID": "63783126577152705",
    "AccountID": "1016230769",
    "AccountName": "Nguyen Van A",
    "Status": "0",
    "Error": "",
    "Verified": true
  }
}

// AccountType=PAN
{
  "Status": 1,
  "ProtocolData": {
    "TransactionID": "63783126650875702",
    "AccountID": "9704060088114204",
    "AccountName": "Nguyen Van A",
    "Status": "0",
    "Error": "",
    "Verified": true
  }
}
// AccountType=PAY
{
  "Status": 1,
  "ProtocolData": {
    "TransactionID": "63783126751163350",
    "AccountID": "0387789472",
    "AccountName": "nguyen thanh tuyen",
    "Status": "0",
    "Error": "",
    "Verified": true
  }
}
// Account is incorrect
{
  "Status": 0,
  "ProtocolData": {
    "TransactionID": "63783127003388448",
    "AccountID": "06014691182",
    "AccountName": "",
    "Status": "1",
    "Error": "113 - Account is incorrect",
    "Verified": true
  }
}

//BankID is incorrect
{
  "Status": 0,
  "ProtocolData": {
    "TransactionID": "63783127140796673",
    "AccountID": "1016230769",
    "AccountName": "",
    "Status": "1",
    "Error": "105 - BranchCode napas not found",
    "Verified": true
  }
}
// Success Zalo
{
    "Status": 1,
    "ProtocolData": {
        "TransactionID": "e2812d60b6c036dab838c9fcce5193a1304d67870323ef05d677292a7fb39159",
        "AccountID": "0931102503",
        "AccountName": "Quang Hải",
        "Status": "1",
        "Error": "Giao dịch thành công"
    }
}

//Failed Zalo
{
    "Status": 0,
    "ProtocolData": {
        "TransactionID": "",
        "AccountID": "0931102504",
        "AccountName": "",
        "Status": "-101",
        "Error": "Không tìm thấy thông tin người dùng"
    }
}
PreviousGetBalanceNext1. (SBR) Banks List (Including Napas and Citad, Mobile Wallet) - Update 2025

Last updated 2 months ago