Request payment from your customer

By this point, you've successfully created an order in the N-Genius Online gateway, and the next step is to request payment from your customer.

To do so, redirect them to the payment page URL provided in the response to your Create Order request. Specifically, this can be found under:

response._links.payment.href

This value is sometimes referred to as the order_paypage_url. Here's an example:

"payment": {
  "href": "https://paypage.sandbox.ngenius-payments.com/?code=f46dd85a27fec749"
}

This URL launches the hosted payment page where N-Genius Online will handle both 3-D Secure authentication and payment authorization for you.
You may choose to redirect your customer via full-page redirect, a lightbox, or embed the page using an , depending on your integration approach.

Getting the payment outcome

In order to receive the outcome of the payment, it is recommended that merchants using this integration type also configure their N-Genius Online gateway to send call-back/web-hook notifications, so that they may be received and interpreted.

Alternatively, you may also interrogate the ‘ref’ query parameter that will be added to the redirectUrl you have specified. This will contain the order reference _value, which you may use (in conjunction with a new _access_token value, if required) to query the outcome of a payment with a GET call to the N-Genius Online APIs.

See Consuming web-hooks for more information about configuring and interpreting web-hook data, and Retrieve order status for an example of using the ‘ref’ value to retrieve the payment outcome manually.