Migrar suscripción

POST

/v1/subscriptions/migrate

Crea una suscripción que ya estaba activa en otra plataforma y la deja en estado active, con el próximo cobro programado para la fecha que indiques. El primer cobro se genera en esa fecha, así el cliente no paga dos veces ni pierde días del ciclo actual.

Sirve para traer una base de suscriptores ya cobrados. La suscripción queda lista para renovar en next_renewal_date y no se emite subscription.created.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.treli.co/v1/subscriptions/migrate' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "items": [
        {
            "price": "price_t326RtmWI3LdJHRS5fjYsMbI",
            "quantity": 1,
            "unit_price": 5000
        }
    ],
    "currency": "COP",
    "customer": "cus_FsoSoOaaJo7R5dH4oSG4FA47",
    "days_until_due": 15,
    "collection_method": "collect",
    "next_renewal_date": "2026-05-30 12:50:00"
}'

Response Example

{
    "id": "sub_IiFWdYgq7QIrx1nkvDcOhXqi",
    "customer": "cus_TgfdA2vL9rnWblZM8LtWMsdY",
    "items": [
        {
            "id": "si_d7d2UrHwSG5A5YkYF7vfZmFf",
            "name": "Nombre del producto",
            "unit_price": "20000.00",
            "quantity": 1,
            "subtotal": "20000.00",
            "total": "20000.00",
            "product": {
                "id": "prod_GYzZ5BXNRu6DxqQcEPJNoeCk",
                "name": "Nombre del producto",
                "description": "string",
                "status": "active",
                "product_merchant_id": null,
                "product_invoicing_id": null,
                "product_shopify_id": null,
                "product_woocommerce_id": null,
                "created_date": "2024-11-15 16:44:50",
                "image": "http://example.com",
                "is_test": false,
                "invoice_settings": {
                    "invoice_tax_id": "12345",
                    "invoice_tax_percentage": "19"
                },
                "meta_data": {
                    "key": "value"
                }
            },
            "price": {
                "id": "price_zUI6hNgEkX8sOLIUjnB9JpaQ",
                "unit_price": "20000.00",
                "pricing_model": "standard",
                "currency": "COP",
                "billing_period": "day",
                "billing_interval": 1,
                "type": "recurring",
                "pricing_tiers": null,
                "ntp_pricing": null,
                "created_date": "2024-11-15 16:44:50",
                "active": true,
                "is_test": false,
                "product_id": "prod_GYzZ5BXNRu6DxqQcEPJNoeCk",
                "meta_data": {
                    "key": "value"
                }
            }
        }
    ],
    "discounts": [
        {
            "id": "sd_aYbDFQaOd7TmBl0I58D5ax8l",
            "code": "10OFF",
            "amount": "10000.00",
            "percent": "10.00",
            "duration_in_collections": 1,
            "elapsed_duration": 0
        }
    ],
    "taxes": [
        {
            "type": "string",
            "name": "string",
            "tax_id": "string",
            "total": "string"
        }
    ],
    "latest_collection": "col_75jaKNHdYNfFpooDaDJKIMtu",
    "subtotal": "20000.00",
    "total": "20000.00",
    "currency": "COP",
    "collection_method": "charge",
    "status": "active",
    "created_date": "2024-11-15 16:44:50",
    "start_date": "2024-11-15 16:44:50",
    "next_renewal_date": "2024-11-15 16:44:50",
    "latest_renewal_date": "2024-11-15 16:44:50",
    "canceled_at_date": "2019-08-24T14:15:22.123Z",
    "resumes_at": "2019-08-24T14:15:22.123Z",
    "ended_at_date": "2019-08-24T14:15:22.123Z",
    "expires_at_date": "2019-08-24T14:15:22.123Z",
    "paused_at_date": "2019-08-24T14:15:22.123Z",
    "billing_period": "month",
    "billing_interval": "1",
    "trial_days": 0,
    "payment_method": "string",
    "payment_method_gateway": "wompi",
    "payment_method_type": "card",
    "is_test": false,
    "days_until_due": 1,
    "tag": "string",
    "exclude_from_batch": false,
    "source": "string",
    "meta_data": {
        "key": "value"
    },
    "duration": 1,
    "commitment_periods": 1,
    "cancelation_details": {
        "feedback": "customer_service",
        "comment": "string"
    },
    "first_payment_invoicing": "create",
    "renewal_invoicing": true,
    "invoice_settings": {
        "invoice_document_id": "string",
        "invoice_cost_center": "string",
        "provider": "siigo"
    },
    "invoice_retentions": {
        "reteica": "string",
        "retefte": "string"
    },
    "requires_shipping_address": false,
    "payment_settings": null,
    "switch_to_charge": false
}

Listar suscripciones

Obtener item de suscripción