- Accounts
- Show
Accounts
Show
This feature is designed to provide detailed information regarding the details of a virtual account. It allows users to retrieve and view comprehensive data on a specific virtual account.
Information
| Method | Path | Format | Authentication |
|---|---|---|---|
| GET | /api/v1.0/accounts/{account_id} | json | OAuth 2.0 with Access Token |
Request Details
Headers Structure
| Field | Value | Type | Mandatory | Length | Description | Example |
|---|---|---|---|---|---|---|
| X-PARTNER-ID | api_key | Alphanumeric | Mandatory | API key obtained from the merchant dashboard. | b3ed7d4b-a96c-6c08-b3c7-12c3124242d9 | |
| Accept | application/json | Alphabetic | Mandatory | Specifies JSON as the expected response format. | application/json | |
| Authorization | Bearer {bearerToken} | Alphanumeric | Mandatory | Bearer token obtained from the get access token endpoint. | Bearer eyJ0eXAiOiJKV1{…} |
Response Details
This section outlines the structure and format of the data returned by the API when querying for details of a virtual account. The response is provided in JSON format and contains essential information such as the HTTP status code, success status, and the actual data pertaining to the virtual account.
Response Structure
| Field | Type | Mandatory | Length | Description | Example |
|---|---|---|---|---|---|
| status | Numeric | Mandatory | 3 | HTTP Status Code | 200 |
| success | Boolean | Mandatory | 1 | Indicates success status | true |
| data | Object | Conditional | Sub account object | ||
| > id | Alphanumeric | Mandatory | Sub account ID | 01K946KF851RK7FX075GJHBVKF | |
| > name | Alphanumeric | Mandatory | Full name of the account holder | rwa | |
| Alphanumeric | Mandatory | Email address of the account | admin@gmail.com | ||
| > phone | Alphanumeric | Mandatory | Phone number associated | 081234567890 | |
| > status | Enum | Mandatory | Account status values: active | active |
Response Example
Success: Here’s an example of a successful response.
{
"status": 200,
"success": true,
"data": {
"id": "01K946KF851RK7FX075GJHBVKF",
"name": "rwa",
"email": "admin@gmail.com",
"phone": "081234567890",
"status": "active"
}
}