---
title: "Create or Show MerchantCustomer"
method: POST
path: "/merchant_customers"
tags: ["Merchant Customers"]
---

# Create or Show MerchantCustomer

`POST /merchant_customers`

## Request

- Base URL: `https://api.liftforward.com`
- URL: `https://api.liftforward.com/merchant_customers`
- Auth: API key in header `Api-Key`

Creates a new MerchantCustomer for the provided `merchant_customer_id`. If a MerchantCustomer already exists for the provided `merchant_customer_id` the existing MerchantCustomer is returned.

## Request body

- PostMerchantCustomers: Create or Show MerchantCustomer
  - `merchant_customer` MerchantApiEntitiesMerchantCustomerCreate, required
    - `merchant_customer_id` string, required: Unique identifier for customer. Provided by the Merchant on create.

## Response `200`

Already exists

- MerchantApiEntitiesMerchantCustomerResponse: MerchantApi_Entities_MerchantCustomerResponse model
  - `merchant_customer` MerchantApiEntitiesMerchantCustomerEntity
    - `merchant_customer_id` string, required: Unique identifier for customer. Provided by the Merchant on create.
    - `program_enrollments` MerchantApiEntitiesProgramEnrollmentEntity[]
      - `program_code` string, required: String provided by LiftForward to identify the Device as a Service Program.
      - `approval` MerchantApiEntitiesApprovalEntity
        - `approval_token` string, required: Token which is used to create Orders and PaymentMethods.
        - `expires_at` string, required: When this approval will expire, in iso8601 format.
        - `status` string: The status of the approval. Possible values: [active, used, canceled, expired].
        - `credit_amount` number, float: The amount of credit that has been approved.
        - `currency` string: The currency for credit_amount.
        - `order_id` string: Associated order id.
        - `payment_method_id` string: Associated payment method id.
        - `session_id` string: Associated Session id
        - `cart_id` string: Associated cart id
        - `offers` MerchantApiEntitiesOfferEntity[]: Array of Offers.
          - `offer_id` string: Unique id for offer.
          - `credit_amount` number, float: The credit limit for this offer.
          - `currency` string: ISO 4217 3 character currency code.
          - `apr` number, float: Annual Percentage Rate, expressed as a decimal, for this offer.
          - `installment_count` integer: Count of installments (aka payments) for this offer.
    - `assets` MerchantApiEntitiesAssetIdEntity[]
      - `asset_id` string: Unique identifier for this asset.

## Other responses

- `201`: Created successfully
- `400`: Invalid parameters
- `401`: Unauthorized
- `405`: Not Allowed
- `408`: Request Time Out
- `500`: Internal Service Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti.md) - [All operations](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti/llms.txt) - [OpenAPI document](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti/revisions/5a1383ffd271?raw)