❮❮ Back to Samples

Request Object

{
    "name": "T-Shirt of the Month Club Plan",
    "description": "Template creation.",
    "type": "fixed",
    "payment_definitions": [
        {
            "name": "Regular Payments",
            "type": "REGULAR",
            "frequency": "Month",
            "frequency_interval": "2",
            "cycles": "12",
            "amount": {
                "value": "100",
                "currency": "USD"
            },
            "charge_models": [
                {
                    "type": "SHIPPING",
                    "amount": {
                        "value": "10",
                        "currency": "USD"
                    }
                }
            ]
        }
    ],
    "merchant_preferences": {
        "return_url": "https://surveys.n-labs.com/lib/PayPal-PHP-SDK/paypal/rest-api-sdk-php/sample/billing/ExecuteAgreement.php?success=true",
        "cancel_url": "https://surveys.n-labs.com/lib/PayPal-PHP-SDK/paypal/rest-api-sdk-php/sample/billing/ExecuteAgreement.php?success=false",
        "auto_bill_amount": "yes",
        "initial_fail_amount_action": "CONTINUE",
        "max_fail_attempts": "0",
        "setup_fee": {
            "value": "1",
            "currency": "USD"
        }
    }
}

Response Object

{
    "name": "T-Shirt of the Month Club Plan",
    "description": "Template creation.",
    "type": "FIXED",
    "payment_definitions": [
        {
            "id": "PD-77V05232FV643321164BHKNI",
            "name": "Regular Payments",
            "type": "REGULAR",
            "frequency": "Month",
            "amount": {
                "currency": "USD",
                "value": "100"
            },
            "cycles": "12",
            "charge_models": [
                {
                    "id": "CHM-22U73933JW310660064BHKNI",
                    "type": "SHIPPING",
                    "amount": {
                        "currency": "USD",
                        "value": "10"
                    }
                }
            ],
            "frequency_interval": "2"
        }
    ],
    "merchant_preferences": {
        "setup_fee": {
            "currency": "USD",
            "value": "1"
        },
        "max_fail_attempts": "0",
        "return_url": "https://surveys.n-labs.com/lib/PayPal-PHP-SDK/paypal/rest-api-sdk-php/sample/billing/ExecuteAgreement.php?success=true",
        "cancel_url": "https://surveys.n-labs.com/lib/PayPal-PHP-SDK/paypal/rest-api-sdk-php/sample/billing/ExecuteAgreement.php?success=false",
        "auto_bill_amount": "YES",
        "initial_fail_amount_action": "CONTINUE"
    },
    "id": "P-1A844028PE893320564BHKNI",
    "state": "CREATED",
    "create_time": "2026-03-16T14:17:39.381Z",
    "update_time": "2026-03-16T14:17:39.381Z",
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/billing-plans/P-1A844028PE893320564BHKNI",
            "rel": "self",
            "method": "GET"
        }
    ]
}

Request Object

[
    {
        "op": "replace",
        "path": "/",
        "value": {
            "state": "ACTIVE"
        }
    }
]

Response Object

{
    "id": "P-1A844028PE893320564BHKNI",
    "state": "ACTIVE",
    "name": "T-Shirt of the Month Club Plan",
    "description": "Template creation.",
    "type": "FIXED",
    "payment_definitions": [
        {
            "id": "PD-77V05232FV643321164BHKNI",
            "name": "Regular Payments",
            "type": "REGULAR",
            "frequency": "Month",
            "amount": {
                "currency": "USD",
                "value": "100"
            },
            "cycles": "12",
            "charge_models": [
                {
                    "id": "CHM-22U73933JW310660064BHKNI",
                    "type": "SHIPPING",
                    "amount": {
                        "currency": "USD",
                        "value": "10"
                    }
                }
            ],
            "frequency_interval": "2"
        }
    ],
    "merchant_preferences": {
        "setup_fee": {
            "currency": "USD",
            "value": "1"
        },
        "max_fail_attempts": "0",
        "return_url": "https://surveys.n-labs.com/lib/PayPal-PHP-SDK/paypal/rest-api-sdk-php/sample/billing/ExecuteAgreement.php?success=true",
        "cancel_url": "https://surveys.n-labs.com/lib/PayPal-PHP-SDK/paypal/rest-api-sdk-php/sample/billing/ExecuteAgreement.php?success=false",
        "auto_bill_amount": "YES",
        "initial_fail_amount_action": "CONTINUE"
    },
    "create_time": "2026-03-16T14:17:39.381Z",
    "update_time": "2026-03-16T14:17:39.890Z",
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/billing-plans/P-1A844028PE893320564BHKNI",
            "rel": "self",
            "method": "GET"
        }
    ]
}

Request Object

{
    "name": "Base Agreement",
    "description": "Basic Agreement",
    "start_date": "2015-06-17T9:45:04Z",
    "plan": {
        "id": "P-1A844028PE893320564BHKNI"
    },
    "payer": {
        "payment_method": "paypal"
    },
    "shipping_address": {
        "line1": "111 First Street",
        "city": "Saratoga",
        "state": "CA",
        "postal_code": "95070",
        "country_code": "US"
    }
}

Response Object

Got Http response code 400 when accessing https://api.sandbox.paypal.com/v1/payments/billing-agreements/.

{
    "name": "VALIDATION_ERROR",
    "debug_id": "86bffe695142d",
    "message": "Invalid request. See details.",
    "information_link": "https://developer.paypal.com/docs/api/payments.billing-agreements#errors",
    "details": [
        {
            "field": "start_date",
            "issue": "Agreement start date is required,should be valid and greater than the current date. Should be consistent with ISO 8601 Format"
        }
    ]
}