Fetch Dedicated Account
Get details of a dedicated virtual account on your integration.
Endpoint: GET https://api.budpay.com/api/v2/dedicated_account/:id
Parameters
This section details the header information required for fetching a dedicated account.
| Field Name | Description |
|---|---|
| URL | https://api.budpay.com/api/v2/dedicated_account/:id |
| Method | GET |
| Authorization | Bearer YOUR_SECRET_KEY (Replace with your actual BudPay secret key) |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | Integer | Yes | ID of the dedicated virtual account |
Sample Request
curl https://api.budpay.com/api/v2/dedicated_account/50 \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-X GETSample Response
{
"status": true,
"message": "Customer account retrieved",
"data": {
"transactions": [],
"authorizations": [],
"customer": {
"first_name": "Pay",
"last_name": "Bud",
"email": "customer3@budpay.com",
"phone": null,
"customer_code": "CUS_sb7na27qeas7htr",
"id": 6,
"created_at": "2022-03-12T16:50:14.000000Z",
"updated_at": "2022-02-09T13:32:31.000000Z"
},
"domain": "test",
"dedicated_account": {
"id": 50,
"account_name": "Samji Ventures / Pay Bud",
"account_number": "1671149520",
"currency": "NGN",
"status": "active",
"created_at": "2022-03-12T15:50:20.000000Z",
"updated_at": "2022-03-12T15:50:20.000000Z"
},
"provider": {
"id": 1,
"bank_code": "000017",
"bank_name": "Wema Bank",
"prefix": "802"
},
"assignment": "reserved"
}
}Try it out
Response Fields
| Field | Description |
|---|---|
customer | Customer details attached to the account |
dedicated_account | Virtual account details (number, name, status) |
provider | Bank providing the virtual account |
transactions | Array of transactions on this account |
authorizations | Array of saved payment authorizations |
domain | Environment (test or live) |