Skip to main content
POST
https://checkout.dintero.com/v1
/
sessions
/
{session_id}
/
pay
checkout_sid_pay_post
curl --request POST \
  --url https://checkout.dintero.com/v1/sessions/{session_id}/pay \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "<string>"
}
'
{
  "success": true,
  "actions": [
    {
      "source": "DINTERO",
      "code": "200",
      "type": "success"
    }
  ],
  "redirect_url": "<string>",
  "poll_url": "<string>",
  "approval_url": "<string>",
  "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABzklEQVR42mNkAAYy...",
  "error": "Rejected",
  "error_details": [
    {
      "code": "wrong_ssn",
      "category": "permanent",
      "field": "<string>",
      "authentication_operations": [
        {
          "href": "<string>",
          "method": "POST",
          "content_type": "application/json",
          "rel": "3d-secure-init-hosted"
        }
      ]
    }
  ]
}

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.

Headers

If-Unmodified-Since
string

Optional header. The put request is discarded and a 412 is returned if the header does not match the updated_at property or the version of the session.

Path Parameters

session_id
string<checkout-id>
required

The session ID

Body

application/json
phone_number
string

mobile number of a person / company, ITU/E.123 format with international prefix (+PPNNNNNNNNN...)

Pattern: ^\+?\d{5,15}$
remember_me
boolean

If true will either make the backend add or update a signed cookie with customer data. If false the cookie will be removed. If not set, any existing cookie will remain unchanged

Response

response from payment

success
boolean
required

the payment was accepted

actions
object[]
required
redirect_url
string

redirect url to complete payment, will not be included if the payment failed with Rejected error as payment can be completed by choosing alternative payment option.

poll_url
string

poll_url to check the status of the payment. Will be included if the payment is dependent on 3rd party apps, such as Swish.

approval_url
string

approval_url to complete the payment in a different app from the one showing the checkout, eg. an app link for the Swish M-Commerce flow. Should be used in conjunction with the poll_url to check the status of the payment.

qr_code
string

A base 64 encoded image of the QR code can be displayed while the checkout frontend is polling for the payment status. Eg. used as a fallback for the Swish M-Commerce flow if we are unable to open the approval_url on the end users device we can display the QR code and the user can scan it using a different device that has the app used for payment installed.

By default the image has a size of 600 x 600 pixels.

Example:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABzklEQVR42mNkAAYy..."

error
string
Example:

"Rejected"

error_details
object[]
Last modified on May 12, 2026