SOsolvapay
Products

Create a product

Changed on

Creates a new product for the authenticated provider.

post/v1/sdk/products

Request

Request body

descriptionstring
imageUrlstring
isManagedMcpboolean
isMcpPayboolean
metadataobject
namestring required
productTypestring
taxBehavior'auto' | 'inclusive' | 'exclusive'

Response

Product created successfully

balancenumber required

Product balance in cents

createdAtstring required

Creation timestamp

descriptionstring

Product description

imageUrlstring

URL to the product image

isManagedMcpboolean required

Whether this product uses the Managed MCP integration (SolvaPay reverse proxy)

isMcpPayboolean required

Deprecated alias of isManagedMcp. Prefer isManagedMcp; still emitted for wire compatibility.

mcpobject

MCP linkage details for MCP-enabled products

metadataobject

Arbitrary key-value metadata

namestring required

Product name

productTypestring

Free-form product type

referencestring required

Product reference

statusstring required

Product status

totalTransactionsnumber required

Total number of transactions

updatedAtstring required

Last update timestamp

Example response

{
  "config": {
    "deliveryMethod": "api",
    "fulfillmentType": "digital",
    "validityPeriod": 30
  },
  "mcp": {
    "defaultPlanRef": "pln_FREE123",
    "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
    "mcpServerRef": "mcp_ABC123",
    "mcpSubdomain": "acme-docs",
    "originUrl": "https://origin.example.com/mcp"
  },
  "name": "AI Writing Assistant",
  "plans": [
    {
      "currency": "USD",
      "currencySymbol": "$",
      "description": "Best for teams getting started",
      "isActive": true,
      "name": "Starter",
      "price": 2999,
      "reference": "pln_1A2B3C4D",
      "requiresPayment": true,
      "status": "active",
      "type": "recurring"
    }
  ],
  "reference": "prd_1A2B3C4D",
  "status": "active"
}

Changes

  • aeecbfb5cb3cRevision changes
    • info

      added the new optional request property

    • info

      response property isMcpPay deprecated

    • info

      added the required property to the response with the status

  • e356f6586bf2Revision changes
    • info

      added the optional property // to the response with the status