Carbon Drop 2: Customers

How it works

Every order now creates or updates a customerId. That ID ties together payment methods, returns in every response, and can be used to build customer profiles, trigger promotions, and generate real sales insights.

A new customer object can now be passed in with createOrder. If the customer exists, Carbon returns the existing profile. If not, a new record is created automatically.

{
  "customer": {
    "customerId": "CUST-001",
    "person": {
      "email": "anna@svensson.se",
      "name": {
        "firstName": "Anna",
        "lastName": "Svensson"
      },
      "phoneNumber": {
        "code": 46,
        "number": "701234567"
      },
      "birthDate": "1998-07-12",
      "personalNumber": "980712-0300",
      "coordinationNumber": "19fra98bra",
    }
  } 
}

{
  "customer": {
    "phoneNumber": {
        "code": 46,
        "number": "701234567"
    },
  }
}

Create and Fetch Customers Directly

In addition to the order flow, Carbon now provides dedicated customers APIs.

Example: Create a customer

{
    "firstName": "Sanna",
    "lastName": "Vensson",
    "birthDate": "1940/03/04",
    "countryCode": "SE",
    "address": {
      ...
      "role": "shipping"
    },
    "phoneNumbers": [{
      ...
      "role": "own"
    }],
    "cardIds": [
      "824c514bfe001805f0",
      "827a63468b993801f0",
      "827a63460b99380df0"
    ]
}

Fetch Customer Details by ID

GET /customers/:customerId

"customer": { "cardIds": ["824c514bfe001805f0", "827a63468b993801f0", "827a63460b99380df0"] }

What this enables

1. Complete customer profiles from payments

Every transaction in Carbon automatically creates or returns a customerId. Whether it’s card, alternative payment methods such as Swish, or invoice, the data rolls up into a single customer record. Partners can finally stitch together online and in-store activity into one profile.

2. Smarter targeting and promotions

With unified purchase patterns, partners can trigger promotions that feel native.

3. Better sales insights

Partners get visibility across channels. They can see:

🔂 Which products drive repeat purchases

↔ How customer journeys move from online to in-store or even cross-stores.

📈 Lifetime value of specific customers or segments

This allows merchants to double down on high-value cohorts instead of wasting spend on anonymous campaigns.

4. Personalized engagement, built in

Because Carbon ties payments to customers, merchants don’t need separate loyalty programs or apps to know who their customers are. Engagement becomes automatic: a payment identifies the customer.

5. Cross-channel growth

By linking IDs across payment methods, partners can give merchants a single view of their customers and use that to make ad spend up to 22x more effective.