Create using API

We strongly recommend creating customers by integrating Customer Registration. However creating a customer can also be done via a call to the customer creation endpoint. When integrating through the endpoint a customer can be initialized with Contact information and a payment method with a tokenized card. Card Input can be used to generate a card token.

Request

POST /v1/customer

Host: merchant.intergiro.com
Content-Type: application/json
Authentication: Bearer <public.api.key | private.api.key>

{
  "number": "customer-number-001",
  "method": [
    {
      "card": "<single-use.card.token>",
      "type": "token",
      "client": {
        "browser": {
          "color_depth": 24,
          "resolution": [
            2560,
            1440
          ],
          "java": false,
          "javascript": true,
          "locale": "en-GB",
          "timezone": -120,
          "parent": "<origin of current page url>"
        }
      }
    }
  ],
  "contact": {
    "name": "Joe Smith",
    "email": "joe.smith@example.com"
  }
}

Response

{
  "id": "<Intergiro customer identifier>",
  "number": "<your customer number>",
  "contact": <contact information>,
  "method": [<payment method>],
  "status": "<Customer Status>",
  "total": <Customer Balance>,
  "schedule": "<customer payment schedule>",
  "currency": "<customer currency>"
}

{
  "id": "SMmmIYXgLFTgE8qW",
  "number": "customer-number-001",
  "contact": {
    "name": "Joe Smith",
    "email": "joe.smith@example.com"
  },
  "method": [
    {
      "type": "card",
      "scheme": "<scheme>",
      "iin": "123456",
      "last4": "1234",
      "expires": [
        2,
        22
      ],
      "acquirer": "intergiro",
      "created": "1970-01-01T00:00:00.000Z",
      "token": "<card.token>"
    }
  ],
  "status": "active",
  "total": 0,
  "balance": [],
  "schedule": "monthly",
  "currency": "SEK"
}

If a verification required error is returned, verification needs to be performed.

With initial Orders and Subscriptions

Making a payment while creating a new customer can be done by adding an order field in the request. Populate the order field with a list or a single Order.Creatable without the fields "payment" and "customer". The items value of the order, or the first order in the list, is used to authorize the Customer Method.

Subscriptions can be added in a similar way, by populating the Customer Creatable with Subscription Creatable or Subscription Creatable[].

The response will be a Customer & { order: tokenized.order | tokenized.order[] } or an Error. If you receive a verification required error, 3D secure needs to be performed.

Request

POST /v1/customer

Host: merchant.intergiro.com
Content-Type: application/json
Authentication: Bearer <public.api.key | private.api.key>

{
  "number": "customer-number-001",
  "method": [
    {
      "card": "<single-use.card.token>",
      "type": "token",
      "client": {
        "browser": {
          "color_depth": 24,
          "resolution": [
            2560,
            1440
          ],
          "java": false,
          "javascript": true,
          "locale": "en-GB",
          "timezone": -120,
          "parent": "<origin of current page url>"
        }
      }
    }
  ],
  "contact": {
    "name": "Joe Smith",
    "email": "joe.smith@example.com"
  },
  "order": {
	  "items": 42,
	  "currency": "EUR",
  }
}

Response

