Create Subscription

Sets up a recurring charge. Switch creates the subscription at the provider; the provider charges the customer each cycle and Switch credits the wallet when it does.

Body

customerId

*String

Customer ID to create the subscription for.

currency

*String

3-letter ISO currency code.

amount

*Number

Amount charged each cycle in major units.

interval

*String

Billing interval. One of: "DAILY", "WEEKLY", "MONTHLY", "QUARTERLY" (Flutterwave only), "ANNUALLY".

callbackUrl

*String

Used only if enrollment requires a checkout. The customer is redirected here after completing the first payment.

provider

String

Provider to use. Omit to auto-select.

description

String

Description shown on the subscription (e.g. plan name).

POST

/ v2/wallet/subscriptions

Endpoint URL(TEXT)

https://api.sandbox.switch.tulupay.com/v2/wallet/subscriptions

https://api.sandbox.switch.tulupay.com/v2/wallet/subscriptions

Request Body

{
  "customerId": "cus_ada",
  "currency": "NGN",
  "amount": 2000,
  "interval": "MONTHLY",
  "callbackUrl": "https://acme.app/callback",
  "description": "Acme Premium"
}

{
  "customerId": "cus_ada",
  "currency": "NGN",
  "amount": 2000,
  "interval": "MONTHLY",
  "callbackUrl": "https://acme.app/callback",
  "description": "Acme Premium"
}

Response(JSON)

// Click 'Try now' to see the response