Create Subscription

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const subscription = await client.subscriptions.create({
  billing: { country: 'AF' },
  customer: { customer_id: 'customer_id' },
  product_id: 'product_id',
  quantity: 0,
});

console.log(subscription.payment_id);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
)
subscription = client.subscriptions.create(
    billing={
        "country": "AF"
    },
    customer={
        "customer_id": "customer_id"
    },
    product_id="product_id",
    quantity=0,
)
print(subscription.payment_id)

package main

import (
	"context"
	"fmt"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken("My Bearer Token"),
	)
	subscription, err := client.Subscriptions.New(context.TODO(), dodopayments.SubscriptionNewParams{
		Billing: dodopayments.F(dodopayments.BillingAddressParam{
			Country: dodopayments.F(dodopayments.CountryCodeAf),
		}),
		Customer: dodopayments.F[dodopayments.CustomerRequestUnionParam](dodopayments.AttachExistingCustomerParam{
			CustomerID: dodopayments.F("customer_id"),
		}),
		ProductID: dodopayments.F("product_id"),
		Quantity:  dodopayments.F(int64(0)),
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", subscription.PaymentID)
}

package com.dodopayments.api.example;

import com.dodopayments.api.client.DodoPaymentsClient;
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;
import com.dodopayments.api.models.misc.CountryCode;
import com.dodopayments.api.models.payments.AttachExistingCustomer;
import com.dodopayments.api.models.payments.BillingAddress;
import com.dodopayments.api.models.subscriptions.SubscriptionCreateParams;
import com.dodopayments.api.models.subscriptions.SubscriptionCreateResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();

        SubscriptionCreateParams params = SubscriptionCreateParams.builder()
            .billing(BillingAddress.builder()
                .country(CountryCode.AF)
                .build())
            .customer(AttachExistingCustomer.builder()
                .customerId("customer_id")
                .build())
            .productId("product_id")
            .quantity(0)
            .build();
        SubscriptionCreateResponse subscription = client.subscriptions().create(params);
    }
}

package com.dodopayments.api.example

import com.dodopayments.api.client.DodoPaymentsClient
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient
import com.dodopayments.api.models.misc.CountryCode
import com.dodopayments.api.models.payments.AttachExistingCustomer
import com.dodopayments.api.models.payments.BillingAddress
import com.dodopayments.api.models.subscriptions.SubscriptionCreateParams
import com.dodopayments.api.models.subscriptions.SubscriptionCreateResponse

fun main() {
    val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()

    val params: SubscriptionCreateParams = SubscriptionCreateParams.builder()
        .billing(BillingAddress.builder()
            .country(CountryCode.AF)
            .build())
        .customer(AttachExistingCustomer.builder()
            .customerId("customer_id")
            .build())
        .productId("product_id")
        .quantity(0)
        .build()
    val subscription: SubscriptionCreateResponse = client.subscriptions().create(params)
}

require "dodopayments"

dodo_payments = Dodopayments::Client.new(
  bearer_token: "My Bearer Token",
  environment: "test_mode" # defaults to "live_mode"
)

subscription = dodo_payments.subscriptions.create(
  billing: {country: :AF},
  customer: {customer_id: "customer_id"},
  product_id: "product_id",
  quantity: 0
)

puts(subscription)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Dodopayments\Client;
use Dodopayments\Core\Exceptions\APIException;
use Dodopayments\Misc\CountryCode;
use Dodopayments\Misc\Currency;
use Dodopayments\Payments\PaymentMethodTypes;

$client = new Client(
  bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',
  environment: 'test_mode',
);

