Skip to end of metadata
Go to start of metadata

Use case 1: Responsive and adaptive checkout experience


In this scenario, you leverage Nexway’s responsive and adaptive checkout user interface. You can embed the checkout experience in a store (web or mobile) or within an application. No development is needed, and you can do all the configuration through Nexway Center or through our REST API.

Step 1: Get your Customer credential
Once Nexway has created your customer ID, we will send you by email an API key if you use our APIs with an Application & a username, along with a password to access our endpoints.

These credentials will allow you to use a JWT Access token which is used for API authentication and authorization.

Then, you can start building and experimenting your checkout experience leveraging our SaaS User Interface (Nexway Center) or our REST API (API Documentation).

Step 2: Define product to be sold
You can use two methods: through API and/or SAAS user interface (Nexway Center).
The product has been designed to allow a maximum of flexibility and avoid structured in 2 parts: the common part and the variants. You fulfill only the information required for your checkout experience and at least one variant. Variants allow you to create different price configuration of the same product (including currency and country management).

Step 3: Define your store (optional)
If needed, the default store can be adapted considering:

  • Multi-currency support
  • End-user account management activation
  • End-user support
  • Localization
  • Default product

Step 4: Test your checkout experience 

You are ready to test and process your first purchase:

Connect to the checkout URL and specify the parameters to adapt the checkout experience to your needs. After you've set the parameters, the checkout is ready to run and will process the purchase workflow (payment, order, fulfillment, invoicing, renewals). Once the purchase is processed, you will see a confirmation page and receive an email confirmation.

Step 5: Check and Manage your orders
You can select and view orders created through Nexway Center or REST API in real time. Orders contain all the information related to the sale.
If required, you can cancel an order.

Step 6: Analyze your business
Nexway Center provides you with a dashboard and reports to help you analyze and understand trends in your business.

Scenario 2: Direct use of Purchase API (mobile app, homemade checkout)


In this scenario, you are not using Nexway Checkout experience. you implement your own user interface and leverage the purchase API to process the transaction
Only step 4 (as explained in scenario 1) is affected — the other steps are the same.

Step 4: Implement the API sales transaction workflow in your application
Only three API calls are required to process a purchase:

  1. Get the payment token to secure the transaction.
  2. Encrypt the payment data using the payment token (RSA algorithm with encryption scheme pkcs1).
  3. Trigger the Purchase workflow by providing the following information:
    • Store ID
    • End-user information
    • Product ID and quantity
    • Encrypted payment data
  • No labels