Elavon generates all European and North American contractual documentation on a case by case basis. Documents are in HTML or PDF format.
Third-party documents can also be added as a part of merchant onboarding process, dynamically generated and signed along with Elavon documents. Contact our eBoarding team for more details. To utilise third-party document signing, partners must provide document templates in XHTML format and images in JPG or PNG format, as well as indicate where the images should be placed within their document templates. Partners must also provide a document name and document cardinal number. The document cardinal number is a unique identifier used to distinguish and reference an individual partner document when using eBoarding API operations.
Document signing uses the createdocumentpacket request with allied calls designed to help facilitate the document signing process within your system. For full details, always refer to the API Reference.
The following calls are outlined on this page:
- Create Document Packet
- Refresh Signer User Sessions
- Check Document Signing Status
- Push Signing Status (Optional)
- Get Unsigned Packet
- Get Signed Documents
- (NA) Retrieve Converge Credentials
- (NA) Routing Number Validation Request
- (NA) Postal Code Validation Request
- (NA) eID Quiz
Create Document Packet
In most implementations, this is the first API request. It provides:
-
A list of signer IDs of business owners for this and other calls.
-
A list of URLs of documents for business owners to read and, or to sign.
-
A document packet ID for ongoing reference.
Endpoint |
/createdocumentpacket |
---|---|
operationID |
createDocumentPacket |
Refresh Signer User Sessions
When the document URLs expire, use this call containing the document packet and signer IDs to issue a fresh set of URLs for your merchant to sign.
Endpoint |
/refereshSignerUserSessions |
---|---|
operationID |
refreshSignerUserSessions |
Check Document Signing Status
This call confirms who has, or has not completed document signing. It contains the document packet ID and signer ID.
Endpoint |
/checkDocumentSignerStatus |
---|---|
operationID |
checkDocumentSigningStatus |
Push Signing Status (Optional)
Implementing this call requires an Elavon software release. If you want to set up an endpoint and have us push the signing status to you, then please talk to our Solutions Engineering Team.
Get Unsigned Packet and Get Unsigned Document
These calls return the list of unsigned documents in the packet for collection and storage at your discretion. This call is very similar to Get Signed Packet.
Endpoint |
/getunsignedpacket |
---|---|
operationID |
getUnsignedDocumentsPacketContent |
Endpoint |
/getunsigneddocument |
---|---|
operationID |
getUnsignedDocumentContent |
Get Signed Packet
Returns the list of all signed documents. The call is very similar to Get Unsigned Packet.
Endpoint |
/getsignedpacket |
---|---|
operationID |
getSignedDocumentPacketContent |
NA Implementations
NA implementations include additional operations to those required of EU implementations.
(NA) Retrieve Converge Credentials
Depending on your implementation, Converge credentials are returned with a MID immediately or within 5 minutes of the account’s approval.
Endpoint |
/api/ |
---|---|
operationID |
getconvergecredentialsrequest |
(NA) Routing Number Validation Request
Invalid routing numbers cause a boarding error. This optional call is made before boarding to validate a bank routing number.
Endpoint |
/api/[versionNumber}/bank |
---|---|
operationID |
bankValidate |
(NA) Postal Code Validation Request
Invalid postal codes cause boarding errors. This optional call is made before boarding to validate a post code. Values in the response should be used to populate address fields in the boarding request.
Note: This currently applies only to Canadian and USA postal codes.
Endpoint |
/api/[versionNumber}/postal |
---|---|
operationID |
postalValidate |
(NA) eID Quiz
In the Canadian and USA regions, the eID Quiz feature meets the requirements of the Know Your Customer (KYC) guidelines.
The Quiz compares your principal applicants’ profiles against known fraudulent values. It effectively reduces the risk of boarding stolen, modified, and other high-risk identities. Fraudulent applications are declined immediately.
Depending on your implementation, our eBoarding API initiates and presents the eID Quiz to applicants who must then complete and submit it for validation before boarding.
Format the Result
For some implementations, you must extract the fraudCheckResult from the answerQuizResponse parameter block and insert it into the body of the boarding request.
Endpoints
Endpoint |
api/v1/getquiz |
---|---|
Input |
GetQuizRequest |
All portions of the GetQuizRequest are reused in the boarding call.
Endpoint |
api/v1/answerquiz |
---|---|
Input |
AnswerQuizRequest |
Related Content
❮ Back to API Operations, Errors, and CodesNext: Boarding ❯