# Norce Commerce - PSP Adapters

PSP (Payment Service Provider) adapters, are included in the Norce Commerce platform and integrated through the backend of the PSP's.

In order to use a PSP-adapter, you must first sign up with one of our PSP-partners and request that we add and configure the adapter for you. Additionally, you will need to make some adjustments to your frontend application and, in certain cases, your ERP system application.

### Form-based Payment process

*Many PSP's uses form based checkout processes.*


```mermaid
%%{init: {'theme':'default'}}%%

sequenceDiagram
    autonumber
    participant FE as Front-End
    participant BE as Back-End
    participant N as Norce
    participant P as PSP

    FE->>BE: Ready to buy
    BE->>N: Calls GetPaymentForm
    N->>+P: Initialize Payment
    BE->>FE: Render the form <br/>(display an iframe)

    loop Optional While changes happens on an active checkout page
        FE->>P: Interact using JS-libraries
    end

    FE->>P: Confirm purchase (in the iframe)
    P->>N: ValidatePayment
    N->>BE: Optional validation callback
    Note left of P: Processing the Payment
    P->>N: Calls PaymentComplete
    P->>-FE: Completed Payment (Redirect to confirm page)
    FE->>BE: Confirmation<br/> (and show thank you page)
    BE->>N: Calls PaymentCallback
    N->>P: Verifies Payment
```

### Payment process (without form-based integration)

*Still functional, used in som B2B cases.*


```mermaid
%%{init: {'theme':'default'}}%%

sequenceDiagram
    autonumber
    participant FE as Front-End
    participant BE as Back-End
    participant N as Norce
    participant P as PSP

    FE->>BE: Start the checkout
    BE->>N: GetCheckout
    N-->>+P: Initialize Payment
    
    loop Optional Changes
        FE->>BE: Add discount code /<br/>extended information on basket
        BE->>N: UpdateBasket /<br/>UpdateBasketItem
        N-->>P: Update Payment
    end
    FE->>BE: Choose Delivery /<br/>Payment
    BE->>N: UpdateDeliveryMethod /<br/>UpdatePaymentMethod

    FE->>BE: Update Customer info
    BE->>N: UpdateBuyer /<br/>UpdatePayer /<br/>UpdateShipTo

    FE->>BE: Press Buy /<br/>Create the purchase
    BE->>N: PurchaseEx
    N-->>P: Commit Payment
    P-->>-N: Returns payment info
    BE->>FE: Show "thank you" page
```

### After the checkout payment process


```mermaid
%%{init: {'theme':'default'}}%%

sequenceDiagram
    autonumber
    participant N as Norce
    participant P as PSP
    participant I as Integrations

    P-->>N: Completing the payment
    N->>I: Send Order to ERP
    I->>N: Order Confirmation

    loop Optional integrations
        I->>N: Delivery Note
        I->>N: Invoice
        N-->>P: Capture Payment
        I->>N: Order Status changes
        
        I->>N: Credit Payment
        N-->>P: Credit Payment
    end
```

## Suggested further reading

- [Walley Checkout](/solution-portal/psp-adapter-walley)
- [Klarna Checkout (v3) PSP adapter](/solution-portal/psp-adapter-kcov3)
- [Nets Easy PSP adapter](/solution-portal/psp-adapter-netseasy)
- [Resurs Checkout](/solution-portal/psp-adapter-resurs)
- [AwardIT (Retain 24)](/solution-portal/psp-adapter-retain24)
- [Svea Checkout](/solution-portal/psp-adapter-sveacheckout)