Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dintero.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through the complete flow: create credentials, authenticate, create a checkout session, and handle the payment result.

​
Prerequisites

​
Test vs production

Every Dintero account has two environments, identified by the account ID prefix:
PrefixEnvironmentExamplePurpose
TTestT12345678Sandbox — no real money, use test cards
PProductionP12345678Live — real payments
Start with your test account (T prefix). Switch to production by creating new API credentials on your P account when you’re ready to go live.

​
Step 1: Create API credentials

1

Open Backoffice

Go to Settings > API clients (under API & Integrations).
2

Create a client

Click Create new API client > Checkout client, enter your website URL, and click Create.
3

Save credentials

Copy the Client ID and Client Secret immediately.
The Client Secret is shown only once. Store it securely — you cannot retrieve it later.
For a visual walkthrough, see the API Client page.

​
Step 2: Get an access token

Exchange your credentials for a bearer token using the OAuth 2.0 client credentials flow. 
curl -X POST https://api.dintero.com/v1/accounts/T12345678/auth/token \
  -u "CLIENT_ID:CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "audience": "https://api.dintero.com/v1/accounts/T12345678"
  }'
The response includes a token valid for 4 hours: 
{
  "access_token": "eyJhbGci...t7P4",
  "token_type": "Bearer",
  "expires_in": 14400
}
Use this token in the Authorization: Bearer {access_token} header for all API calls.

​
Step 3: Create a checkout session

A session represents a customer’s order. Send the order details and get back a checkout URL. 
curl -X POST https://checkout.dintero.com/v1/sessions-profile \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": {
      "return_url": "https://example.com/thankyou",
      "callback_url": "https://example.com/callback"
    },
    "order": {
      "amount": 29990,
      "currency": "NOK",
      "merchant_reference": "order-001",
      "items": [
        {
          "id": "item-1",
          "line_id": "1",
          "description": "Blue T-Shirt",
          "quantity": 1,
          "amount": 29990,
          "vat_amount": 5998,
          "vat": 25
        }
      ]
    },
    "profile_id": "default"
  }'
Amounts are in the smallest currency unit. 299.90 NOK = 29990.
The response returns a session ID and checkout URL: 
{
  "id": "T12345678.xxxxxxxxxxxxxxxxxxxx",
  "url": "https://checkout.dintero.com/v1/view/T12345678.xxxxxxxxxxxxxxxxxxxx"
}

​
Step 4: Display the checkout

Show the checkout to your customer using the Web SDK. Install it with npm: 
npm install @dintero/checkout-web-sdk
Not sure which approach to use?Redirect sends the customer to a Dintero-hosted page — minimal setup, no iframe. Embed renders the checkout inside your page — more control over the experience.See the SDK documentation for a full comparison.
Send the customer to the Dintero-hosted payment page:
import { redirect } from "@dintero/checkout-web-sdk";

redirect({
  sid: "T12345678.xxxxxxxxxxxxxxxxxxxx",
});
Or redirect directly to the session url from step 3.
Use test data to complete a test payment.

​
Step 5: Handle the result

After payment, Dintero notifies you through two channels:
ChannelHowReliable?Use for
callback_urlGET to your serverYes (retried up to 20 times)Verify payment, fulfill order
return_urlCustomer redirectNo (browser may close)Show confirmation page
Always verify the transaction via the callback. The redirect is not guaranteed.
See After payment for transaction statuses and handling.

​
What’s next

Online store guide

Full end-to-end integration including capture and refunds.

Embed vs redirect

Compare integration approaches.

Express Checkout

Skip address forms for faster conversions.

Test data

Test cards and sandbox scenarios.