Build better, smarter, faster with our API

subscription = client.subscriptions.create(
    params={
        "amount" : 1500,
        "currency" : "GBP",
        "interval_unit" : "monthly",
        "day_of_month" : "5",
        "links": {
            "mandate": "MD0000XH9A3T4C"
        },
        "metadata": {
            "subscription_number": "ABC1234"
        }
    }, headers={
        'Idempotency-Key': "random_subscription_specific_string"
})

subscription = client.subscriptions.create(
  params: {
    amount: 1500,
    currency: 'GBP',
    interval_unit: 'monthly',
    day_of_month: '5',
    links: {
      mandate: 'MD0000XH9A3T4C'
    },
    metadata: {
      subscription_number: 'ABC1234'
    }
  },
  headers: {
    'Idempotency-Key': 'random_subscription_specific_string'
  }
)

public class CreateSubscription {
    public static void main(String[] args) {
        GoCardlessClient client = GoCardlessClient.create(
            System.getenv("GC_ACCESS_TOKEN"),
            GoCardlessClient.Environment.SANDBOX
        );
        Subscription subscription = client.subscriptions().create()
            .withAmount(1500)
            .withCurrency("GBP")
            .withIntervalUnit(IntervalUnit.MONTHLY)
            .withDayOfMonth(5)
            .withLinksMandate("MD0000YTKZKY4J")
            .withMetadata("subscription_number", "ABC123")
            .withIdempotencyKey("random_subscription_specific_string")
            .execute();
    }
}

using System;
using GoCardless;
using GoCardless.Services;
using GoCardless.Resources;

class Program
{
  static void Main(string[] args)
  {
    String access_token = Environment.GetEnvironmentVariable("GC_TOKEN");

    var gocardless = GoCardlessClient.Create(
    access_token, GoCardlessClient.Environment.SANDBOX);

    var subscriptionRequest = new SubscriptionCreateRequest()
    {
      Amount = 1000,
      Currency = "GBP",
      Name = "Monthly subscription",
      Interval = 1,
      IntervalUnit = SubscriptionCreateRequest.SubscriptionIntervalUnit.Monthly,
      Links = new SubscriptionCreateRequest.SubscriptionLinks()
      {
        Mandate = "MD0123"
      }
    };

    var subscriptionResponse = gocardless.Subscriptions.CreateAsync(subscriptionRequest).Result;
    Subscription subscription = subscriptionResponse.Subscription;
  }
}