https://{your-domain}.fincode.software/api/v1/services/user/view-bank-account/{account-id}
{
"status": "<string>",
"data": {
"accountId": "<string>",
"customerId": "<string>",
"accountNumber": "<string>",
"accountName": "<string>",
"bankCode": "<string>",
"bankName": "<string>",
"accountType": "<string>",
"isDefault": true,
"isVerified": true,
"createdDate": "<string>"
}
}API Endpoints
View Bank Account
Retrieves details of a specific bank account by its ID.
GET
/
api
/
v1
/
services
/
user
/
view-bank-account
/
{account-id}
https://{your-domain}.fincode.software/api/v1/services/user/view-bank-account/{account-id}
{
"status": "<string>",
"data": {
"accountId": "<string>",
"customerId": "<string>",
"accountNumber": "<string>",
"accountName": "<string>",
"bankCode": "<string>",
"bankName": "<string>",
"accountType": "<string>",
"isDefault": true,
"isVerified": true,
"createdDate": "<string>"
}
}Fetches detailed information about a bank account registered by the customer.
https://{your-domain}.fincode.software/api/v1/services/user/view-bank-account/{account-id}
Request Headers
string
required
The JWT Access Token obtained from the
/login or /refresh-token endpoint.string
required
The date and time at which the request was initiated (ISO 8601 format).
string
required
The IP address of the customer making the request.
string
required
Unique identifier for the interaction/session.
Path Parameters
string
required
The unique identifier (UUID) of the bank account to retrieve.
Response
Returns bank account details.string
default:"SUCCESS"
Overall status of the API request.
object
Bank account details.
Show data object
Show data object
string
Unique identifier for the bank account.
string
Identifier of the customer.
string
Bank account number (may be masked).
string
Account holder name.
string
Bank code.
string
Bank name.
string
Type of account.
boolean
Whether this is the default account.
boolean
Whether the account has been verified.
string
Date when the account was added.
Code Examples
curl --location 'https://{your-domain}.fincode.software/api/v1/services/user/view-bank-account/123e4567-e89b-12d3-a456-426614174000' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'x-fapi-auth-date: 2024-01-15T10:30:00Z' \
--header 'x-fapi-customer-ip-address: 192.168.1.1' \
--header 'x-fapi-interaction-id: interaction-12345'
const axios = require('axios');
const BASE_URL = 'https://{your-domain}.fincode.software/api/v1/services/user';
async function viewBankAccount(accessToken, accountId) {
try {
const response = await axios.get(
`${BASE_URL}/view-bank-account/${accountId}`,
{
headers: {
'X-Auth-Token': accessToken,
'x-fapi-auth-date': new Date().toISOString(),
'x-fapi-customer-ip-address': '192.168.1.1',
'x-fapi-interaction-id': `interaction-${Date.now()}`,
},
}
);
return account;
} catch (error) {
console.error(
'Failed to fetch bank account:',
error.response?.data || error.message
);
throw error;
}
}