> ## Documentation Index
> Fetch the complete documentation index at: https://primer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# nol Pay via Direct Integration

> Let customers securely make payments using nol Pay on your website or mobile application via Primer's direct integration.

| One Off Payment | Refunds |
| --------------- | ------- |
| ✓               | ✓       |

## Get started with nol Pay

### Before you begin

If this is your first payment method, make sure to follow the [Get started guide](/get-started/overview) to begin processing payments with Primer.

### Configure in the Dashboard

1. **Add nol Pay payment method to your Dashboard**

Go to the [Connections](https://dashboard.primer.io/connections/discover) section of the Dashboard and look for [nol Pay](https://sandbox-dashboard.primer.io/connections/marketplace/detail/undefined).

Follow the instructions to connect your nol Pay processor account to your Primer Dashboard.

2. **Activate nol Pay on the Checkout**

Go to the [Checkout](https://dashboard.primer.io/checkout) section of the Dashboard and activate the nol Pay payment method.

Then go to the settings view of nol Pay, and make sure that nol Pay is properly set up to use your nol Pay processor account.

3. **Configure a Workflow to process payments made with nol Pay**

Go to the [Workflow](https://dashboard.primer.io/workflow) make sure your nol Pay processor is used to process payments made with nol Pay.

### Prepare the client session

nol Pay leverages the following parameters to process a payment.

Pass them when creating the client session.

| Parameter Name                                                                                                                                                                                                                                                   | Required | Description                                                                                                                                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [currencyCode](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-currency-code)                                                                                                                                                  | ✓        | 3-letter currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format, e.g. `USD` for US dollars                                                                     |
| [order](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-order.)<br />[↳ lineItems](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-order-line-items)                                         | ✓        | Details of the line items of the order                                                                                                                                                          |
| [orderId](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-order-id)                                                                                                                                                            | ✓        | `orderId` will be passed to Nol as transaction id; it is mandatory, and must be unique. One `orderId` value cannot be used for multiple payments. Maximum length of `orderId` is 32 characters. |
| [amount](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#body-amount)                                                                                                                                                               | ✓        | Minimal value (in minor units): `500` Maximal value (in minor units): `200000`                                                                                                                  |
| [paymentMethod](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#request.body.paymentMethod)<br />[↳ descriptor](/api-reference/v2.4/api-reference/client-session-api/create-a-client-session#request.body.paymentMethod.descriptor) | ✓        | A description of the payment, as it would typically appear on a bank statement.                                                                                                                 |

## Add nol Pay into your website or mobile app

<CardGroup>
  <Card title="Headless Checkout" href="/connections/payment-methods/nol-pay/headless">
    Have the freedom to build your own UI using our headless checkout.
  </Card>
</CardGroup>
