Retrieve Inquiry Account

Retrieve Inquiry Account results by Inquiry Account ID

GET [BASE_URL]/v1/inquiry-account/:id

Detail Parameter Request

  • id: "uuid" from the response body whenever you Inquiry Account

Response

Response Body

{
  "code": "string",
  "message": "string",
  "data": {
    "uuid": "string",
    "merchantId": "string",
    "inquiryResult": {
      "status": "string",
      "detail": "string",
    }
  }
}

Detail Parameter Response

Parameter

Data Type

Requirement

Description

code

String

M

Response code

message

String

M

Response description

data

Object

M

  • uuid

String

M

Unique Inquiry Account ID

  • merchantId

String

M

Unique merchant ID

  • inquiryResult

Object

O

>> Status

String

M

Inquiry status to indicate the result

Potential value

  • VALID = requested account matched

  • WARNING = requested account is available, but the account might be mismatched. Please check detail for more information

  • INVALID = requested account is invalid or can’t be found

  • PENDING = inquiry account is still in progress

>> detail

String

C

Only available if the status is WARNING, INVALID, and PENDING explains the reason below:

Warning:

  • Account Name is not similar = "The account name entered does not match the bank's records. Please check the account information and try again. Bank record:{accountName from bank}"

  • Account Name is similar = “The account name entered is not an exact match. Please check the account information and try again. Bank record: {accountName from bank}”

Invalid:

Account number not found. Pending:

Inquiry in progress

List of Response Codes

Response Code

Response Message

Error Object

00

Success

-

credentials_invalid

Access Token is Invalid

{
  "error": {
    "type": "API_ERROR",
    "details": [
      {
        "field": "",
        "message": "Request new access token"
      }
    ],
    "traceId": "{trace id}" 
  }
}

field_required

Mandatory Field is Missing

{
  "error": {
    "type": "API_ERROR",
    "details": [
      {
        "field": "{field name}",
        "message": "Make sure {field name} value is fulfilled"
      }
    ],
    "traceId": "{trace id}" 
  }
}

service_unavailable

Gateway / Partner service is unavailable

{
  "error": {
    "type": "GATEWAY_ERROR",
    "details": [
      {
        "field": "",
        "message": "Please hit periodically"
      }
    ],
    "traceId": "{trace id}" 
  }
}

service_unavailable

Gateway / Partner service is unavailable

{
  "error": {
    "type": "GATEWAY_ERROR",
    "details": [
      {
        "field": "",
        "message": "Please hit periodically"
      }
    ],
    "traceId": "{trace id}" 
  }
}

general_error

General Error

{
  "error": {
    "type": "API_ERROR",
    "details": [
      {
        "field": "",
        "message": "Please contact our representative team"
      }
    ],
    "traceId": "{trace id}" 
  }
}