Merchant Application API v2
The Merchant Application API allows you to submit applications for merchants to obtain credit card processing services.
Interactive Partner GUI Workflow
Return to the main Merchant Application v2 API documentation page.Overview
This usage scenario is for partners who have or intend to build their own interact web application for interacting with the merchant. In this particular scenario the API is used as the back-end and storage for in-process applications. This essentially allows a partner to build their own equivalent of Paysafe's web application for merchants. Please note that if the partner intends to use their own back-end systems to store in-progress applications they may prefer to implement the Batch Mode scenario that would push the application to Paysafe after the merchant had completed the necessary steps in the partner's application.
Swagger Documentation
Please note that API calls depicted in the below diagrams (green boxes) are shown using the name of that method as it appears in our Swagger Documentation. Please refer to the Swagger Documentation for details.
Start New Application (required)
Posting a DocumentSave data structure to the "Create Application" endpoint starts a new Merchant Application. The SalesRepID and PackageID are required, all other fields are optional. Starting a new empty application that contains no data can be useful because it will issue a unique ApplicationID Guid. If any validation or other errors occur during the creation process an HTTP error result code will be returend along with a ValidationResults structure containing messages describing the problem(s) that occurred. Please note that a new Application will not be created and an ApplicationID will not be issued if an error occurs or the data provided does not pass validation.
Load Existing Application (optional)
This depicts the process of retrieving an existing application that was created previously in order to view, make changes or perform actions upon it.
Continue Application (optional)
After an Application has been created its data can be fetched (returning an Application data structure) and updated (using the DocumentSave data structure). When performing an Update the information in the ApplicationSave structure will overwrite all information from prior Create or Update calls (documents are not affected). Please note that once an application has been progressed further through the workflow (such as moving it into states for obtaining a signature) its data becomes read-only and "Update Application" can no longer be called.
Document Actions (optional)
After an Application has been created it may contain Document attachments. Through the API the list of documents associated with an Application can be obtained and individual documents can be downloaded (for viewing), uploaded (added) or deleted. Each attached document has a Document Type which indicates its purpose and media type. Some documents are automatically generated by the system at certain points during the workflow. Documents that have a DocumentType which is automatically generated by the system can not be deleted. When adding documents, the encoding used must be Base64 (not raw binary).
Merchant's Signature (required)
Once all of the necessary information has been saved to an Applicaiton and any required Documents uploaded the merchant's signature must be obtained in order to finalize and submit the applicaiton for processing. The system supports multiple ways of obtaining the signature, the methods relevant to this workflow are listed below.
Physical Signature
One method of obtaining the merchant's signature is to have them physically sign the Merchant Processing Agreement. To do this call the "Submit for Applicaiton Signature" endpoint which will validate the application's data and, if valid, generate an unsigned copy of the agreement. Downlaod the generated, unsigned agreement and provide it to the mercahnt for their signature. Once the signed agreement has been obtained from the mercahnt scan it in and upload (attach) it to the application. Once the signed copy has been attached calls the "Submit Application for Processing" endpoint.
Please note that the merchant must sign the unaltered agreement that is generated by our system. Do not attempt to generate your own contract or alter the contract that is generated.
Virtual Signature
If the merchant entered their information using an interactive computer system (such as your own web application) you may be able to use our "click to agree" capability to have the merchant virtually sign the Merchant Processing Agreement. In order to use this method all information relevant the agreement including all rates & fees and the legal terms & conditions must be available to the merchant for reading. An additional check box or similar control labeled something like "Accept terms and conditions" must be displayed to the user and they must specifically mark the box themselves to indicate their agreement. For specifics or exceptions please discuss this with your partner representative.
Please note that all information contained in the Merchant Processing Agreement including all rates & fees plus the legal terms and conditions must be made available to the merchant prior to obtaining their virtual signature.
