Recurring Payments
Create/Edit Recurring Payment
POST/subscription/setup

This API allows you to create and manage automated recurring payment schedules for both card and ACH payment methods. Using this API, you can configure recurring billing frequencies such as weekly, monthly, quarterly, annually, or fully custom intervals. It also supports flexible end conditions, including subscriptions that never expire, subscriptions that stop after a specific number of payments, or subscriptions that end on a defined date. This endpoint supports- * Card and ACH recurring payments * Weekly, monthly, quarterly, annual, and custom billing schedules * Fixed payment count or end-date termination * ACH SEC code configuration * Updating existing subscriptions using `subscription_id` All requests must be authenticated using a valid token header.

Header Parameters

token*
string

Body Parameters

Subscription Mode
Payment Method
customer_id*
string
recurring_frequency*
enum
amount*
number
currency*
string
tpn*
string
end_criteria*
enum
end_value*
number
start_date*
string
custom_interval_days*
number
reference_id
string
card_token*
string
POST/subscription/setup
1curl --location 'https://api.ipospays.tech/v1/subscription/setup' \
2--header 'token: ' \
3--header 'Content-Type: application/json' \
4--data '{
5 "customer_id": "",
6 "recurring_frequency": "CUSTOM",
7 "amount": 1000,
8 "currency": "USD",
9 "tpn": "",
10 "end_criteria": "COUNT",
11 "end_value": 1,
12 "start_date": "",
13 "custom_interval_days": 1,
14 "reference_id": "",
15 "card_token": ""
16}'
Response

// Awaiting response…

Sample response
{
  "data": {
    "subscription_id": "V7XJKGG7FJ6HL9B",
    "customer_id": "LMN7JCZ61GGICDW",
    "recurring_frequency": "WEEKLY"
  },
  "message": "subscription added successfully",
  "response_code": "SUCCESS",
  "status_code": 200,
  "request_id": "TEST-20251112011500-LQJL3G",
  "timestamp": "2025-11-12T06:15:00.271Z"
}