Hosted Checkout

Once you have created a cart in the PaymentExpress system to hand off for payment using the Cart Handoff API, you will get a JSON response formatted like below.

{
  "cartId": "4ed4137c-3d89-44ad-92a1-c9f3e916f51e",
  "checkoutURL": "https://govhub.com/<<govhubClient>>/<<defaultOnlineLocation>>/redirect/4ed4137c-3d89-44ad-92a1-c9f3e916f51e"
}

📘

Cart Identifier Use in Error Handling

To ensure seamless integration and error recovery, it is essential that your system store the unique cart identifier cartId. This identifier is crucial not only for completing payments but also for verifying cart status, which aids in recovering from communication errors. The cartId must be stored within your system until you can successfully exchange it for the paymentId that completed this cart transaction.

At this point you can redirect the user on your system to the checkoutURL. This will direct the user to a PaymentExpress payment portal where the user will be shown the items in their cart, the total, and offer them the ability to make a payment with whatever supported tenders are enabled. Any fees that will result from the transaction and tender election will be made clear to the user as well.