Intergiro developer portal

# Create

To create an order, post an Order Creatable to the order endpoint. The payment field must be a Card Payment Creatable.

# Request

 



























POST /v1/order

Host: merchant.intergiro.com
Content-Type: application/json
Accept: application/json
Authentication: Bearer <customer.api.key> | Bearer <private.api.key>
{
  "items": <number or item information or array of items objects>,
  "currency": "<currency of the transaction>",
  "payment": {
    "type": "card"
    "card": "<card JWT>"
    "client": {
      "browser":
        {
          "color_depth": 24,
          "resolution": [2560,1440],
          "java": false,
          "javascript": true,
          "locale": "sv-SE",
          "timezone": -60,
          "parent": "https://your.webshop.com"
        }
      }
    }
  }
}

See browser section for information on how to get the browser information above.

Note: Including application/json in the Accept header will return the Order as a JSON, otherwise the Order will be in a signed JWT.

# Response

On success, the response will be an Order.

{
    "id": "<Identifier of order in Intergiro's system>",
    "created": "<datetime of order>",
    "items": "<numer or item information or array of items objects>",
    "currency": "<Currency of order>",
    "payment": "<Card payment>",
}

On failure, an Error will be returned together with the id of the order. If a verification required error is returned, verification needs to be performed.

Note: Include the id from the error response in the request body for all following calls to the order-create endpoint, concerning the same order. This is important to keep a correct History of the authorization creation, and to make sure 3DS is done correctly. The id field in an Order Creatable should never be populated with any id other than the id received from the order endpoint.

← Change →