Orders

Orders are the central commerce resource in Flint. Every sale flows through an order: it holds line items, discounts, charges, tax, a requested tip, and the full pricing and settlement state for the transaction. Other resources attach to orders rather than replacing them: payments, refunds, invoices, checkout sessions, and subscriptions all read from and write back to an order.

Line items come from your catalog (a variant_id or bundle_id, with price and display resolved automatically) or are ad hoc (you provide the name and unit price). An order stays open while you build it, then settles through payment: pay it in full, or close it explicitly when no balance remains. pricing_amounts reflects what the order should collect; settlement_amounts reflects what has actually been paid, refunded, and is still outstanding.

For the model behind this design, see the Orders-first guide. To collect payment against an order, use checkout sessions for hosted payment, invoices for receivables, or payments for direct integration.

Endpoints

GET/v1/orders
POST/v1/orders
GET/v1/orders/{order_id}
PATCH/v1/orders/{order_id}
POST/v1/orders/{order_id}/charges
PATCH/v1/orders/{order_id}/charges/{order_charge_id}
DELETE/v1/orders/{order_id}/charges/{order_charge_id}
POST/v1/orders/{order_id}/charges/remove
POST/v1/orders/{order_id}/close
POST/v1/orders/{order_id}/discounts
DELETE/v1/orders/{order_id}/discounts/{order_discount_id}
POST/v1/orders/{order_id}/discounts/remove
POST/v1/orders/{order_id}/inventory-exception/resolve
POST/v1/orders/{order_id}/line-items
PATCH/v1/orders/{order_id}/line-items/{order_line_item_id}
DELETE/v1/orders/{order_id}/line-items/{order_line_item_id}
PUT/v1/orders/{order_id}/line-items/{order_line_item_id}/modifiers
POST/v1/orders/{order_id}/line-items/remove
POST/v1/orders/{order_id}/pay
POST/v1/orders/{order_id}/payment-intents/{payment_intent_id}/capture
POST/v1/orders/{order_id}/payment-intents/{payment_intent_id}/void
POST/v1/orders/{order_id}/requested-tip
POST/v1/orders/{order_id}/requested-tip/clear
PATCH/v1/orders/{order_id}/tax

List orders #

GET/v1/orders

Returns a paginated list of orders for the authenticated merchant.

Query parameters

page_sizeinteger

Page size, default 20, max 100.

page_tokenstring

Cursor returned by the previous list response.

customer_idstring

Filter by customer ID.

statusenum

Filter by order status.

openclosedpaidpartially_refundedrefunded

fulfillment_statusarray of enum

Filter by aggregate order fulfillment status. Repeat the parameter to OR multiple statuses.

not_fulfilledpartially_fulfilledfulfilledcanceled

order_numberstring

Filter by merchant-visible order number.

external_reference_idstring

Exact-match filter on the caller-owned external reference ID.

sourceenum

Filter by order source.

virtual_terminalpayment_linkcheckoutapiin_personsubscription

querystring

Search across order number, external_reference_id, fulfillment external_reference_id, notes, and line item names.

subscription_idstring

Filter by subscription ID.

min_amountinteger

Inclusive lower bound on the order total in minor units. Requires currency.

max_amountinteger

Inclusive upper bound on the order total in minor units. Requires currency.

currencystring

ISO 4217 currency for min_amount and max_amount.

sort_byenum

Sort field.

created_atupdated_atamount_due_moneytotal

sort_directionenum

Sort direction.

ascdesc

created_afterstring

RFC3339 lower bound for created_at.

created_beforestring

RFC3339 upper bound for created_at.

updated_afterstring

RFC3339 lower bound for updated_at.

updated_beforestring

RFC3339 upper bound for updated_at.

Response · 200

dataarray of objectrequired

metaobject

next_page_tokenstring

request_idstring

Bash

curl https://api.withflintpay.com/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY"

JSON

