Terminal onboarding

Before you can charge a customer on a terminal, the terminal has to be linked to a store, and the store has to be linked to a payout destination. You can complete the whole onboarding in Backoffice, or automate the store and terminal steps via the management API.

Step 1: Onboard a payout destination

The payout destination is the seller of record - the entity that receives the funds. KYC is a one-time step per legal entity.

Backoffice
Management API

Go to Payout destination and click the + Payout destination button.
Select a business. Make sure the country is correct. Enter your own Payout destination ID, choose the Payout frequency, enter an email address (Optional. If an email is entered, Dintero will automatically send the recipient the KYC link after saving), and click Save.
After saving, a link is generated to complete KYC.
Open the link and complete the KYC form, including signing the agreement. The payout destination is ready when the status is Approved.

Create a payout destination with POST /accounts/{aid}/management/settings/approvals/payout-destinations.

POST /accounts/{aid}/management/settings/approvals/payout-destinations
Authorization: Bearer <token>
Content-Type: application/json

{
  "payout_destination_id": "my-seller",
  "payout_reference": "My Company AS",
  "organization_number": "923663487",
  "country_code": "NO",
  "bank_accounts": [
    {
      "bank_account_number": "12345678901",
      "bank_account_currency": "NOK"
    }
  ],
  "form_submitter": {
    "email": "contact@example.com"
  }
}

Open the URL in the response links array to complete the declaration form and sign the agreement.Track approval status by:

Webhook: subscribe to approval_payout_destination_update. The payout destination is ready when case_status is ACTIVE.
Polling: GET /accounts/{aid}/management/settings/approvals/payout-destinations

For more detail on the KYC flow and reminder emails, see Add sellers and payout destinations.

Step 2: Create a store

A store represents a physical location. Stores are linked to one payout destination.

Backoffice
Management API

Go to In-person payments, this will default to the Stores page, and click the + Add Store button.
Select the Payout destination you onboarded in Step 1, enter the Contact details, and click Save.

Create a store with POST /v1/accounts/{aid}/stores.

POST /v1/accounts/{aid}/stores
Authorization: Bearer <token>
Content-Type: application/json

{
  "store_id": "oslo-center",
  "store_name": "Oslo Center",
  "organization": {
    "organization_number": "923663487"
  },
  "payout_destination": {
    "payout_destination_id": "seller-1"
  }
}

The response returns two identifiers:

store_id - the merchant identifier you sent, used as order.store.id in checkout sessions.
id - a Dintero-generated identifier (for example P11223351-0026). You’ll need this when registering a terminal.

When a store is linked to an active payout destination, address, phone number, and other fields are set automatically from the validated organization data. The store’s organization.organization_number must match the organization on the payout destination.

Step 3: Add a terminal

Each terminal is connected to a single store. Connect the terminal to the internet first: it cannot sync with Dintero until it is online.

3.1 Connect the terminal to Wi-Fi (new terminal)

Turn on the terminal, swipe ↑ Up on the display, and open the Infipay app. The terminal installs the software and restarts.
Tap the ☰ Menu icon in the top-right corner of the screen.
Go to Network Settings > Internet, toggle on Wi-Fi, select your network, and enter the password.

On a terminal that already has been onboarded, the menu icon is hidden and the network settings sit behind the service menu. See Change the Wi-Fi network.

3.2 Then add a terminal with Dintero:

Backoffice
Management API

In Backoffice, go to In-person payments, then Terminals, and click the + Add Terminal button.
Select the Store, enter the terminal’s Serial number, and click Save.
The Terminals page shows the terminal with the status Syncing. Once synced, the status is replaced with an Activate terminal button.
Click Activate terminal and follow the on-screen instructions.
When the status of your terminal is Active, your terminal has been succesfully added.

POST /v1/accounts/{aid}/terminals
Authorization: Bearer <token>
Content-Type: application/json

{
  "device_serial_number": "158222607285",
  "store_id": "P11223351-0026"
}

The store_id field on this endpoint expects the store’s id from the create-store response (for example P11223351-0026), not the merchant store_id. Subsequent reads of the terminal will return the merchant store_id (the backend translates it).

The response includes the terminal_id Dintero assigned (for example P11223351-T0013). Use that value as order.store.terminal_id when creating a session.Use GET /v1/accounts/{aid}/terminals/{terminal_id} to inspect a terminal, or GET /v1/accounts/{aid}/terminals to list all terminals.

The API only registers the terminal. Someone on site still has to unbox it and connect it to Wi-Fi as described above.

Next steps

With the payout destination, store, and terminal in place, you can now Create a terminal session.

Checkout Integration

Express Checkout

Payment Methods

Tokenization

Split Payout

In-Person Payments

Step 1: Onboard a payout destination

Step 2: Create a store

Step 3: Add a terminal

3.1 Connect the terminal to Wi-Fi (new terminal)

3.2 Then add a terminal with Dintero:

Next steps

​Step 1: Onboard a payout destination

​Step 2: Create a store

​Step 3: Add a terminal

​3.1 Connect the terminal to Wi-Fi (new terminal)

​3.2 Then add a terminal with Dintero:

​Next steps

Step 1: Onboard a payout destination

Step 2: Create a store

Step 3: Add a terminal

3.1 Connect the terminal to Wi-Fi (new terminal)

3.2 Then add a terminal with Dintero:

Next steps