Merchant Account
Server-side response object returned directly or within a successful result object from the following requests:
Attributes
Business information specific to an Active sub-merchant.
AddressDetailsstringBusiness address information specific to a particular sub-merchant.
LocalitystringThe locality/city.
PostalCodestringThe postal code.
RegionstringThe state or province.
StreetAddressstringThe street address.
DbaNamestringThe "Doing Business As" name.
LegalNamestringThe legal name.
TaxIdstringThe 9-digit numeric value associated with the business' tax identity.
CurrencyIsoCodestringThe ISO code for the currency the merchant account uses. See the ISO 4217 codes.
IsDefaultboolWhether transactions will be run using this merchant account by default.
Funding information specific to an Active sub-merchant.
AccountNumberLastFourstringThe last 4 digits of the applicant's checking account number.
DescriptorstringThe value that determines the description that will appear on a sub-merchant's bank statement for deposits.
DestinationstringThe way in which funds will be delivered to a specific sub-merchant. Learn more about sub-merchant funding.
EmailstringThe email address.
MobilePhonestringThe mobile phone number.
RoutingNumberstringThe numeric string representing a specific bank.
IdstringSpecifies the ID of the sub-merchant, which can be referenced when creating transactions with service fees.
Information specific to an Active sub-merchant.
Address information specific to a particular sub-merchant.
LocalitystringThe locality/city.
PostalCodestringThe postal code.
RegionstringThe state or province.
StreetAddressstringThe street address.
DateOfBirthstringThe applicant's date of birth.
EmailstringEmail address composed of ASCII characters.
FirstNamestringThe first name.
LastNamestringThe last name.
PhonestringThe phone number.
SsnLastFourstringThe last 4 digits of the applicant's social security number (SSN).
The master merchant account that the sub-merchant account belongs to.
StatusstringThe state of the merchant account can either be Pending, Active, or Suspended.
Result Object
A merchant account result may be successful or unsuccessful. Learn more about
result objects.
Successful result
If the result was successful, the merchant account will have a Pending status. Within several minutes you should expect to receive a
confirmation webhook. The
sub-merchant and its master merchant account will be provided on the result. The sub-merchant status
is pending at this point because (in production) we are taking the data provided, securely
contacting a number of third-party services to verify the information, and making sure there are no
red flags. This provides you with fraud protection while also satisfying our standard risk and
underwriting process for new merchants. This means that a response will be delayed by just a minute
or two (in production), so you will need to use
webhooks to listen for a
response and confirm that the sub-merchant has successfully passed these checks.
- CS
result.IsSuccess();
// true
MerchantAccount ma = result.Target;
ma.Status == MerchantAccountStatus.PENDING
// true
ma.Id;
// "blue_ladders_store"
ma.MasterMerchantAccount.Id;
// "14ladders_marketplace"
ma.MasterMerchantAccount.Status == MerchantAccountStatus.ACTIVE
// trueUnsuccessful result
Success will return false if
validations
prevent the merchant account from on-boarding. To simulate unsuccessful API calls in Sandbox, check
out our
test values for merchant account creation
.
Validation errors
If any parameters are invalid, then the success call will return false and the
result object will contain
validation errors
indicating which parameters were invalid.
- CS
if (!result.IsSuccess()) {
ValidationErrors errors = result.Errors;
}