{
  "data": [
    {
      "order_id": "ord_123",
      "line_items": [
        {
          "order_line_item_id": "li_123",
          "name": "General Admission",
          "quantity": 2,
          "unit_price_money": {
            "amount": 2500,
            "currency": "USD"
          },
          "base_subtotal_money": {
            "amount": 5000,
            "currency": "USD"
          },
          "modifier_total_money": {
            "amount": 0,
            "currency": "USD"
          },
          "subtotal_money": {
            "amount": 5000,
            "currency": "USD"
          },
          "discount_money": {
            "amount": 0,
            "currency": "USD"
          },
          "tax_money": {
            "amount": 0,
            "currency": "USD"
          },
          "refunded_money": {
            "amount": 0,
            "currency": "USD"
          },
          "refunded_quantity": 0,
          "total_money": {
            "amount": 5000,
            "currency": "USD"
          },
          "metadata": {
            "ticket_type": "ga"
          }
        }
      ],
      "status": "open",
      "refund_status": "none",
      "metadata": {
        "event_id": "evt_123"
      },
      "merchant_id": "mer_123",
      "customer_id": "cus_123",
      "pricing_amounts": {
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "charge_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "requested_tip_money": {
          "amount": 0,
          "currency": "USD"
        },
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        }
      },
      "tax": {
        "enabled": false,
        "status": ""
      },
      "settlement_amounts": {
        "paid_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "net_collected_money": {
          "amount": 0,
          "currency": "USD"
        },
        "settled_tip_money": {
          "amount": 0,
          "currency": "USD"
        },
        "balance_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "amount_due_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "credit_money": {
          "amount": 0,
          "currency": "USD"
        }
      },
      "order_number": "1001",
      "source": "api",
      "created_at": "2026-03-17T14:30:00Z",
      "updated_at": "2026-03-17T14:30:00Z"
    }
  ],
  "next_page_token": "Zm9yd2FyZC1vbmx5LW9wYXF1ZS1jdXJzb3I",
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Create order #

POST/v1/ordersIdempotent

Creates an order for the authenticated merchant.

Request body

buyer_notestring

customer_idstring

discountsarray of one of

external_reference_idstring

internal_notestring

line_itemsarray of one ofrequired

metadatamap of string

requested_tipone of

taxobject

