---
title: "Authorizes the subscription proposal"
method: POST
path: "/v1/subscriptions/{subscription_id}/subscribe"
tags: ["Subscriptions"]
---

# Authorizes the subscription proposal

`POST /v1/subscriptions/{subscription_id}/subscribe`

Registers the authorization given by the buyer for the subscription proposal and activates it

## Path parameters

- `subscription_id` string, required

## Request body

- EdubankSubscriptionSubscribeDto
  - `encrypted_card` string, required — Encrypted edubank card data
  - `authorized` boolean, required — Inform whether the buyer authorized the signature
  - `buyer` EdubankBuyerDto, required
    - `first_name` string, required — Buyer's first name
    - `last_name` string, required — Buyer's last name
    - `email` string — Buyer's email
    - `taxpayer_id` string, required — Buyer's CPF/CNPJ
    - `birthdate` string — Buyer's date of birth
    - `phone_number` string — Buyer's phone number
    - `address` EdubankBuyersAddress, required
      - `city` string, required — City
      - `additional_information` string — Additional address data. In this field you can inform complement, references
      - `number` string, required — Number
      - `state_code` string, required — State (UF)
      - `street` string, required — Street / Patio
      - `neighborhood` string, required — Neighborhood
      - `zip` string, required — Postal Zone / ZIP Code)
      - `country_code` 'BR', required — Buyer's country code

## Response `201`

The object has been successfully created

- EdubankSubscription
  - `created_at` string — When the subscription was created. YYYY-MM-DDTHH:mm:ssZ
  - `updated_at` string — Last time subscription was updated. YYYY-MM-DDTHH:mm:ssZ
  - `seller_id` string, required — Edubank seller id
  - `subscription_id` string, required — Edubank subscription id
  - `description` string, required — Brief description of what the signature refers to
  - `reference_id` string, required — Reference ID of your application VARCHAR(500)
  - `buyer_id` string, required — Buyer id
  - `status` 'PROPOSAL' | 'ACTIVE' | 'EXPIRED' | 'CANCELED' | 'SUSPENDED' | 'REACTIVATED', required — Subscription status: PROPOSAL - ACTIVE - CANCELED - SUSPENDED - REACTIVATED
  - `expires_in` string, required — Deadline for signature authorization by the buyer
  - `charge` EdubankSubscriptionCharge, required
    - `start_date` string, required — Date the first invoice will be paid
    - `frequency` 'DAILY' | 'MONTHLY', required — Frequency with which the subscription will be charged. DAILY - MONTHLY
    - `duration` number, required — Subscription duration in relation to the chosen frequency
    - `amount` number, required — Gross amount to be paid. Ex: 2010 = 20.10
  - `notification_url` string, required — URL that will receive a POST call when the transaction changes
  - `subscription_permission` EdubankSubscriptionPermission, required
    - `authorized` boolean, required — Confirmation of buyer authorization to activate subscription
    - `authorized_in` string, required — Card update date/time. YYYY-MM-DDTHH:mm:ssZ
    - `card_id` string, required — Card authorized and registered for signature
  - `references` EdubankSubscriptionReferences[] — References for payment notification that will be sent when payment is received for the subscription
    - `due_date` string, required — Due date that must be considered to consider the respective reference paid. YYYY-MM-DD
    - `reference_id` string, required — Reference ID of your application VARCHAR(500)

## Other responses

- `400` — Client specified an invalid argument, request body or query param
- `401` — The user is unauthorized
- `403` — Authenticated user is not allowed to access this resource
- `404` — The resource was not found
- `408` — Request timeout
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/edubank/apis/api-edubank.md) · [All operations](https://skmtc.dev/edubank/apis/api-edubank/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/edubank/api-edubank/revisions/dce4008191d4/schema)