try {
  $subscription = $client->subscriptions->create(
    billing: [
      'country' => CountryCode::AF,
      'city' => 'city',
      'state' => 'state',
      'street' => 'street',
      'zipcode' => 'zipcode',
    ],
    customer: ['customerID' => 'customer_id'],
    productID: 'product_id',
    quantity: 0,
    addons: [['addonID' => 'addon_id', 'quantity' => 0]],
    allowedPaymentMethodTypes: [PaymentMethodTypes::ACH],
    billingCurrency: Currency::AED,
    customerBusinessName: 'customer_business_name',
    discountCode: 'discount_code',
    discountCodes: ['string'],
    force3DS: true,
    mandateMinAmountInrPaise: 0,
    metadata: ['foo' => 'string'],
    onDemand: [
      'mandateOnly' => true,
      'adaptiveCurrencyFeesInclusive' => true,
      'productCurrency' => Currency::AED,
      'productDescription' => 'product_description',
      'productPrice' => 0,
    ],
    oneTimeProductCart: [
      ['productID' => 'product_id', 'quantity' => 0, 'amount' => 0]
    ],
    paymentLink: true,
    paymentMethodID: 'payment_method_id',
    redirectImmediately: true,
    requirePhoneNumber: true,
    returnURL: 'return_url',
    shortLink: true,
    showSavedPaymentMethods: true,
    taxID: 'tax_id',
    trialPeriodDays: 0,
  );

  var_dump($subscription);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using DodoPayments.Client;
using DodoPayments.Client.Models.Misc;
using DodoPayments.Client.Models.Payments;
using DodoPayments.Client.Models.Subscriptions;

DodoPaymentsClient client = new();

SubscriptionCreateParams parameters = new()
{
    Billing = new()
    {
        Country = CountryCode.Af,
        City = "city",
        State = "state",
        Street = "street",
        Zipcode = "zipcode",
    },
    Customer = new AttachExistingCustomer("customer_id"),
    ProductID = "product_id",
    Quantity = 0,
};

var subscription = await client.Subscriptions.Create(parameters);

Console.WriteLine(subscription);

use dodopayments::Client;

#[tokio::main]
async fn main() -> dodopayments::Result<()> {
    let client = Client::from_env()?;
    let result = client
        .subscriptions()
        .create()
        .body(dodopayments::models::SubscriptionsCreateParams {
                billing: Some(Box::new(dodopayments::models::BillingAddress {
                    country: Box::new(dodopayments::models::CountryCode::Af),
                    city: None,
                    state: None,
                    street: None,
                    zipcode: None,
                })),
                customer: Some(Box::new(dodopayments::models::CustomerRequest::AttachExistingCustomer(Box::new(dodopayments::models::AttachExistingCustomer {
                    customer_id: "customer_id".to_string(),
                })))),
                product_id: Some("product_id".to_string()),
                quantity: Some(0),
                ..Default::default()
            })
        .await?;
    println!("{result:?}");
    Ok(())
}

curl --request POST \
  --url https://test.dodopayments.com/subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "billing": {
    "city": "<string>",
    "state": "<string>",
    "street": "<string>",
    "zipcode": "<string>"
  },
  "customer": {
    "customer_id": "<string>"
  },
  "product_id": "<string>",
  "quantity": 1,
  "addons": [
    {
      "addon_id": "<string>",
      "quantity": 1
    }
  ],
  "allowed_payment_method_types": [],
  "customer_business_name": "<string>",
  "discount_code": "<string>",
  "discount_codes": [
    "<string>"
  ],
  "force_3ds": true,
  "mandate_min_amount_inr_paise": 123,
  "metadata": {},
  "on_demand": {
    "mandate_only": true,
    "adaptive_currency_fees_inclusive": true,
    "product_description": "<string>",
    "product_price": 123
  },
  "one_time_product_cart": [
    {
      "product_id": "<string>",
      "quantity": 1,
      "amount": 123
    }
  ],
  "payment_link": true,
  "payment_method_id": "<string>",
  "redirect_immediately": true,
  "require_phone_number": true,
  "return_url": "<string>",
  "short_link": true,
  "show_saved_payment_methods": true,
  "tax_id": "<string>",
  "trial_period_days": 123
}
'

{
  "addons": [
    {
      "addon_id": "<string>",
      "quantity": 123
    }
  ],
  "customer": {
    "customer_id": "<string>",
    "email": "<string>",
    "name": "<string>",
    "metadata": {},
    "phone_number": "<string>"
  },
  "metadata": {},
  "payment_id": "<string>",
  "recurring_pre_tax_amount": 1,
  "subscription_id": "<string>",
  "client_secret": "<string>",
  "discount_id": "<string>",
  "discount_ids": [
    "<string>"
  ],
  "expires_on": "2023-11-07T05:31:56Z",
  "one_time_product_cart": [
    {
      "product_id": "<string>",
      "quantity": 1
    }
  ],
  "payment_link": "<string>"
}