Merchant Customers

Create or Show MerchantCustomer

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.

post/merchant_customers

Request

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

Request body

Example request

{
  "merchant_customer": {
    "merchant_customer_id": "hph9s2j7rv9spaybgqj844mrhg8"
  }
}

Response

Already exists

Example response

{
  "merchant_customer": {
    "merchant_customer_id": "hph9s2j7rv9spaybgqj844mrhg8",
    "program_enrollments": [
      {
        "program_code": "program-abc",
        "approval": {
          "approval_token": "bd630ded-b714-4ba2-9759-424c3a643814",
          "expires_at": "2026-11-03T22:19:28Z",
          "status": "active",
          "credit_amount": 299.99,
          "currency": "USD",
          "order_id": "ctyqbrmryskz7gqfks4rqrr8hvr",
          "payment_method_id": "kcxwtawv9keka9sxrqmy7t4ta4j",
          "session_id": "0ff2b948-41d4-4c4d-9c88-980f5ae81c34",
          "cart_id": "2qfg2jtag54xmybtp3jqg2h595n",
          "offers": [
            {
              "offer_id": "trfhbdh7eza2687pbm6556ncd73",
              "credit_amount": 2500,
              "currency": "USD",
              "apr": 0.0999,
              "installment_count": 36
            }
          ]
        }
      }
    ],
    "assets": [
      {
        "asset_id": "k6epk9qyqx8qep8m447pxxcs4zg"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 8 revisions of this API.