Skip to main content

Get User Info

GET
/user/me/

Get information about the authenticated merchant account (tenant).

Authentication

Requires OAuth 2.0 authentication with read and write scopes.

Example Request

curl -X GET {{BASE_URL}}/user/me/ \
-H "Authorization: Bearer your_access_token"

Response

Success Response (200 OK)

{
"name": "Acme Corporation",
"transaction_fee": "1.0",
"is_fee_paid_by_user": true,
"webhook_callback_url": "https://acme.com/webhook/cryptofuse",
"webhook_secret_masked": "wh_secret_ab..."
}

Response Fields

FieldTypeDescription
namestringMerchant business name
transaction_feedecimalTransaction fee percentage
is_fee_paid_by_userbooleanWhether customers pay transaction fees
webhook_callback_urlstring|nullConfigured webhook callback URL, or null if not set
webhook_secret_maskedstring|nullPartially masked webhook secret for identification, or null if not set

Usage Examples

Account Configuration Check

async function checkAccountConfig(accessToken) {
const response = await fetch('{{BASE_URL}}/user/me/', {
headers: {
'Authorization': `Bearer ${accessToken}`
}
});

const account = await response.json();

console.log(`Account: ${account.name}`);
console.log(`Fee: ${account.transaction_fee}%`);
console.log(`Fee paid by: ${account.is_fee_paid_by_user ? 'Customer' : 'Merchant'}`);
console.log(`Webhook URL: ${account.webhook_callback_url || 'Not configured'}`);

return account;
}

Python Example

def display_account_config(access_token):
"""Display current account configuration."""

response = requests.get(
'{{BASE_URL}}/user/me/',
headers={'Authorization': f'Bearer {access_token}'}
)

if response.status_code == 200:
account = response.json()

print(f"Account: {account['name']}")
print(f"Transaction Fee: {account['transaction_fee']}%")
print(f"Paid by: {'Customer' if account['is_fee_paid_by_user'] else 'Merchant'}")
print(f"Webhook URL: {account['webhook_callback_url'] or 'Not configured'}")
print(f"Webhook Secret: {account['webhook_secret_masked'] or 'Not set'}")

Error Responses

401 Unauthorized

{
"error": {
"code": "authentication_failed",
"message": "Invalid or missing authentication token",
"details": {}
}
}

403 Forbidden

{
"error": {
"code": "permission_denied",
"message": "Token does not have required scope",
"details": {
"required_scopes": ["read", "write"],
"token_scopes": []
}
}
}

Next Steps