Update Invoice Item

Change or modify an invoice item.

You can update an invoice item at any time before the corresponding subscription generates an invoice.

This method triggers the Invoice Item Updated webhook. This webhook contains the same information as the response.

Parameters

Request Path Parameters

- invoice_item
- ID of the invoice item.

Request Header Parameters

Request Body Parameters

- days_until_due
- Number of days the customer has for paying this invoice. Integer.
  30
- description
- Description of the invoice.
- due_date
- The date payment is due on this invoice. This value is calculated from the date the invoice is created, plus the number of days specified in the days_until_due field. Relevant when billing is send_invoice. Format is in Unix time.
- metadata
- A JSON object defined by the client. See Metadata.
- payment_fields
- Additional payment_options.
- statement_descriptor
- Description of the invoice for the customer's credit card statement. Limited to 22 characters.
- tax_percent
- The percentage tax rate that is applied to the subtotal of the invoice, after subtracting all discounts. Decimal, up to four decimal places. Range: 0-100

Response Parameters

- amount
- The amount of the total charge or credit for this item. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015.
  This is quantity times unit_amount. A credit is indicated by a negative number.
- currency
- Three-letter ISO 4217 code for the currency used in the amount field.
- customer
- ID of the customer. String starting with cus_.
- date
- The time of the charge or credit, in Unix time.
- description
- Description of the invoice item.
- discountable
- Determines whether this invoice item is subject to the discount defined in the coupon that is assigned to the customer or subscription.
- id
- ID of the invoice item. String starting with ii_.
- invoice
- ID of the invoice that this invoice item is assigned to. Relevant when subscription is not set.
- metadata
- A JSON object defined by the client. See Metadata.
- period
- Defines the start and end of the time period that this invoice item refers to. Relevant when the invoice item refers to more than one day. Contains the following fields:
  - end
    The end of the time period. Unix time.
  - start
    The start of the time period. Unix time.
- plan
- Describes the pricing structure for the invoice item. For details of the fields in the 'plan' object, see Create Plan.
- proration
- Indicates whether the invoice item is prorated.
- quantity
- Indicates the number of units charged as a single invoice item. Integer.
- subscription
- ID of the subscription this invoice item is assigned to. By default, the invoice item is assigned to the customer's subscription whose current billing cycle ends first. Relevant when invoice is not set.
- unit_amount
- Per-unit price of the product or service, adjusted as defined in the plan. Decimal.

Code Samples

.NET

using System;
using System.Text.Json;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                string invoiceId = "ii_50f7127dd0f7725c6599697d971af8b8";

                var requestObj = new
                {
                    amount = 50,
                    description = "",
                    discountable = false,
                    metadata = new
                    {
                        merchant_defined = true
                    },
                    quantity = 0,
                    unit_amount = 0                    
                };

                string request = JsonSerializer.Serialize(requestObj);

                string result = RapydApiRequestSample.Utilities.MakeRequest("POST", $"/v1/invoice_items/{invoiceId}", request);

                Console.WriteLine(result);
            }
            catch (Exception e)
            {
                Console.WriteLine("Error completing request: " + e.Message);
            }
        }
    }
}

JavaScript

const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

async function main() {
  try {
    const body = {
      amount: 50,
      description: "",
      discountable: false,
      metadata: {
        merchant_defined: true
      },
      quantity: 0,
      unit_number: 0
    };
    const result = await makeRequest(
      'POST',
      '/v1/invoice_items/ii_50f7127dd0f7725c6599697d971af8b8',
      body
    );

    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

PHP

<?php
$path .= "/<path-to-your-utility-file>/utilities.php";
include($path);

$body = [
      "amount" => 50,
      "description" => "",
      "discountable" => false,
      "quantity" => 0,
      "unit_amount" => 0
];

try {
    $object = make_request('post', "/v1/invoice_items/ii_50f7127dd0f7725c6599697d971af8b8", $body);
    var_dump($object);
} catch(Exception $e) {
    echo "Error => $e";
}
?>

Python

from pprint import pprint

from utilities import make_request

invoice_item = {
    "amount": 50,
    "description": "",
    "discountable": False,
    "metadata": {
        "merchant_defined": True
    },
    "quantity": 0,
    "unit_amount": 0
}
result = make_request(method='post', path='/v1/invoice_items/ii_50f7127dd0f7725c6599697d971af8b8', body=invoice_item)
pprint(result)

/v1/invoice_items/:invoice_item

Update Invoice Item

curl -X post
https://sandboxapi.rapyd.net/v1/invoice_items/ii_50f7127dd0f7725c6599697d971af8b8
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'idempotency: your-idempotency-parameter-here'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'
-d '{
    "amount": 50,
    "description": "",
    "discountable": false,
    "metadata": {
        "merchant_defined": true
    },
    "quantity": 0,
    "unit_amount": 0
}
'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "22ce0b1a-3a3d-40ad-8a40-a30ad82fb384"
    },
    "data": {
        "id": "ii_50f7127dd0f7725c6599697d971af8b8",
        "amount": 50,
        "currency": "USD",
        "customer": "cus_f4251b4835e51e52d8adf3f1340c3419",
        "date": 1542974679,
        "description": "",
        "discountable": false,
        "invoice": "",
				"metadata": {
						"merchant_defined": true
				},
        "period": {
            "start": 0,
            "end": 0
        },
        "plan": {
            "product": null,
            "transform_usage": {}
        },
        "proration": "",
        "quantity": 0,
        "subscription": "sub_a19440d43875dd18c58058e722f1dd18",
        "unit_amount": 0
    }
}

In this section:

Documentation