Skip to main content
POST
checkout_session_profile_post

Authorizations

Authorization
string
header
required

Bearer authentication (token authentication) should be used for accessing the API.

Use Get Token to get an access token for client credentials. Pass the token in the request header:

where the access_token is JSON Web Tokens (JWT).

Headers

Dintero-Feature-Toggles
enum<string>[]

Feature toggles that will change how the API works.

These feature toggles are usually the preferred way to use the API, but they break the current API.

  • strict-session-amounts: order.amount must equal the sum of amounts in order.items + order.shipping_option.amount when creating sessions
Available options:
strict-session-amounts
Dintero-System-Name
string

The name of the ecommerce solution

Example: woocommerce

Maximum string length: 120
Dintero-System-Version
string

The version number of the ecommerce solution

Example: 5.4

Maximum string length: 120
Dintero-System-Plugin-Name
string

The name of the ecommerce plugin

Example: Dintero.Checkout.WooCommerce

Maximum string length: 120
Dintero-System-Plugin-Version
string

The version number of the ecommerce plugin

Example: 2.3.4

Maximum string length: 120

Query Parameters

include_session
boolean

Include all details about the session created

Body

application/json

Enable customer gift cards in session

url
object
required
order
object
required
profile_id
string
required

configuration profile

customer
object
expires_at
string<date-time>
checkboxes
object[]

Configuration for checkboxes that should be part of the checkout

Maximum array length: 2
configuration
object

Override configuration for the profile.

merchant
object

Configure merchant information used in the checkout.

express
object

Present only for Express Checkout sessions.

An Express Checkout session is a session where the end user will submit a shipping address and then select a shipping option before the before a payment method is selected and the payment is initiated.

Endpoints used in the Express Checkout flow.

  1. Set shipping address
  2. Set shipping option
metadata
object

Additional metadata about the resource

We recommend that keys used are prefixed with ext to avoid collision with reserved keys

  • dintero
  • merchant
  • session
  • event
  • payout
  • gateway
  • bambora
  • collector
  • instabank
  • klarna
  • kravia
  • netaxept
  • payex
  • santander
  • swish
  • vipps
Example:

Response

checkout session created

id
string

The id of the checkout session

url
string<uri>

URL for the Checkout session

Example:

"https://checkout.api.dintero.com/v1/view/9ea1610a357dc8189081c4cb955f26f612d91367"

publish
object[]

Publish checkout message to the customer.

session
object
Last modified on July 14, 2026