Merchant Legal Documents
The Legal Documents API allows you to retrieve, create, and manage legal documents required during merchant onboarding.
These documents include the merchant application, addendums, and other agreements that may require customer acknowledgment or signature.
Using legal documents API, you can:
Retrieve available legal documents and their settings
Display the latest document versions to users
Submit signed documents for onboarding
Xplor Pay does not currently offer that determines which legal documents are required for a given application. You must implement this logic within your own system.
Review any changes to the signature collection process with Xplor Pay before deploying to production.
The Legal Documents endpoints have been introduced to replace the deprecated Signature endpoints. While the previous Signature endpoints remain functional for backward compatibility, developers should migrate to the Legal Documents endpoints for all new implementations.
Early versions of the Legal Documents endpoints supported alternative routing through
/api/demographics/in addition to the standard/api/legaldocuments/path. This dual-route support was maintained through application versions V1 and V2 but was removed in V3. All requests should now use the/api/legaldocuments/route.
Configured legal documents
Merchant Application - Required for all new merchants.
PAYA Consent to Share - Required for merchants with one or more PAYA equipment orders.
PAYA ACH Addendum - Required for merchants with one or more PAYA equipment orders.
Xplor Pay TOS Addendum - Required for merchants with one or more Xplor Pay POS equipment orders.
CBD Attestation - Required for merchants who sell CBD.
Sporting Goods and Firearms Addendum - Required for merchants who sell either firearms or firearms accessories.
Empower Attestation - Required for merchants participating in the Empower program.
Typical workflow
Retrieve the list of legal documents and their settings.
Identify the legal documents to show to the signer.
Retrieve and display the terms and conditions to the signer.
Submit the signed documents to Xplor Pay.
Last updated
Was this helpful?