Retrieve a merchant profile
Retrieves merchant profile data.
- 200
- 401
- 403
OK
- application/json
- Schema
- Example (from schema)
Schema
- merchant_code string
Unique identifying code of the merchant profile
- company_name string
Company name
- website string
Website
legal_type object
Id of the legal type of the merchant profile
id numberUnique id
full_description stringLegal type description
description stringLegal type short description
sole_trader booleanSole trader legal type if true
- merchant_category_code string
Merchant category code
- mobile_phone string
Mobile phone number
- company_registration_number string
Company registration number
- vat_id string
Vat ID
- permanent_certificate_access_code string
Permanent certificate access code (Portugal)
- nature_and_purpose string
Nature and purpose of the business
address object
Details of the registered address.
address_line1 stringAddress line 1
address_line2 stringAddress line 2
city stringCity
country stringCountry ISO 3166-1 code
region_id numberCountry region id
region_name stringRegion name
region_code stringRegion code
post_code stringPostal code
landline stringLandline number
first_name stringundefined
last_name stringundefined
company stringundefined
country_details object
Country Details
currency stringCurrency ISO 4217 code
iso_code stringCountry ISO code
en_name stringCountry EN name
native_name stringCountry native name
timeoffset_details object
TimeOffset Details
post_code stringPostal code
offset numberUTC offset
dst booleanDaylight Saving Time
state_id stringundefined
business_owners object[]
Account's business address information
first_name stringBO's first name
last_name stringBO's last name of the user
date_of_birth stringDate of birth
mobile_phone stringMobile phone number
landline stringBO's Landline
ownership numberOwnership percentage
doing_business_as object
Doing Business As information
business_name stringDoing business as name
company_registration_number stringDoing business as company registration number
vat_id stringDoing business as vat id
website stringDoing business as website
email stringDoing business as email
address
address_line1 stringAddress line 1
address_line2 stringAddress line 2
city stringCity
country stringCountry ISO 3166-1 code
region_id numberCountry region id
region_name stringCountry region name
post_code stringPostal code
settings object
Merchant settings (like \"payout_type\", \"payout_period\")
tax_enabled booleanWhether to show tax in receipts (saved per transaction)
payout_type stringPayout type
payout_period stringPayout frequency
payout_on_demand_available booleanWhether merchant can edit payouts on demand
payout_on_demand booleanWhether merchant will receive payouts on demand
printers_enabled booleanWhether to show printers in mobile app
payout_instrument stringPayout Instrument
moto_payment stringPossible values: [
UNAVAILABLE
,ENFORCED
,ON
,OFF
]Whether merchant can make MOTO payments
stone_merchant_code stringStone merchant code
adyen_merchant_code stringAdyen merchant code
adyen_user stringAdyen username
adyen_password stringAdyen password
adyen_company stringAdyen company
daily_payout_email booleanWhether merchant will receive daily payout emails
monthly_payout_email booleanWhether merchant will receive monthly payout emails
gross_settlement booleanWhether merchant has gross settlement enabled
vat_rates object
Merchant VAT rates
id numberInternal ID
description stringDescription
rate numberRate
ordering numberOrdering
country stringCountry ISO code
- locale string
Merchant locale (for internal usage only)
bank_accounts object[]
bank_code stringBank code
branch_code stringBranch code
swift stringSWIFT code
account_number stringAccount number
iban stringIBAN
account_type stringType of the account
account_category stringAccount category - business or personal
account_holder_name stringstatus stringStatus in the verification process
primary booleanThe primary bank account is the one used for settlemnts
created_at stringCreation date of the bank account
bank_name stringBank name
- extdev boolean
True if the merchant is extdev
- payout_zone_migrated boolean
True if the payout zone of this merchant is migrated
- country string
Merchant country isocode (for internal usage only)
{
"merchant_code": "string",
"company_name": "string",
"website": "string",
"legal_type": {
"id": 0,
"full_description": "string",
"description": "string",
"sole_trader": true
},
"merchant_category_code": "string",
"mobile_phone": "string",
"company_registration_number": "string",
"vat_id": "string",
"permanent_certificate_access_code": "string",
"nature_and_purpose": "string",
"address": {
"address_line1": "string",
"address_line2": "string",
"city": "string",
"country": "string",
"region_id": 0,
"region_name": "string",
"region_code": "string",
"post_code": "string",
"landline": "string",
"first_name": "string",
"last_name": "string",
"company": "string",
"country_details": {
"currency": "string",
"iso_code": "string",
"en_name": "string",
"native_name": "string"
},
"timeoffset_details": {
"post_code": "string",
"offset": 0,
"dst": true
},
"state_id": "string"
},
"business_owners": [
{
"first_name": "string",
"last_name": "string",
"date_of_birth": "string",
"mobile_phone": "string",
"landline": "string",
"ownership": 0
}
],
"doing_business_as": {
"business_name": "string",
"company_registration_number": "string",
"vat_id": "string",
"website": "string",
"email": "string",
"address": {
"address_line1": "string",
"address_line2": "string",
"city": "string",
"country": "string",
"region_id": 0,
"region_name": "string",
"post_code": "string"
}
},
"settings": {
"tax_enabled": true,
"payout_type": "string",
"payout_period": "string",
"payout_on_demand_available": true,
"payout_on_demand": true,
"printers_enabled": true,
"payout_instrument": "string",
"moto_payment": "UNAVAILABLE",
"stone_merchant_code": "string",
"adyen_merchant_code": "string",
"adyen_user": "string",
"adyen_password": "string",
"adyen_company": "string",
"daily_payout_email": true,
"monthly_payout_email": true,
"gross_settlement": true
},
"vat_rates": {
"id": 0,
"description": "string",
"rate": 0,
"ordering": 0,
"country": "string"
},
"locale": "string",
"bank_accounts": [
{
"bank_code": "string",
"branch_code": "string",
"swift": "string",
"account_number": "string",
"iban": "string",
"account_type": "string",
"account_category": "string",
"account_holder_name": "string",
"status": "string",
"primary": true,
"created_at": "string",
"bank_name": "string"
}
],
"extdev": true,
"payout_zone_migrated": true,
"country": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
- Invalid_ Token
- Not_ Authorized_ Token
- Missing_ Token
Schema
- message string
Short description of the error.
- error_code string
Platform code for the error.
{
"message": "string",
"error_code": "string"
}
{
"error_message": "invalid access token",
"error_code": "NOT_AUTHORIZED"
}
{
"error_message": "NOT_AUTHORIZED",
"error_code": "NOT_AUTHORIZED"
}
{
"message": "access token required",
"error_code": "NOT_AUTHORIZED"
}
Forbidden
- application/json
- Schema
- Example (from schema)
- Forbidden
Schema
- error_message string
Short description of the error.
- error_code string
Platform code for the error.
- status_code string
HTTP status code for the error.
{
"error_message": "string",
"error_code": "string",
"status_code": "string"
}
{
"error_message": "request_not_allowed",
"error_code": "FORBIDDEN",
"status_code": 403
}