Response · 201

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "line_items": [
      {
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "discounts": [
      {
        "manual": {
          "name": "Launch credit",
          "amount_money": {
            "amount": 500,
            "currency": "USD"
          }
        }
      }
    ],
    "metadata": {
      "event_id": "evt_123"
    }
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Get order #

GET/v1/orders/{order_id}

Returns a single order by ID.

Path parameters

order_idstringrequired

Flint order ID.

Query parameters

expandarray of enum

Supported expansions: customer, payment_intents, subscription, subscription_plan. Expansion requires the base order read scope plus the read scope for each expanded resource. Limits: at most 10 unique expand paths per request; path depth at most 2. To-many expansions are capped at 20 related objects per path. Send repeated expand parameters as the canonical form, for example expand=customer&expand=payment_intents. Comma-separated values, expand[]=customer, and numeric expand[0]=customer are accepted for common client compatibility.

customerpayment_intentssubscriptionsubscription_plan

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl https://api.withflintpay.com/v1/orders/ord_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Update order #

PATCH/v1/orders/{order_id}Idempotent

Applies a sparse update to mutable order fields such as customer_id, notes, and metadata.

Path parameters

order_idstringrequired

Flint order ID.

Request body

buyer_notestring

customer_idstring

external_reference_idstring

internal_notestring

metadatamap of string

taxobject

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X PATCH https://api.withflintpay.com/v1/orders/ord_123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "metadata": {
      "priority": "vip"
    },
    "buyer_note": "Please include a gift receipt.",
    "internal_note": "VIP hold"
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Add order charge #

POST/v1/orders/{order_id}/chargesIdempotent

Adds a service charge, fee, or surcharge to an order.

Path parameters

order_idstringrequired

Flint order ID.

Request body

chargeone ofrequired

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/charges \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "charge": {
      "name": "Delivery",
      "type": "delivery_fee",
      "amount_money": {
        "amount": 500,
        "currency": "USD"
      },
      "tax": {
        "taxable": true
      },
      "fulfillment_id": "ful_123"
    }
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Update order charge #

PATCH/v1/orders/{order_id}/charges/{order_charge_id}Idempotent

Updates a single service charge, fee, or surcharge on an order.

Path parameters

order_idstringrequired

Flint order ID.

order_charge_idstringrequired

Flint order charge ID.

Request body

amount_moneyobject

Monetary amount represented as integer minor units plus an ISO 4217 currency code.

calculation_basisenum

subtotal_pre_discountsubtotal_post_discount

descriptionstring

fulfillment_idstring

metadatamap of string

namestring

percentnumber

taxobject

typeenum

service_feedelivery_feeshipping_feehandling_feepackaging_feesmall_order_feeservice_area_feesetup_feeinstallation_feecleaning_feebooking_feereservation_feeticket_feefulfillment_feerestocking_feerush_feeother

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X PATCH https://api.withflintpay.com/v1/orders/ord_123/charges/{order_charge_id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "name": "Priority delivery",
    "amount_money": {
      "amount": 700,
      "currency": "USD"
    },
    "fulfillment_id": "ful_123"
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Delete order charge #

DELETE/v1/orders/{order_id}/charges/{order_charge_id}Idempotent

Removes a single service charge, fee, or surcharge from an order.

Path parameters

order_idstringrequired

Flint order ID.

order_charge_idstringrequired

Flint order charge ID.

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X DELETE https://api.withflintpay.com/v1/orders/ord_123/charges/{order_charge_id} \
  -H "Authorization: Bearer YOUR_API_KEY"

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Remove order charges #

POST/v1/orders/{order_id}/charges/removeIdempotent

Removes one or more service charges, fees, or surcharges from an order.

Path parameters

order_idstringrequired

Flint order ID.

Request body

order_charge_idsarray of stringrequired

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/charges/remove \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "order_charge_ids": [
      "och_123"
    ]
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Close order #

POST/v1/orders/{order_id}/closeIdempotent

Closes an eligible open, paid, or partially refunded order. Closing cancels pending discounts, releases pending coupon reservations, and recalculates totals from the current surviving pricing economics; canceled discounts remain visible with status: "canceled" but no longer reduce the total. Closing is blocked while payment collection is in progress.

Path parameters

order_idstringrequired

Flint order ID.

Request body

reasonstring

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/close \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "reason": "Customer canceled before payment."
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Apply discount #

POST/v1/orders/{order_id}/discountsIdempotent

Applies a coupon-backed or manual discount to an order.

Path parameters

order_idstringrequired

Flint order ID.

Request body

couponone of

manualobject

order_line_item_idsarray of string

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/discounts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "coupon": {
      "coupon_code": "SPRING15"
    }
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Delete discount #

DELETE/v1/orders/{order_id}/discounts/{order_discount_id}Idempotent

Removes a single pending applied discount from an order. Redeemed or canceled discounts are settlement history and cannot be removed.

Path parameters

order_idstringrequired

Flint order ID.

order_discount_idstringrequired

Flint order discount ID.

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X DELETE https://api.withflintpay.com/v1/orders/ord_123/discounts/{order_discount_id} \
  -H "Authorization: Bearer YOUR_API_KEY"

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Remove discounts #

POST/v1/orders/{order_id}/discounts/removeIdempotent

Removes one or more pending applied discounts from an order. Redeemed or canceled discounts are settlement history and cannot be removed.

Path parameters

order_idstringrequired

Flint order ID.

Request body

order_discount_idsarray of stringrequired

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/discounts/remove \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "order_discount_ids": [
      "discount_123"
    ]
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Resolve order inventory exception #

POST/v1/orders/{order_id}/inventory-exception/resolveIdempotent

Marks a paid inventory failure as resolved after an operator has completed manual inventory remediation.

Path parameters

order_idstringrequired

Flint order ID.

Request body

reasonstring

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/inventory-exception/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "reason": "Manual inventory sourced and deducted."
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Add line items #

POST/v1/orders/{order_id}/line-itemsIdempotent

Adds one or more line items to an order.

Path parameters

order_idstringrequired

Flint order ID.

Request body

line_itemsarray of one ofrequired

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/line-items \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "line_items": [
      {
        "name": "Backstage Upgrade",
        "quantity": 1,
        "unit_price_money": {
          "amount": 1500,
          "currency": "USD"
        }
      }
    ]
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Update line item #

PATCH/v1/orders/{order_id}/line-items/{order_line_item_id}Idempotent

Updates a single line item on an order.

Path parameters

order_idstringrequired

Flint order ID.

order_line_item_idstringrequired

Flint order line item ID.

Request body

descriptionstring

metadatamap of string

namestring

quantityinteger

Whole-number quantity; fractional quantities are not supported.

taxobject

unit_price_moneyobject

Monetary amount represented as integer minor units plus an ISO 4217 currency code.

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X PATCH https://api.withflintpay.com/v1/orders/ord_123/line-items/li_01HZYV7Q9Y0Y4H8Q3H9F6R7T8J \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "quantity": 3
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Delete line item #

DELETE/v1/orders/{order_id}/line-items/{order_line_item_id}Idempotent

Removes a single line item from an order.

Path parameters

order_idstringrequired

Flint order ID.

order_line_item_idstringrequired

Flint order line item ID.

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X DELETE https://api.withflintpay.com/v1/orders/ord_123/line-items/li_01HZYV7Q9Y0Y4H8Q3H9F6R7T8J \
  -H "Authorization: Bearer YOUR_API_KEY"

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Replace line item modifiers #

PUT/v1/orders/{order_id}/line-items/{order_line_item_id}/modifiersIdempotent

Replaces the selected modifier snapshots on a single order line item.

Path parameters

order_idstringrequired

Flint order ID.

order_line_item_idstringrequired

Flint order line item ID.

Request body

modifiersarray of objectrequired

order_revisioninteger

Response · 200

OrderResponseobject

CheckoutSessionLineItemModifierUpdateResponseobject

Bash

curl -X PUT https://api.withflintpay.com/v1/orders/ord_123/line-items/li_01HZYV7Q9Y0Y4H8Q3H9F6R7T8J/modifiers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "modifiers": [
      {
        "text": {
          "modifier_group_id": "mg_123",
          "value": "No onions"
        },
        "quantity": 1
      }
    ]
  }'

