Plugin Billing

Update plugin billing record

PUT

http://localhost:3000/api/plugins/{pluginId}/subscriptions/{subscriptionId}/billings/{id}

curl -X PUT 'http://localhost:3000/api/plugins/%7BpluginId%7D/subscriptions/%7BsubscriptionId%7D/billings/string' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "amount": 99.99,
  "currency": "USD",
  "billingDate": "2025-01-01T00:00:00Z",
  "dueDate": "2025-01-15T00:00:00Z",
  "paymentDueDate": "2025-01-30T00:00:00Z",
  "status": "pending",
  "billingPeriodStart": "2025-01-01T00:00:00Z",
  "billingPeriodEnd": "2025-01-31T23:59:59Z",
  "invoiceNumber": "INV-202501-0001",
  "invoiceUrl": "https://example.com/invoices/inv-123",
  "taxAmount": 9.99,
  "taxRate": 0.1,
  "discountAmount": 5,
  "discountCode": "SAVE10",
  "description": "Monthly subscription fee for Premium plan",
  "paymentReference": "PAY_12345",
  "metadata": {
    "source": "automated",
    "campaign": "summer2025"
  }
}'

const body = `{
  "amount": 99.99,
  "currency": "USD",
  "billingDate": "2025-01-01T00:00:00Z",
  "dueDate": "2025-01-15T00:00:00Z",
  "paymentDueDate": "2025-01-30T00:00:00Z",
  "status": "pending",
  "billingPeriodStart": "2025-01-01T00:00:00Z",
  "billingPeriodEnd": "2025-01-31T23:59:59Z",
  "invoiceNumber": "INV-202501-0001",
  "invoiceUrl": "https://example.com/invoices/inv-123",
  "taxAmount": 9.99,
  "taxRate": 0.1,
  "discountAmount": 5,
  "discountCode": "SAVE10",
  "description": "Monthly subscription fee for Premium plan",
  "paymentReference": "PAY_12345",
  "metadata": {
    "source": "automated",
    "campaign": "summer2025"
  }
}`;

const response = await fetch('http://localhost:3000/api/plugins/%7BpluginId%7D/subscriptions/%7BsubscriptionId%7D/billings/string', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();

import requests

body = '''{
  "amount": 99.99,
  "currency": "USD",
  "billingDate": "2025-01-01T00:00:00Z",
  "dueDate": "2025-01-15T00:00:00Z",
  "paymentDueDate": "2025-01-30T00:00:00Z",
  "status": "pending",
  "billingPeriodStart": "2025-01-01T00:00:00Z",
  "billingPeriodEnd": "2025-01-31T23:59:59Z",
  "invoiceNumber": "INV-202501-0001",
  "invoiceUrl": "https://example.com/invoices/inv-123",
  "taxAmount": 9.99,
  "taxRate": 0.1,
  "discountAmount": 5,
  "discountCode": "SAVE10",
  "description": "Monthly subscription fee for Premium plan",
  "paymentReference": "PAY_12345",
  "metadata": {
    "source": "automated",
    "campaign": "summer2025"
  }
}'''

response = requests.put(
    'http://localhost:3000/api/plugins/%7BpluginId%7D/subscriptions/%7BsubscriptionId%7D/billings/string',
    data=body.encode('utf-8'),
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{
  "amount": 99.99,
  "currency": "USD",
  "billingDate": "2025-01-01T00:00:00Z",
  "dueDate": "2025-01-15T00:00:00Z",
  "paymentDueDate": "2025-01-30T00:00:00Z",
  "status": "pending",
  "billingPeriodStart": "2025-01-01T00:00:00Z",
  "billingPeriodEnd": "2025-01-31T23:59:59Z",
  "invoiceNumber": "INV-202501-0001",
  "invoiceUrl": "https://example.com/invoices/inv-123",
  "taxAmount": 9.99,
  "taxRate": 0.1,
  "discountAmount": 5,
  "discountCode": "SAVE10",
  "description": "Monthly subscription fee for Premium plan",
  "paymentReference": "PAY_12345",
  "metadata": {
    "source": "automated",
    "campaign": "summer2025"
  }
}

Body

application/json

amountnumber>= 0

Billing amount

Example

99.99

currencystring

Currency code

Example

USD

billingDatestring<date-time>

Billing date

Example

2025-01-01T00:00:00Z

dueDatestring<date-time>

Due date for payment

Example

2025-01-15T00:00:00Z

paymentDueDatestring<date-time>

Payment due date

Example

2025-01-30T00:00:00Z

statusstringpendingprocessedpaidoverduefailedcancelledrefundedpartially_paid

Billing status

billingPeriodStartstring<date-time>

Billing period start date

Example

2025-01-01T00:00:00Z

billingPeriodEndstring<date-time>

Billing period end date

Example

2025-01-31T23:59:59Z

invoiceNumberstring

Invoice number

Example

INV-202501-0001

invoiceUrlstring

Invoice URL

Example

https://example.com/invoices/inv-123

taxAmountnumber>= 0

Tax amount

Example

9.99

taxRatenumber[0, 1]

Tax rate (as decimal)

Example

0.1

discountAmountnumber>= 0

Discount amount

Example

discountCodestring

Discount code

Example

SAVE10

descriptionstring

Billing description/notes

Example

Monthly subscription fee for Premium plan

paymentReferencestring

Payment reference

Example

PAY_12345

metadataobject

Billing metadata

Example

{
  "source": "automated",
  "campaign": "summer2025"
}

Parameters

idstringrequiredpath

Response

200OK

Plugin billing record updated successfully

Authorization

bearerhttp (bearer) in header

Enter JWT token

Stack Overflow Website Demo