Migrate off Magento to a commerce API you never patch.

1. 01

   Import the catalog by SKU

   POST /v1/products

   A configurable product becomes a product with options, and each simple child becomes a variant that keeps its SKU. The Magento entity ids ride along in metadata, so anything that references a product by id keeps resolving.

   In MagentoCopy

   GET /rest/V1/products/BRK
   
   {
     "id": 2040,
     "sku": "BRK",
     "name": "Shelf bracket",
     "type_id": "configurable",
     "extension_attributes": {
       "configurable_product_options": [
         { "attribute_id": "187", "label": "Finish" }
       ],
       "configurable_product_links": [2041, 2042]
     }
   }
   
   GET /rest/V1/configurable-products/BRK/children
   
   [
     { "id": 2041, "sku": "BRK-OAK-1", "price": 89 },
     { "id": 2042, "sku": "BRK-WAL-1", "price": 94 }
   ]

   On FlintCopy

   curl -X POST https://api.withflintpay.com/v1/products \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Idempotency-Key: import-magento-2040" \
     -d '{
       "name": "Shelf bracket",
       "product_type": "physical",
       "external_reference_id": "BRK",
       "metadata": { "magento_entity_id": "2040" },
       "options": [
         {
           "client_option_key": "finish",
           "name": "Finish",
           "values": [
             { "client_value_key": "oak", "value": "Oak" },
             { "client_value_key": "walnut", "value": "Walnut" }
           ]
         }
       ],
       "variants": [
         {
           "sku": "BRK-OAK-1",
           "unit_price_money": { "amount": 8900, "currency": "USD" },
           "inventory_item": {
             "name": "Shelf bracket, oak",
             "sku": "BRK-OAK-1"
           },
           "selected_option_values": [
             { "client_option_key": "finish", "client_value_key": "oak" }
           ],
           "metadata": { "magento_entity_id": "2041" }
         }
       ]
     }'

   Find it again by the SKU you already haveCopy

   curl 'https://api.withflintpay.com/v1/products?sku=BRK-OAK-1' \
     -H "Authorization: Bearer YOUR_API_KEY"

   An incremental import finds the product to update without a mapping table.

2. 02

   Put your stock on the shelf

   POST /v1/inventory-adjustments

   Each MSI source becomes a location, and each source item quantity arrives as one adjustment. From then on Flint holds units when a buyer pays and releases them when a payment fails, and a payment for stock that is gone fails before any money moves.

   In MagentoCopy

   GET /rest/V1/inventory/source-items
       ?searchCriteria[filter_groups][0][filters][0][field]=sku
       &searchCriteria[filter_groups][0][filters][0][value]=BRK-OAK-1
   
   {
     "items": [
       {
         "sku": "BRK-OAK-1",
         "source_code": "augusta",
         "quantity": 24,
         "status": 1
       }
     ]
   }

   On FlintCopy

   curl -X POST https://api.withflintpay.com/v1/inventory-adjustments \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Idempotency-Key: opening-stock-BRK-OAK-1" \
     -d '{
       "reason": "received_stock",
       "occurred_at": "2026-09-20T14:00:00Z",
       "source_system": {
         "type": "other",
         "external_source_id": "magento-msi-augusta"
       },
       "lines": [
         {
           "inventory_item_id": "invi_1kmn0aExample",
           "location_id": "loc_1kmn0aExample",
           "on_hand_quantity_delta": 24
         }
       ]
     }'

   The response carries the resulting level for every line, so the import needs no follow-up read.

3. 03

   Bring customers with their ids and terms

   POST /v1/customers

   The Magento customer id becomes the customer's reference. Wholesale accounts carry their tax exemption and default payment terms. A buyer saves a card once, on your page or in their Flint customer account, and it is there for one-click checkout, subscriptions, and invoice autopay.

   curlCopy

   curl -X POST https://api.withflintpay.com/v1/customers \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Idempotency-Key: import-customer-318" \
     -d '{
       "external_reference_id": "318",
       "name": "Harbor Supply Co.",
       "email": "ap@harborsupply.example",
       "tax_exempt": true,
       "default_invoice_payment_term_id": "ipt_1kmn0aExample",
       "metadata": { "magento_website_id": "1" }
     }'

4. 04

   Take the next order on Flint

   POST /v1/orders

   Keep your increment id sequence going and send the next number as the order's reference. You send names, quantities, prices, and the shipping address. Flint computes the tax for that address and the total, and holds the balance that every payment and refund settles against.

   curlCopy

   curl -X POST https://api.withflintpay.com/v1/orders \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Idempotency-Key: order-100000042" \
     -d '{
       "external_reference_id": "100000042",
       "metadata": {
         "magento_entity_id": "8891",
         "magento_store_id": "1"
       },
       "line_items": [
         {
           "name": "Shelf bracket, oak",
           "sku": "BRK-OAK-1",
           "quantity": 1,
           "unit_price_money": { "amount": 8900, "currency": "USD" },
           "tax": { "taxable": true }
         },
         {
           "name": "Wall anchor, pack of 4",
           "sku": "ANC-4",
           "quantity": 3,
           "unit_price_money": { "amount": 2400, "currency": "USD" },
           "tax": { "taxable": true }
         }
       ],
       "delivery_destination": {
         "address": {
           "line1": "540 Broad Street",
           "city": "Augusta",
           "state": "GA",
           "postal_code": "30901",
           "country": "US"
         }
       },
       "tax": {
         "enabled": true,
         "calculation": { "mode": "automatic", "price_mode": "additive" }
       }
     }'

   what Flint computed
   	Shelf bracket, oak, quantity 1line_items[0]	$89.00
   +	Wall anchor, pack of 4, quantity 3line_items[1]	$72.00
   =	Subtotalpricing_amounts.subtotal_money	$161.00
   +	Tax, Augusta GApricing_amounts.tax_money	$12.88
   =	Totalpricing_amounts.total_money	$173.88

5. 05

   Move subscribers without charging them twice

   POST /v1/subscriptions

   Send the date each subscriber's current period began. Flint charges nothing for that period, works out when it ends from the plan interval, and bills the next renewal on schedule. Retries, dunning emails, pause, and resume are Flint's to run from then on.

   curlCopy

   curl -X POST https://api.withflintpay.com/v1/subscriptions \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Idempotency-Key: import-subscription-7714" \
     -d '{
       "subscription_plan_id": "plan_1kmn0aExample",
       "customer_id": "cus_1kmn0aExample",
       "payment_method_id": "pm_1kmn0aExample",
       "external_reference_id": "7714",
       "billing_start": {
         "type": "imported",
         "period_started_at": "2026-09-01T00:00:00Z"
       }
     }'

Inventory guide →·Subscription billing guide →

curl -X POST https://api.withflintpay.com/v1/invoice-payment-terms \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: terms-net-30" \
  -d '{
    "name": "Net 30",
    "calculation": { "type": "net_days", "days": 30 },
    "late_fee_policy": {
      "type": "percentage",
      "percent": 1.5,
      "grace_period_days": 5
    }
  }'

Invoicing guide →