Match account holder details

GET 
/api/account/matching

Checks whether the supplied account holder details match the Volet.com account profile.

Request

Query Parameters

firstName stringrequired
First name of the account holder.
Example: John
lastName stringrequired
Last name of the account holder.
Example: Doe
email string
Email address of the account holder.
Example: [email protected]
walletId string
Wallet ID of the account holder.
Example: USD880390848110

Responses

200

OK

application/json

Schema

Schema

emailstring
Email.
Example: [email protected]
firstNamestring
First Name.
Example: test-value
lastNamestring
Last Name.
Example: test-value
walletIdstring
Wallet Id.
Example: W000000000001
firstNameMatchingPercentageint32
First Name Matching Percentage.
Example: 1
lastNameMatchingPercentageint32
Last Name Matching Percentage.
Example: 1
verifiedboolean
Verified.
Example: true

Example

{
  "email": "[email protected]",
  "firstName": "test-value",
  "lastName": "test-value",
  "walletId": "W000000000001",
  "firstNameMatchingPercentage": 1,
  "lastNameMatchingPercentage": 1,
  "verified": true
}

400

Bad request. The request is malformed or contains invalid parameters.

application/json

Schema

Schema

statusstringrequired
Response status.
Possible values: [error]
Example: error
data objectrequired
Error response payload.
errors object[]required
List of errors returned for the request.
Array [
errorMessagestringrequired
Stable machine-readable error code.
Example: disabled
errorTypestringrequired
Error category.
Example: FORM
errorIdstringrequired
Short unique error identifier for support and logs.
Example: errTest1234
errorDescriptionstringrequired
Human-readable error description.
Example: REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API
errorFieldstringnullable
Request field related to the error, if any.
Example: null
paramsobject[]required
Additional error parameters.
requestParamsobjectrequired
Request parameters captured for diagnostics.
]

Example

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "disabled",
        "errorType": "FORM",
        "errorId": "errTest1234",
        "errorDescription": "REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

401

Unauthorized. Merchant authentication headers are missing or invalid.

application/json

Schema

Schema

statusstringrequired
Response status.
Possible values: [error]
Example: error
data objectrequired
Error response payload.
errors object[]required
List of errors returned for the request.
Array [
errorMessagestringrequired
Stable machine-readable error code.
Example: userDoesNotExistException
errorTypestringrequired
Error category.
Example: GENERAL
errorIdstringrequired
Short unique error identifier for support and logs.
Example: errTest1234
errorDescriptionstringrequired
Human-readable error description.
Example: NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]
errorFieldstringnullable
Request field related to the error, if any.
Example: null
paramsobject[]required
Additional error parameters.
requestParamsobjectrequired
Request parameters captured for diagnostics.
]

Example

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "userDoesNotExistException",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

404

Not found. The requested resource does not exist.

application/json

Schema

Schema

statusstringrequired
Response status.
Possible values: [error]
Example: error
data objectrequired
Error response payload.
errors object[]required
List of errors returned for the request.
Array [
errorMessagestringrequired
Stable machine-readable error code.
Example: resourceNotFound
errorTypestringrequired
Error category.
Example: GENERAL
errorIdstringrequired
Short unique error identifier for support and logs.
Example: errTest1234
errorDescriptionstringrequired
Human-readable error description.
Example: Resource not found
errorFieldstringnullable
Request field related to the error, if any.
Example: null
paramsobject[]required
Additional error parameters.
requestParamsobjectrequired
Request parameters captured for diagnostics.
]

Example

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "resourceNotFound",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Resource not found",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

500

Internal server error. Unexpected error please contact support

application/json

Schema

Schema

statusstringrequired
Response status.
Possible values: [error]
Example: error
data objectrequired
Error response payload.
errors object[]required
List of errors returned for the request.
Array [
errorMessagestringrequired
Stable machine-readable error code.
Example: internalServerError
errorTypestringrequired
Error category.
Example: GENERAL
errorIdstringrequired
Short unique error identifier for support and logs.
Example: errTest1234
errorDescriptionstringrequired
Human-readable error description.
Example: Internal server error
errorFieldstringnullable
Request field related to the error, if any.
Example: null
paramsobject[]required
Additional error parameters.
requestParamsobjectrequired
Request parameters captured for diagnostics.
]

Example

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "internalServerError",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Internal server error",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}