Pine LabsDOCS
Create Account

API Playground

Test Pine Labs API endpoints with real requests. All endpoints are loaded dynamically from the OpenAPI specification.

Send Subscription Notification

Sends a pre-debit notification for a subscription. This is used when the merchant controls the PDN (Pre-Debit Notification) process.

POSThttps://pluraluat.v2.pinepg.in/ps/api/v1/public/subscriptions/notify
Required
Request Body (editable JSON)
Request Body Schemarequired
FieldDetails
subscription_id
stringrequired

Unique identifier for the subscription.

due_date
stringrequireddate-time

The ISO 8601 UTC Timestamp when the payment is due.

amount
objectrequired2 nested fields

This is the recurring mandate amount, that would be charged for each frequency. For instance 200 every month. This field is not needed if the mandate frequency is AS

value
integerrequired

Amount in the smallest currency unit (paisa for INR). Minimum ₹1 (100), maximum ₹10 lakh (100000000).

Constraints
Minimum value: 100Maximum value: 100000000
currency
stringrequired

Three-letter ISO 4217 currency code.

Constraints
Default value: INR
merchant_presentation_reference
stringrequired

**Idempotency Key.** Unique identifier of the merchant presentation reference. Duplicate requests with the same `merchant_presentation_reference` will return the existing presentation instead of creating a new one.

Constraints
Minimum length: 1 characterMaximum length: 50 characters
is_merchant_retry
boolean

Indicates whether the merchant controls the retry process.