API Check account info

API Check account info

Chat with AI▼

Endpoint: /api/v1/service/transfer/bank/account/info

Method: POST

Header: How to generate JWT_TOKEN

Language: en | vi

{
    "X-APPOTAPAY-AUTH": Bearer JWT_TOKEN,
    "Content-Type": "application/json",
    "Language": LANGUAGE
}

Params

Params	Required	Type	Description
bankCode	√	String	Error code banks prescribed AppotaPay have to define into pages: List bank support transfer money.
accountNo	√	String	Account number or card bank of customer. Length is 4-22 characters
accountType	√	String	Type of accountNo account: Account number card: Card bank
partnerRefId	√	String	Transaction Id from partner
signature	√	String	Signature of parameter passed to the API, the parameter is included into signature like this: accountNo + accountType + bankCode + partnerRefId (see more how to generate signature)

Data result

Params	Type	Description
errorCode	Integer	Error code result
message	String	Description error code detail
accountInfo	Object	Transaction information
accountInfo.accountNo	String	Account number or card bank of client
accountInfo.accountName	String	Account Name
accountInfo.bankCode	String	Bank code
accountInfo.accountType	String	accountNo includes: account: account bank card: card bank
signature	String	Signature of parameter passed to the API, the parameter is included into signature like this: accountName + accountNo + errorCode (see more how to check signature) (see more how to generate signature)

Example

Request

{
    "bankCode": "TPBANK",
    "accountNo": "13210013240000",
    "accountType": "account",
    "partnerRefId":"P199212928",
    "signature": "b5bb9a6e9c71281fb1e06d"
}

Response

{
    "errorCode": 0,
    "message": "Thành công",
    "accountInfo": {
        "accountNo":13210013240000,
        "accountName":"NGUYEN VAN A",
        "bankCode":"TPBANK",
        "accountType":"account"
    },
    "signature": "b5bb9a6e9c71281fb1e06d"
}

Code Examples

curl --location 'https://gateway.dev.appotapay.com/api/v1/service/transfer/bank/account/info' \
  --header 'X-APPOTAPAY-AUTH: JWT_TOKEN' \
  --header 'Content-Type: application/json' \
  -d '{
  "bankCode": "TPBANK",
  "accountNo": "13210013240000",
  "accountType": "account",
  "partnerRefId": "P199212928",
  "signature": "b5bb9a6e9c71281fb1e06d"
}'

Request

REQUEST

Base URL

https://gateway.dev.appotapay.com

Development server

Path

Auth REQUIRED

Bearer Token

Body REQUIRED

Example (from schema)

{ "bankCode": "TPBANK", "accountNo": "13210013240000", "accountType": "account", "partnerRefId": "P199212928", "signature": "b5bb9a6e9c71281fb1e06d" }