Skip to main content

Documentation

Update Subscription Item

Change or modify a subscription item.

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

    • subscription_item

    • ID of the subscription item. String starting with subi_.

Code Samples
    • .NET

      • using System;
        using System.Text.Json;
        
        namespace RapydApiRequestSample
        {
            class Program
            {
                static void Main(string[] args)
                {
                    try
                    {
                        string subscriptionItem = "subi_e5dbbf84c68e5bb7db761625158d4262";
        
                        var requestObj = new
                        {
                            quantity = 2,
                            metadata = new
                            {
                                merchant_defined = true
                            }
                        };
        
                        string request = JsonSerializer.Serialize(requestObj);
        
                        string result = RapydApiRequestSample.Utilities.MakeRequest("POST", $"/v1/subscription_items/{subscriptionItem}", 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 = {
              quantity: 2
            };
            const result = await makeRequest(
              'POST',
              '/v1/subscription_items/subi_e5dbbf84c68e5bb7db761625158d4262',
              body
            );
        
            console.log(result);
          } catch (error) {
            console.error('Error completing request', error);
          }
        }
    • PHP

      • <?php
        $path = $_SERVER['DOCUMENT_ROOT'];
        $path .= "/<path-to-your-utility-file>/utilities.php";
        include($path);
        
        try {
            $body = [
                "metadata" => array(
                    "merchant_defined" => "updated"
                ),
                "quantity" => 2
            ];
            $object = make_request('post', '/v1/subscription_items/subi_e5dbbf84c68e5bb7db761625158d4262', $body);
            var_dump($object);
        } catch(Exception $e) {
            echo "Error: $e";
        }
        ?>
    • Python

      • from pprint import pprint
        
        from utilities import make_request
        
        subscription_item = {
            "metadata": {
                "merchant_defined": 'updated'
            },
            "quantity": 2
        }
        
        result = make_request(method='post', path='/v1/subscription_items/subi_e5dbbf84c68e5bb7db761625158d4262',
                              body=subscription_item)
        pprint(result)
  • /v1/subscription_items/:subscription_item

  • Update Subscription Item

  • curl -X post 'https://sandboxapi.rapyd.net/v1/subscription_items/subi_56de709f3fc6f32c5db71d6c03611841' \
    -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' \
    --data-raw '{
        "quantity": 1
    }'
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "56ea309d-90e1-415e-82d4-6cbdbfe68572"
        },
        "data": {
            "id": "subi_56de709f3fc6f32c5db71d6c03611841",
            "created": 1763462590,
            "metadata": null,
            "quantity": 1,
            "subscription_id": "sub_423cac7708b84939baf3d4a55b153a19",
            "plan": {
                "id": "plan_88b79142c283f660e6f42b6dbf4c4771",
                "aggregate_usage": "sum",
                "amount": 19.99,
                "billing_scheme": "per_unit",
                "created_at": 1763462581,
                "currency": "USD",
                "interval": "month",
                "interval_count": 1,
                "metadata": {},
                "product": {
                    "id": "product_4ba001c7655c4a0ee4f471dbaccaa305"
                },
                "nickname": "Unlimited Plan",
                "tiers": [],
                "tiers_mode": "",
                "transform_usage": {
                    "divide_by": 1,
                    "round": "up"
                },
                "trial_period_days": 0,
                "usage_type": "licensed",
                "active": true
            }
        }
    }