{
  "id": "SMmmIYXgLFTgE8qW",
  "number": "customer-number-001",
  "contact": {
    "name": "Joe Smith",
    "email": "joe.smith@example.com"
  },
  "method": [
    {
      "type": "card",
      "scheme": "<scheme>",
      "iin": "123456",
      "last4": "1234",
      "expires": [
        2,
        22
      ],
      "acquirer": "intergiro",
      "created": "1970-01-01T00:00:00.000Z",
      "token": "<card.token>"
    }
  ],
  "status": "active",
  "total": 0,
  "balance": [],
  "schedule": "monthly",
  "currency": "SEK",
  "order": "ZXlKaGJHY2lPaUpTVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SnBjM01pT2lKd1lYbG1kVzVqSWl3aWFXRjBJam94TmpNMk5EWTBOREExTENKaGRXUWlPaUp3Y205a2RXTjBhVzl1SWl3aVkzSmxZWFJsWkNJNklqSXdNakV0TVRFdE1EbFVNVE02TWpZNk5EVXVNekE1V2lJc0ltbDBaVzF6SWpwYmV5SnVkVzFpWlhJaU9pSjBjekF3TVMxaUlpd2libUZ0WlNJNklrSmhjMmxqSUZRdGMyaHBjblFzSUdKc1lXTnJJaXdpY0hKcFkyVWlPakl3TUN3aWRtRjBJam8xTUN3aWNYVmhiblJwZEhraU9qVXNJbk4wWVhSMWN5STZXeUp2Y21SbGNtVmtJaXdpYjNKa1pYSmxaQ0lzSW05eVpHVnlaV1FpTENKdmNtUmxjbVZrSWl3aWIzSmtaWEpsWkNKZGZTeDdJbTUxYldKbGNpSTZJblJ6TURBeExYY2lMQ0p1WVcxbElqb2lRbUZ6YVdNZ1ZDMXphR2x5ZEN3Z2QyaHBkR1VpTENKd2NtbGpaU0k2TWpBd0xDSjJZWFFpT2pVd0xDSnhkV0Z1ZEdsMGVTSTZNVEFzSW5OMFlYUjFjeUk2V3lKdmNtUmxjbVZrSWl3aWIzSmtaWEpsWkNJc0ltOXlaR1Z5WldRaUxDSnZjbVJsY21Wa0lpd2liM0prWlhKbFpDSXNJbTl5WkdWeVpXUWlMQ0p2Y21SbGNtVmtJaXdpYjNKa1pYSmxaQ0lzSW05eVpHVnlaV1FpTENKdmNtUmxjbVZrSWwxOVhTd2lZM1Z5Y21WdVkza2lPaUpGVlZJaUxDSmpZWFJsWjI5eWVTSTZJbkIxY21Ob1lYTmxJaXdpYm5WdFltVnlJam9pWjJSU0xVdHdObTVrTXpVM0lpd2ljR0Y1YldWdWRDSTZleUowZVhCbElqb2lZMkZ5WkNJc0ltUmxjMk55YVhCMGIzSWlPaUlpTENKaGJXOTFiblFpT2pNM05UQXNJbU55WldGMFpXUWlPaUl5TURJeExURXhMVEE1VkRFek9qSTJPalEwTGpnME5Wb2lMQ0pqZFhKeVpXNWplU0k2SWtWVlVpSXNJbVY0Y0dseVpYTWlPbHN5TERJeVhTd2lhV2x1SWpvaU5ERXhNVEV4SWl3aWJHRnpkRFFpT2lJeE1URXhJaXdpYzJOb1pXMWxJam9pZG1sellTSXNJbk4wWVhSMWN5STZJbU55WldGMFpXUWlMQ0pqWVhKa0lqb2laWGxLYUdKSFkybFBhVXBUVlhwSk1VNXBTWE5KYmxJMVkwTkpOa2xyY0ZoV1EwbzVMbVY1U25Cak0wMXBUMmxLYWxsWVNtdEphWGRwWVZkR01FbHFiM2hPYWsweVRrUlpNRTVFUVhsTVEwcG9aRmRSYVU5cFNuZGpiVGxyWkZkT01HRlhPWFZKYVhkcFdsYzFha2xxYjJsTmFsbDFUVVp3ZVdGR1JtWlRla3BaVlRCT2IxUlhlRVJpYld0NFltcEtjMXA1TkRWYU1scFVUMGR3U0ZOVVkzUk1WV2MwV20wMWJrOVViSEphZWtaSFRYcFJNMDlHVG5aT2JrSlVXbXhXWVU1dVJuZGlXR2haVDFWYWJGa3lUakpaYkdkcFRFTktOR05JU1dsUGJITjVURVJKZVZoVGQybGtiVlo1U1dwd04wbHVValZqUjFWcFQybEthbUZIUm5OaVIxWjFXakpWYVV4RFNtdFpXRkpvU1dwd04wbHRSakZrUjJoc1ltNVNjRmt5UmpCaFZ6bDFTV3B2YVZsNlVrcE5TRnBvV1Zod1JWb3dNRFZhYlRrMFZWaGtOVlJFVlRWYVIwVnlZMFJDVWxCVFNYTkpiazR3V1ZoU01XTjVTVFpKYkd0cFRFTktlVnBYV214amJWWjFXVEpWYVU5dWMybGFSMng1V2xkT01HSXpTalZKYW05cFRWUkJkMWw2Ykd4UFZHdDBUbGRSTUUxcE1EQlBSR3hvVEZSbk5GbHFRWFJOZWxVelRucFJkMDVYV1RSTlZHdDRTV2wzYVdNeVZubGtiVlo1U1dwdmFWbDZZelZaVkVVMVRsZFpkRTFxWnpKWlV6QXdUMFJqTUV4VVp6TlpiVlYwVFcxT2FscFVhR3RaYlZKdFdXcFplVWx1TVRsbVdEQXVSVXRHZGpCcFdUWkdVWE52ZWsweldrdHZPWE5QYUhWYVRuVkZlVUoyZFRWSlQza3dMWFJ2UTBvMlUycGZTR3hSUzJvMUxYTmZjWEpNZDI5RFpqazRZMWhxUzI1NVJIVXhlbXRyT0dwSmRqVk5jMlJtVG01aWVqSXphV0o2VkRoaWNGUlRjSGMwY0hscFNVVXpaMWRxY1ZKb2NuUmZhbXh2ZGtjM2NYQkxSV2hYYjBwclRGOWhOMGgzT0dGeVZFUkpNMnhaVkRkRmEyWmlhWFZ1YkZKaU9GUnpVRXBUVURGU2J6RldUMjlCWDBGZk4xbGtWME5OYlc5c1ZIbFBUR0Y1TUZVdFNGZFdhbXc0V0dKS1gycHFNRkl0Y1hwTU5GTjRlRVJPVFcxMmJEWm5aakpmWmxkU2NrSnhhRkJ2VFZCTmRXVldiblpyV2taUGIzZEZWSGhRYWxWSVpEWlhhMU5vVkhWaFUxUXdZbUYxYVVGWlQzQnVkekl0ZEZFeE5tY3daVmcyUzFkME5HRkRjalJMYVVWRGJqWTNiRkphYWxsSlpqSTNWWHBMVEhSaE9HdE5OVXg1ZFdWTlpIcHBWVXRqTFV3MlltbEJJaXdpY21WbVpYSmxibU5sSWpvaVJUbHBkekpPUWxGVGVFdHJUbkJLY0NJc0luTmxjblpwWTJVaU9pSnBiblJsY21kcGNtOGlMQ0p6WTJobGJXVlNaV1psY21WdVkyVWlPaUpOUTBFeE5ESTJORFF4TVRBNUluMHNJbVYyWlc1MElqcGJleUowZVhCbElqb2liM0prWlhJaUxDSmtZWFJsSWpvaU1qQXlNUzB4TVMwd09WUXhNem95TmpvME5TNHpNRGxhSW4xZExDSnBaQ0k2SWxNNVpIVkpYMlY2Tm5ZM2J6UXhSM2NpTENKemRHRjBkWE1pT25zaWIzSmtaWEpsWkNJNk16YzFNSDE5LkZRaWM2c2hIcEsyYmVaLXNxek9SQ01XSjF5RmZNd3JUTjdSemNwaFgxSlMyU01mSFIteE5DSmF4MEtQb19MWG1WdnRHc3ZpSFIweS1hSnFxT2xTYmVtUWFGd0E4dkNMaFhoTUpVWUFpQlA1LUxWQ2h1UkNEbTlENGF1VkVSRUpnbFEtVldPb3VHaFpLT1dZWHhETWluRG5ZQm85NWs4Y0c0Z3NjSDdTaVp5QnYtS0czdGJJbmVGQlg0YWlUYXlNQXdRa2V3WE9HVjdIQ0xEa1EwMWpvZE9WdzJKOXBSbGxnNWlHNHptV1VIb3IzUzVpY193RnJRaWhMazRWREEzeTRJX2ZhaElRUjc4d2FaWE5MSW5UOGRVWTN5NkV3TGJRQzY5amt5bERWM1dGaEl1Qk5uSXIwTGhYMGlkd2RfRzBieXNpVUtzQ3AxOXVLQllxVmowUnBpQQ=="
}