This document covers the below mentioned topics:
Overview of Payment Without Login feature
Aptify release 7.3 introduces a new feature that allows members to make payments without logging into the e-Business application. Since the e-Business 6.0 release, we have a feature of paying off the unpaid orders which required the users to be logged in to the application and make multiple clicks to reach the page that handles this payment. In addition to this feature, we have introduced a new implementation brings in the benefit of reduced clicks and will save the users time by skipping the need of logging to the application. The users can use this feature only to pay off the entire outstanding amount for an order, partial payment of the amount is not allowed.
This release consists of only back-end implementation, including seventeen new services. To know more about the services, refer to the API documentation here.
As part of this implementation, below user messages have been introduced for certain scenarios and unsupported functionality:
Scenario | Message |
In case the Order ID does not belong to the Person ID. |
The Customer ID # does not match with the Order #
|
Cannot pay order with $0 balance | The Order # entered has already been paid |
Cannot pay order where Status is Cancelled | The Order ID # has been cancelled |
Cannot pay order where Order Date is more than 1 year old | This order is not eligible for payment. Please contact customer support for further assistance. |
How to Use Make A Payment Without Login Services with UI
This document illustrates how to build the user interface (UI) using services created for "Make Payment without Login" feature. For illustration purpose, we have considered UI implementation of this feature consisting of three pages: Order Validation, Order Details and Payment, and Order Confirmation.
Below are the details of the pages along with the services used.
Order Validation page
Order validation page is the landing page consisting of user id and order id, users are required to enter the details, enter the order id that is to be paid off and click Proceed button. On the click of the Proceed button, the GET v1/ValidateOrder/{id}/{orderID} service can be used to validate the order information with the customer id provided. The order payment is deemed invalid if any of the below given scenarios are true. The corresponding messages are returned by the service call and should be displayed on the screen, disallowing the payment process to be continued. Contrarily, if the order is valid, we navigate the user to the next page.
Scenario | Message |
In case the Order ID does not belong to the Person ID. |
The Customer ID # does not match with the Order #
|
Cannot pay order with $0 balance | The Order # entered has already been paid |
Cannot pay order where Status is Cancelled | The Order ID # has been cancelled |
Cannot pay order where Order Date is more than 1 year old | This order is not eligible for payment. Please contact customer support for further assistance. |
Order Details and Payment page
This page is to be shown to the user only for valid orders. The details of the order id provided in the previous page are retrieved and displayed with the help of the GET v1/OrderDetails/{id}/{orderId} service. The user can review the details before proceeding with the payment using the payment control that can be displayed on the same page.
The list of valid payment methods can be retrieved with the help of
GET v1/OrderDetails/{id}/{orderId}/ValidPayments?sort={sort} service.
The following services can be used for making payments in the same manner as the existing Make My Payment page found under the user's profile section on e-Business.
Make payment of the unpaid order using a credit card, without logging in. |
|
Make payment of the unpaid order using a ACH, without logging in. |
|
POST v1/OrderDetails/{id}/{orderId}/MakePayment/ACHTokenizer |
Make payment of the unpaid order using a ACH Tokenizer, without logging in. |
POST v1/OrderDetails/{id}/{orderId}/MakePayment/GetRemotePaymentRequest |
Get remote payment request data for make payment without login. |
POST v1/OrderDetails/{id}/{orderId}/MakePayment/ProcessRemoteResponse |
Processes the remote hosted payment response for make payment without login. |
Make payment of the unpaid orders using GPay, without login |
|
Make payment of the unpaid orders using Apple Pay, without login. |
After successful payment the user can be navigated to the order confirmation page.
Order Confirmation page
The Order Confirmation page is used to display the generated invoice along with the payment details.
The below given services can be used for retrieving and displaying the order details in the same manner as the existing Order Confirmation page on e-Business.
GET v1/OrderDetails/{id}/{orderId}/Items/{itemId} |
Gets the common properties of single orderline from the person's orders, without login. |
GET v1/OrderDetails/{id}/{orderId}/Items?sort={sort} |
Gets the common properties of all orderlines from the person's orders, without login. |
GET v1/OrderDetails/{id}/{orderId}/Items/{itemId}/SubscriptionGeneralProduct |
Gets the common properties of single subscription orderline from the person's orders, without login. |
v1/OrderDetails/{id}/{orderId}/Items/SubscriptionGeneralProduct?sort={sort} |
Gets the common properties of all subscription orderlines from the person's orders, without login. |
Gets the common properties of single event orderline from the person's orders, without login. |
|
v1/OrderDetails/{id}/{orderId}/Items/EventProduct?sort={sort} |
Gets the common properties of all event orderlines from the person's orders, without login. |
For sending a copy of the invoice via an email, make use of
POST v1/OrderDetails/{id}/{orderId}/SendConfirmationEmail service.
Comments
Please sign in to leave a comment.