Skip to main content
A payment profile is a named payment configuration stored on your Dintero account. Instead of listing every payment method in each session request, you reference the profile by its profile_id, and the checkout uses the payment methods configured on the profile. The main benefit is that the payment configuration lives in Dintero Backoffice, not in your code. You can enable a new payment method, change the order methods are displayed in, or adjust the checkout theme without changing or redeploying your integration.

​
Creating a payment profile

Every new account has a default payment profile. To create additional profiles, go to Dintero Backoffice → Settings → Payment profiles. Multiple profiles are useful when different parts of your business need different payment setups, for example one profile for your web shop and another for in-store payments, or separate profiles for different markets.

​
Creating a session with a payment profile

Create the session with a POST request to https://checkout.dintero.com/v1/sessions-profile, referencing the profile in profile_id. See the create session from profile endpoint for all available fields. 
{
  "url": {
    "return_url": "https://example.com/return",
    "callback_url": "https://example.com/callback"
  },
  "order": {
    "amount": 29990,
    "currency": "NOK",
    "merchant_reference": "merchants_order_number",
    "items": [
      {
        "id": "chair-1",
        "line_id": "1",
        "description": "Stablestol",
        "quantity": 1,
        "amount": 29990,
        "vat_amount": 6000,
        "vat": 25
      }
    ]
  },
  "profile_id": "default"
}
The response contains the session ID and the URL where the customer completes the payment: 
{
  "id": "{session_id}",
  "url": "https://checkout.api.dintero.com/v1/view/{session_id}/"
}

​
Sessions without a payment profile

It is also possible to create sessions where the full payment configuration is included in the request, using the create session endpoint. We recommend using payment profiles instead, since they let you add new payment methods without changing any code.
Last modified on June 11, 2026