Remove line items #

POST/v1/orders/{order_id}/line-items/removeIdempotent

Removes one or more line items from an order.

Path parameters

order_idstringrequired

Flint order ID.

Request body

order_line_item_idsarray of stringrequired

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/line-items/remove \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "order_line_item_ids": [
      "li_123"
    ]
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Pay order #

POST/v1/orders/{order_id}/payIdempotent

Confirms the order's attached payment intents. Manual-capture intents return an active authorization instead of settling immediately.

Path parameters

order_idstringrequired

Flint order ID.

Request body

buyer_emailstring

expected_amount_moneyobject

Monetary amount represented as integer minor units plus an ISO 4217 currency code.

payment_intent_idsarray of string

payment_method_idsmap of string

payment_source_tokensmap of string

setup_payment_source_tokenstring

tip_payment_intent_idstring

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/pay \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "payment_intent_ids": [
      "pi_123"
    ],
    "payment_method_ids": {
      "pi_123": "pm_123"
    },
    "expected_amount_money": {
      "amount": 2500,
      "currency": "USD"
    },
    "buyer_email": "buyer@example.com"
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Capture order payment #

POST/v1/orders/{order_id}/payment-intents/{payment_intent_id}/captureIdempotent

Captures an active payment authorization for an order and updates the order payment lifecycle.

Path parameters

order_idstringrequired

Flint order ID.

payment_intent_idstringrequired

Flint payment intent ID.

Request body

amount_moneyobject

Monetary amount represented as integer minor units plus an ISO 4217 currency code.

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/payment-intents/pi_123/capture \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "amount_money": {
      "amount": 2500,
      "currency": "USD"
    }
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Void order payment authorization #

POST/v1/orders/{order_id}/payment-intents/{payment_intent_id}/voidIdempotent

Voids an active payment authorization for an order and releases the order payment lock.

Path parameters

order_idstringrequired

Flint order ID.

payment_intent_idstringrequired

Flint payment intent ID.

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/payment-intents/pi_123/void \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{}'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Set requested tip #

POST/v1/orders/{order_id}/requested-tipIdempotent

Sets or replaces the requested tip on an order.

Path parameters

order_idstringrequired

Flint order ID.

Request body

requested_tipone ofrequired

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/requested-tip \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "requested_tip": {
      "percent": 18
    }
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Clear requested tip #

POST/v1/orders/{order_id}/requested-tip/clearIdempotent

Clears the requested tip from an order.

Path parameters

order_idstringrequired

Flint order ID.

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X POST https://api.withflintpay.com/v1/orders/ord_123/requested-tip/clear \
  -H "Authorization: Bearer YOUR_API_KEY"

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Refresh order tax #

PATCH/v1/orders/{order_id}/taxIdempotent

Calculates tax for an order using a caller-provided postal code, billing address, or tax address.

Path parameters

order_idstringrequired

Flint order ID.

Request body

tax_locationobject

Response · 200

dataobjectrequired

metaobject

request_idstring

Bash

curl -X PATCH https://api.withflintpay.com/v1/orders/ord_123/tax \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "tax_location": {
      "address_source": "provided",
      "address_type": "shipping_address",
      "address": {
        "line1": "123 Market St",
        "line2": "Suite 400",
        "country": "US",
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94105"
      }
    }
  }'

JSON

{
  "data": {
    "order_id": "ord_123",
    "line_items": [
      {
        "order_line_item_id": "li_123",
        "name": "General Admission",
        "quantity": 2,
        "unit_price_money": {
          "amount": 2500,
          "currency": "USD"
        },
        "base_subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "modifier_total_money": {
          "amount": 0,
          "currency": "USD"
        },
        "subtotal_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "discount_money": {
          "amount": 0,
          "currency": "USD"
        },
        "tax_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_money": {
          "amount": 0,
          "currency": "USD"
        },
        "refunded_quantity": 0,
        "total_money": {
          "amount": 5000,
          "currency": "USD"
        },
        "metadata": {
          "ticket_type": "ga"
        }
      }
    ],
    "status": "open",
    "refund_status": "none",
    "metadata": {
      "event_id": "evt_123"
    },
    "merchant_id": "mer_123",
    "customer_id": "cus_123",
    "pricing_amounts": {
      "subtotal_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "discount_money": {
        "amount": 0,
        "currency": "USD"
      },
      "charge_money": {
        "amount": 0,
        "currency": "USD"
      },
      "tax_money": {
        "amount": 0,
        "currency": "USD"
      },
      "requested_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "total_money": {
        "amount": 5000,
        "currency": "USD"
      }
    },
    "tax": {
      "enabled": false,
      "status": ""
    },
    "settlement_amounts": {
      "paid_money": {
        "amount": 0,
        "currency": "USD"
      },
      "refunded_money": {
        "amount": 0,
        "currency": "USD"
      },
      "net_collected_money": {
        "amount": 0,
        "currency": "USD"
      },
      "settled_tip_money": {
        "amount": 0,
        "currency": "USD"
      },
      "balance_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "amount_due_money": {
        "amount": 5000,
        "currency": "USD"
      },
      "credit_money": {
        "amount": 0,
        "currency": "USD"
      }
    },
    "order_number": "1001",
    "source": "api",
    "created_at": "2026-03-17T14:30:00Z",
    "updated_at": "2026-03-17T14:30:00Z"
  },
  "request_id": "bce56cba-0827-44aa-bb56-4f200ba15ee6"
}

Rate this doc