Create processing account
Use this method to create a processing account and add it to a merchant platform.
Note: You can create and add a processing account only to an existing merchant platform. If you have not already created a merchant platform, go to Create a merchant platform.
In the response we return a processingAccountId for the processing account, which you need for the following methods.
Path parameters
Unique identifier of the merchant platform that we sent to you when you created the merchant platform.
Headers
Bearer authentication of the form Bearer <token>, where token is your auth token.
Unique identifier that you generate for each request. You must use the UUID v4 format for the identifier. For more information about the idempotency key, go to Idempotency.
Request
Trading name of the business.
Collection of individuals that are responsible for a processing account. When you create a processing account, you must indicate at least one owner as either of the following:
- Control prong - An individual who has a significant equity stake in the business and can make decisions for the processing account. You can add only one control prong to a processing account.
- Authorized signatory - An individual who doesn’t have an equity stake in the business but can make decisions for the processing account.
Type of business.
Category code for the type of business.
Description of the services or merchandise sold by the business.
Date that the business was established. The format of the value is YYYY-MM-DD.
The timezone for the processing account
Array of contactMethod objects. One contact method must be an email address.
Object that contains pricing information.
Method used to capture the owner’s signature.
Note: If you request the owner’s signature by email and they don’t respond, use our Reminders endpoint to create a reminder and to send another email.
Unique identifier of the processing account.
Website address of the business.
Array of contact objects.
Object that you can send to include custom data in the request.
Response
Successful request. We created the processing account.
Trading name of the business.
Object that contains information about the owners of the business.
Type of business.
Category code for the type of business.
Description of the services or merchandise sold by the business.
The timezone for the processing account
Array of contactMethods objects for the processing account. Atleast one contactMethod must be an email address.
Object that contains funding information.
Object that contains pricing information.
Object containing the method we used to capture the owner’s signature.
Unique identifier of the processing account.
Date and time that we received your request to create the processing account in our system.
Date and time that the processing account was last modified.
Status of the processing account.
entered- We have received information about the account, but we have not yet reviewed it.pending- We have reviewed the information about the account, but we have not yet approved it.approved- We have approved the account for processing transactions and funding.subjectTo- We have approved the account, but we are waiting on further information.dormant- Account is closed for a period.nonProcessing- We have approved the account, but the merchant has not yet run a transaction.rejected- We rejected the application for the processing account.terminated- Processing account is closed.cancelled- Merchant withdrew the application for the processing account.
Website address of the business.
Date that the business was established. The format of the value is YYYY-MM-DD.
Array of contact objects.
Object that you can send to include custom data in the request.
Array of useful links related to your request.