Skip to main content
Card subscriptions let you collect recurring payments from customers using card-based subscription mandates. This guide walks through how to create a card subscription where the mandate is created using the customer’s card details.

Create Subscription

Create a card subscription order with standing instruction

3D Secure Auth

Handle 3D Secure authentication for card mandates

​
Prerequisites

Before you begin, ensure you have:
  • Credentials: Your Client ID and Client Secret
  • Domain Whitelist: Whitelisted your website domain for integration
  • Webhook URL: A secure endpoint to receive payment status updates
  • Server environment: Ability to make HTTPS POST and GET requests from your backend.
  • JSON & HTTP Client: Familiarity with JSON request bodies and HTTP client libraries.

​
Create Subscription

Use the Card Flow to create subscriptions using the customer’s card details. The request is sent from your server to EximPe with the required transaction parameters. Card-based subscriptions use mop_type CREDIT_CARD and require card_details (card number, cardholder name, expiry, CVV, network, and optional nickname).

​
Sample Request

curl -X POST https://api-pacb.eximpe.com/pg/subscriptions/card/ \
  -H "Content-Type: application/json" \
  -H "X-Client-ID: <your-client-id>" \
  -H "X-Client-Secret: <your-client-secret>" \
  -H "X-Merchant-ID: <your-merchant-id>" \
  -H "X-API-Version: 1.0.0" \
  -d '{
    "amount": "1000.00",
    "collection_mode": "s2s",
    "currency": "INR",
    "reference_id": "SUBM6FLMZ",
    "buyer": {
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "+919876543210",
        "address": {
            "line_1": "123 Main Street",
            "line_2": "Apt 4B",
            "city": "Mumbai",
            "state": "Maharashtra",
            "postal_code": "400001"
        },
        "ip_address": "192.168.1.100",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
    },
    "product": {
        "name": "Monthly Subscription Plan",
        "description": "Monthly subscription for premium services",
        "hs_code": "98051000",
        "hs_code_description": "Subscription services",
        "type_of_goods": "service"
    },
    "invoice": {
        "number": "INVLA0BYZ",
        "date": "2026-03-14"
    },
    "standing_instruction": {
        "billing_amount": "1000.00",
        "billing_currency": "INR",
        "billing_cycle": "MONTHLY",
        "billing_interval": 1,
        "payment_start_date": "2026-04-14",
        "payment_end_date": "2027-04-14",
        "billing_date": 1,
        "remarks": "Monthly subscription for premium services"
    },
    "mop_type": "CREDIT_CARD",
    "card_details": {
        "number": "4111111111111111",
        "cardholder_name": "John Doe",
        "expiry_month": 12,
        "expiry_year": 2029,
        "cvv": "123",
        "network": "VISA",
        "nickname": "My Credit Card"
    }
}'

​
Response

{
  "success": true,
  "message": "Card Subscription created successfully",
  "data": {
    "order_id": "OD7468644660",
    "subscription_type": "CARD_RECURRING",
    "message": "Card Subscription consent transaction created",
    "acstemplate": "PGh0bWw+PGJvZHk+PGZvcm0g...",
    "subscription_id": "SUB4109986375",
    "subscription": {
      "billing_cycle": "MONTHLY",
      "billing_interval": 1,
      "payment_start_date": "2026-04-14",
      "payment_end_date": "2027-04-14",
      "status": "PENDING"
    }
  }
}

​
3D Secure Authentication

3D Secure Authentication: Card-based subscriptions may require 3D Secure authentication. If the response includes an acstemplate, render it on the client side (e.g. in an iframe or new window) to complete the authentication process before the subscription mandate becomes active.

​
Next Steps

Once the subscription is created, proceed to Manage Subscriptions to check mandate status, trigger recurring payments, modify or cancel mandates, and view payment history. For full request and response schema, see the Create Card Subscription endpoint in API Reference.