Working with the Legacy Purchase and Payment Process in Norce Commerce

Purchase and Payment Processes

Norce Commerce supports multiple payment service providers (PSPs), grouped into three main types:

One-Step Payments

The customer completes payment in a single step, typically on the same page (e.g., invoice or pay-later methods).

One-step process Overview:
The following diagram shows the one-step payment process visually.

Process:

• User initiates purchase.
• Backend calls a purchase method in Norce Commerce.
• The response (PaymentResponse) contains status and next steps.

Purchase Methods:

• Purchase: Requires only basket ID.
• PurchaseEx: Allows overriding payment parameters.
• PurchaseEx2: Allows passing a full checkout object and payment parameters.

PaymentResponse Fields:

• Status, StatusDescription: Status details.
• IsSynchronous: True for one-step payments.
• OrderNo, PaymentReference, RedirectUrl, RedirectParameters: Order and payment details.

Two-Step Payments

The customer is redirected to a payment window (e.g., card payments).

Two-step process Overview:
The following diagram shows the two-step payment process visually.

Process:

1. Initiate purchase via Norce Commerce.
2. Receive redirect URL and parameters.
3. Redirect customer to PSP payment window.
4. Customer completes payment and is redirected back.
5. Validate payment using PaymentCallback or PaymentCallback2.

Callback Methods:

• PaymentCallback: Validates payment and starts order process.
• PaymentCallback2: Validates payment only.

Note:
Always validate the payment after redirection before showing the confirmation page.

Form-Based Payments

Description:
The payment form is embedded (e.g., in an iframe) on the checkout page. The PSP collects customer information and triggers the purchase.

Process:

1. Call GetPaymentForm to get form embed information.
2. Render the form in the UI.
3. Customer completes payment in the form.
4. Validate payment using PaymentFormCallback.

Callback Methods:

• PaymentFormCallback: Validates form payment (does not start order process).
• Use PaymentCallback if the order should be processed directly.

Order Confirmation

To display an order confirmation page:

• Call GetOrderRequest to get order details.
• Call GetCheckout to get the latest checkout object.

For two-step and form payments, pass the confirmation page URL to the PSP using the ShopCallbackUrl parameter.

Tip:
Add the BasketId as a query parameter to the ShopCallbackUrl for reliable confirmation page display.

Confirmation Notifications

Norce Commerce can send order confirmation emails using Sendgrid. Configure this in the Admin UI.
Alternatively, trigger notifications using Norce Commerce Events and look up order information via Norce Commerce Query.

Availability Checks During Checkout

You can check product availability during checkout using:

• ListProductOnHandByBasket: Returns OnHand info for all basket items.

Note:
Norce does not validate basket availability. Implement your own validation rules as needed.

Payment Capture (Settle)

Some payments require capture (settlement) after order delivery. You can use Norce Commerce’s capture functionality or handle it in your ERP system.

Read more about Payment Capture.

Additional Functionality

• Basket management
• Shopping integration
• Order receiver service

Important Payment Parameters

Different PSPs support different parameters. Norce maps common parameters to simplify integration.

Note:
For most PSPs, CountryCode cannot be updated mid-session. To change it, clear the old checkout ID and start a new session using StartNewSession.

Postman Samples

See Checkout samples in Postman.

Payment Adapters

• Walley Checkout
• Klarna Checkout (v3)
• Nets easy
• Svea

Gift Card Payment Adapters

• Retain24

Further Reading

• Setting up a PSP adapter
• Credit and refund
• About PSP adapters