Retrieve detailed information about a specific merchant account.
GET/v2/projects/{project_id}/merchant-accounts/{merchant_account_id} Path Parameters
The unique identifier of the project.
The unique identifier of the merchant account.
Query Parameters
Include additional data. Use 'requirements' to include requirement fields for accounts that have requirements.
curl -X GET "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/merchant-accounts/11111111-1111-1111-1111-111111111111" \
-H "Authorization: Bearer YOUR_TOKEN"
const project_id = 'YOUR_PROJECT_ID';
const merchant_account_id = '11111111-1111-1111-1111-111111111111';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/merchant-accounts/${merchant_account_id}`, {
method: 'GET',
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
import requests
project_id = 'YOUR_PROJECT_ID'
merchant_account_id = '11111111-1111-1111-1111-111111111111'
response = requests.get(
f'https://api.botsubscription.com/v2/projects/{project_id}/merchant-accounts/{merchant_account_id}',
headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
data = response.json()
$project_id = 'YOUR_PROJECT_ID';
$merchant_account_id = '11111111-1111-1111-1111-111111111111';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/merchant-accounts/{$merchant_account_id}");
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
Successapplication/json
{
"ok": true,
"request_id": "11111111-1111-1111-1111-111111111111",
"method": "GET",
"path": "/v2/projects/YOUR_PROJECT_ID/merchant-accounts/11111111-1111-1111-1111-111111111111",
"code": 200,
"message": "Merchant account retrieved successfully",
"data": {
"merchant_account_id": "11111111-1111-1111-1111-111111111111",
"provider": "stripe",
"environment": "sandbox",
"active": true,
"has_requirements": false,
"configuration_editable": false,
"label": null
}
}
Success with requirements (expand=requirements)application/json
{
"ok": true,
"request_id": "11111111-1111-1111-1111-111111111111",
"method": "GET",
"path": "/v2/projects/YOUR_PROJECT_ID/merchant-accounts/22222222-2222-2222-2222-222222222222",
"code": 200,
"message": "Merchant account retrieved successfully",
"data": {
"merchant_account_id": "22222222-2222-2222-2222-222222222222",
"provider": "nowpayments",
"environment": "sandbox",
"active": true,
"has_requirements": true,
"configuration_editable": false,
"label": null,
"requirements": {
"fields": [
{
"id": "pay_currency",
"label": "Settlement Currency",
"description": "Cryptocurrency that the customer must use to complete the payment.",
"type": "enum",
"required": true,
"is_editable": false,
"selection": {
"mode": "single",
"min": 1,
"max": 1,
"allow_empty": false
},
"options": {
"allow_custom": false
}
}
]
}
}
}
Merchant account not foundapplication/json
{
"ok": false,
"request_id": "11111111-1111-1111-1111-111111111111",
"method": "GET",
"path": "/v2/projects/YOUR_PROJECT_ID/merchant-accounts/11111111-1111-1111-1111-111111111111",
"code": 404,
"error": {
"error_code": "NOT_FOUND",
"message": "Merchant account not found"
}
}
Last updated: