Skip to content

Lumo B2B Platform API (1.0.0)

API reference for company-facing endpoints of Lumo B2B platform.

Scope of this reference:

  • Company auth/profile
  • Orders (prepare/accept/list/get)
  • Company disputes
  • Company wallet + deposits
  • User wallets (per externalId) + user deposits

Not included:

  • Admin endpoints
Download OpenAPI description
index.json
index.yaml
Languages
Servers
Mock server
https://b2b-app.lumowallet.io/_mock/apis
Production
https://b2b.lumowallet.io
Staging
https://b2b-staging.lumowallet.io

Company Auth

Company registration, login, and profile management.

Operations

Orders

Quote preparation and order lifecycle operations.

Operations

Disputes

Company dispute creation and listing.

Operations

Open dispute for order

Request

Allowed only for completed order states (success or failed).

Behavior:

  • On create, order is moved to disputed.
  • If an open dispute already exists for the order (submitted / in_review), API returns that dispute.
  • Dispute is also sent to wallet-backend for synchronized processing.
Security
apiKeyAuth
Path
idstring(uuid)required

Order ID

Bodyapplication/jsonrequired
reasonstringrequired
curl -i -X POST \
  'https://b2b-app.lumowallet.io/_mock/apis/orders/{id}/disputes' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "reason": "string"
  }'

Responses

Dispute created

Bodyapplication/json
idstring(uuid)required
orderIdstring(uuid)required
statusstring(DisputeStatus)required
Enum"submitted""in_review""resolved""rejected"
resolutionDisputeResolution (string) or null

Set when dispute is resolved.

One of:

Set when dispute is resolved.

string(DisputeResolution)
Enum"refund""confirm""partial_refund"
reasonstringrequired
adminCommentstring or null
resolvedBystring or null
refundAmountnumber or null

Filled for partial_refund; null for confirm and full refund.

resolvedAtstring or null(date-time)

Resolution timestamp (admin or wallet callback sync).

createdAtstring(date-time)required
updatedAtstring(date-time)required
Response
application/json
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
  "status": "submitted",
  "resolution": "refund",
  "reason": "string",
  "adminComment": "string",
  "resolvedBy": "string",
  "refundAmount": 0,
  "resolvedAt": "2019-08-24T14:15:22Z",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

List company disputes

Request

Returns company dispute history (newest first).

Resolution fields:

  • resolvedAt is set when dispute is resolved.
  • resolution is set on resolve (confirm, refund, partial_refund).
  • refundAmount is set only for partial_refund; for confirm/refund it is null.

Disputes can be resolved by admin flow or automatically from wallet callback final status.

Security
apiKeyAuth
curl -i -X GET \
  https://b2b-app.lumowallet.io/_mock/apis/disputes \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

Disputes list

Bodyapplication/jsonArray [
idstring(uuid)required
orderIdstring(uuid)required
statusstring(DisputeStatus)required
Enum"submitted""in_review""resolved""rejected"
resolutionDisputeResolution (string) or null

Set when dispute is resolved.

One of:

Set when dispute is resolved.

string(DisputeResolution)
Enum"refund""confirm""partial_refund"
reasonstringrequired
adminCommentstring or null
resolvedBystring or null
refundAmountnumber or null

Filled for partial_refund; null for confirm and full refund.

resolvedAtstring or null(date-time)

Resolution timestamp (admin or wallet callback sync).

createdAtstring(date-time)required
updatedAtstring(date-time)required
]
Response
application/json
[
  {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "orderId": "b3e1eced-f2bd-4d8c-9765-fbc9d1d222d5",
    "status": "submitted",
    "resolution": "refund",
    "reason": "string",
    "adminComment": "string",
    "resolvedBy": "string",
    "refundAmount": 0,
    "resolvedAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
]

Company Wallet

Company deposit wallet, balances, and deposit history.

Operations

User Wallets

Per-user wallet management and user deposit history.

Operations