Boarding Process Workflows
The following diagrams show the process, relevant APIs, and systems involved in the boarding workflow.
Process Flow for Boarding an Application
- First, the partner sends a Boarding Request to the Partner eBoarding API (PAPI).
- PAPI inspects the application data for required fields and correct formatting.
- If the data doesn’t pass, an error is sent back to the partner.
- The partner makes corrections and resubmits their application.
- Once PAPI determines that the data has passed (i.e. required fields are present and format is correct), the application is passed to the Global Boarding API (GBAPI).
- GBAPI receives the application and transforms data if needed.
- If the data doesn’t pass, an error is sent back to the partner, who will make corrections and resend the application.
- Once GBAPI determines everything is correct, it passes the application to Elavon’s Application Entry Portal (AEP).
- AEP receives the application and determines if the application is valid.
- If yes, an Application ID is generated (AWB for North America or MID for Europe).
- If no, AEP will return an error to the partner (via GBAPI and PAPI).
- The partner receives the response.
- If the response is an error message, then the partner makes application corrections and resubmits their application.
- If the response is the AWB (for North America) or MID (for Europe), then the partner is responsible for sending any required supporting documents to PAPI.
- PAPI receives supporting documents and sends the data to downstream systems.
- At this point, the application is put into the Elavon review process. The application may or may not be auto-approved.
- If auto-approved, no additional supporting documentation is required from the partner. An approval status will be returned.
- If declined, a declined status will be returned.
- If not auto-approved, then the application goes to a manual review process. If the operations or underwriting teams require additional information, a PEND status will be returned with a note of what needs to be corrected. At this point, a partner team will need to contact the customer to collect the missing data and make any necessary changes.
Process Flow for Checking the Status of an Application
After successfully submitting an application, the partner may want to find out the status of their application. Application statuses may be polled or pushed to a partner. Either way, the same data is available. Each partner needs to decide which method works best for them.
Polling for Status
- First, the partner sends a request to the Partner eBoarding API (PAPI) to request the status of their application.
- PAPI forwards the request through Global Boarding API (GBAPI) to Elavon’s Application Entry Portal (AEP).
- AEP receives the request and returns the application status back via the same path. Status responses can be: COMPLETE, INPROGRESS, DECLINED, WITHDRAWN, ERROR, TIMED_OUT, or PEND.
- Depending on the state and condition of the application, the status will also contain ERROR reasons, PEND reasons, underwriter contact information, and if APPROVED, point-of-sale configuration information.
Pushing for Status
If a partner wishes to receive the same information via push messaging, Elavon will work with the partner to collect partner end-point(s) and to choose the authorization method. For more information, see Push Notifications.