upgrade paddle subscription

PUT

/payments/update-paddle-subscription

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200upgrade paddle plan

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/payments/update-paddle-subscription' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "paddle_price_id": "pri_01jgkqq7399qgqrjy6jz6kerfr"
}'

Response Example

{
    "success": true,
    "message": "subscription updated successfully",
    "data": {
        "data": {
            "id": "sub_01jjf5fqyyp2ecp16dxk4hhd77",
            "status": "active",
            "customer_id": "ctm_01jja0yvygm712sbcy5tg0qm4r",
            "address_id": "add_01jjf5czr60rfsdpa1ypr9yysp",
            "business_id": null,
            "currency_code": "USD",
            "created_at": "2025-01-25T16:42:26.654Z",
            "updated_at": "2025-01-26T16:56:56.837Z",
            "started_at": "2025-01-25T16:42:25.829028Z",
            "first_billed_at": "2025-01-25T16:42:25.829028Z",
            "next_billed_at": "2025-04-26T16:56:56.679Z",
            "paused_at": null,
            "canceled_at": null,
            "collection_mode": "automatic",
            "billing_details": null,
            "current_billing_period": {
                "starts_at": "2025-01-26T16:56:56.679Z",
                "ends_at": "2025-04-26T16:56:56.679Z"
            },
            "billing_cycle": {
                "frequency": 3,
                "interval": "month"
            },
            "scheduled_change": null,
            "items": [
                {
                    "status": "active",
                    "quantity": 1,
                    "recurring": true,
                    "created_at": "2025-01-26T16:56:56.697Z",
                    "updated_at": "2025-01-26T16:56:56.697Z",
                    "previously_billed_at": "2025-01-26T16:56:56.697Z",
                    "next_billed_at": "2025-04-26T16:56:56.679Z",
                    "trial_dates": null,
                    "price": {
                        "id": "pri_01jgkqfbngfg6cg6qcdyem3z4m",
                        "product_id": "pro_01jghfxvf58s71bzmq2ymqwtve",
                        "type": "standard",
                        "description": "team-quarterly",
                        "name": "team-quarterly",
                        "tax_mode": "external",
                        "billing_cycle": {
                            "frequency": 3,
                            "interval": "month"
                        },
                        "trial_period": null,
                        "unit_price": {
                            "amount": "7500",
                            "currency_code": "USD"
                        },
                        "unit_price_overrides": [],
                        "custom_data": {
                            "plan": "team-quarterly"
                        },
                        "status": "active",
                        "quantity": {
                            "minimum": 1,
                            "maximum": 999999
                        },
                        "import_meta": null,
                        "created_at": "2025-01-02T14:42:22.512364Z",
                        "updated_at": "2025-01-23T09:31:27.682503Z"
                    },
                    "product": {
                        "id": "pro_01jghfxvf58s71bzmq2ymqwtve",
                        "name": "team",
                        "type": "standard",
                        "tax_category": "standard",
                        "description": "",
                        "image_url": "",
                        "custom_data": null,
                        "status": "active",
                        "created_at": "2025-01-01T17:51:59.973Z",
                        "updated_at": "2025-01-02T12:40:36.321Z"
                    }
                }
            ],
            "custom_data": null,
            "management_urls": {
                "update_payment_method": "https://sandbox-buyer-portal.paddle.com/subscriptions/sub_01jjf5fqyyp2ecp16dxk4hhd77/update-payment-method?token=pga_eyJhbGciOiJFZERTQSIsImtpZCI6Imp3a18wMWhkazBuOHF3OG55NTJ5cGNocGNhazA1ayIsInR5cCI6IkpXVCJ9.eyJpZCI6InBnYV8wMWpqaHJxMHhuMDhwZG5heHhjY3B2dGZ6OCIsInNlbGxlci1pZCI6IjI2MDIwIiwidHlwZSI6InN0YW5kYXJkIiwidmVyc2lvbiI6IjEiLCJ1c2FnZSI6Im1hbmFnZW1lbnRfdXJsIiwic2NvcGUiOiJjdXN0b21lci5zdWJzY3JpcHRpb24tcGF5bWVudC51cGRhdGUgY3VzdG9tZXIuc3Vic2NyaXB0aW9uLXBheW1lbnQucmVhZCBjdXN0b21lci5zdWJzY3JpcHRpb24tY2FuY2VsLmNyZWF0ZSBjdXN0b21lci5zdWJzY3JpcHRpb24ucmVhZCIsImlzcyI6Imd1ZXN0YWNjZXNzLXNlcnZpY2UiLCJzdWIiOiJjdG1fMDFqamEweXZ5Z203MTJzYmN5NXRnMHFtNHIiLCJleHAiOjE3Njk0NDY2MTcsImlhdCI6MTczNzkxMDYxN30.fuJTZhMHkwmlDwtQc9dj3eMonUZzIGNsrYRs0jo8w9CuoFMY83F0xA7QQd0cpUUHVeUas3oDRFSrwMHP60KICA",
                "cancel": "https://sandbox-buyer-portal.paddle.com/subscriptions/sub_01jjf5fqyyp2ecp16dxk4hhd77/cancel?token=pga_eyJhbGciOiJFZERTQSIsImtpZCI6Imp3a18wMWhkazBuOHF3OG55NTJ5cGNocGNhazA1ayIsInR5cCI6IkpXVCJ9.eyJpZCI6InBnYV8wMWpqaHJxMHhuMDhwZG5heHhjY3B2dGZ6OCIsInNlbGxlci1pZCI6IjI2MDIwIiwidHlwZSI6InN0YW5kYXJkIiwidmVyc2lvbiI6IjEiLCJ1c2FnZSI6Im1hbmFnZW1lbnRfdXJsIiwic2NvcGUiOiJjdXN0b21lci5zdWJzY3JpcHRpb24tcGF5bWVudC51cGRhdGUgY3VzdG9tZXIuc3Vic2NyaXB0aW9uLXBheW1lbnQucmVhZCBjdXN0b21lci5zdWJzY3JpcHRpb24tY2FuY2VsLmNyZWF0ZSBjdXN0b21lci5zdWJzY3JpcHRpb24ucmVhZCIsImlzcyI6Imd1ZXN0YWNjZXNzLXNlcnZpY2UiLCJzdWIiOiJjdG1fMDFqamEweXZ5Z203MTJzYmN5NXRnMHFtNHIiLCJleHAiOjE3Njk0NDY2MTcsImlhdCI6MTczNzkxMDYxN30.fuJTZhMHkwmlDwtQc9dj3eMonUZzIGNsrYRs0jo8w9CuoFMY83F0xA7QQd0cpUUHVeUas3oDRFSrwMHP60KICA"
            },
            "discount": null,
            "import_meta": null
        },
        "meta": {
            "request_id": "c39275d2-c357-4b0f-838c-e4dc0a686651"
        }
    }
}

Modified at 2025-09-02 07:34:45

preview subscription update

get discounts