POST /v1/payments

Create a paymentId containing order information, which is needed to initialize the checkout.

Response Class (Status 201)

{
  "paymentId": "string"
}

Parameters

Parameter Value Description Parameter Type Data Type
paymentRequest
{
    "order": {
        "items": [{
                "reference": "string",
                "name": "string",
                "quantity": 0,
                "unit": "string",
                "unitPrice": 0,
                "taxRate": 0,
                "taxAmount": 0,
                "grossTotalAmount": 0,
                "netTotalAmount": 0
            }
        ],
        "amount": 0,
        "currency": "string",
        "reference": "string"
    },
    "checkout": {
        "url": "string",
        "termsUrl": "string",
        "shippingCountries":
        [
            {"countryCode": "XXX"},
            {"countryCode": "YYY"}
        ],
        "consumerType": {
            "supportedTypes": [ "B2C", "B2B" ],  
            "default": "B2C"
        }       
    },
    "notifications": {
        "webhooks": [{
                "eventName": "string",
                "url": "string",
                "authorization": "string"
            }
        ]
    }
}
	
  body  
Authorization (required) Private api key header string

 

Response

HTTP Status Code Reason Response model
400 Bad request
{
  "errors": {}
}
401 Unauthorized  
500 Unexpected error
{
  "message": "string",
  "code": "string",
  "source": "string"
}

 

Do you have a question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00
Close menu