Pine LabsDOCS

Create Presentation

POST/ps/api/v1/public/subscriptions/{subscription_id}/presentations

Creates a new presentation (mandate debit request) against an active subscription. Presentations represent scheduled debit requests raised against a customer mandate.

Requires Bearer token. Get token →

Path Parameters

NameTypeDescription
subscription_id
stringrequired

Unique identifier for the subscription.

Request Body

NameTypeDescription
subscription_id
string

Unique identifier for the subscription.

due_date
string

The ISO 8601 UTC Timestamp when the payment is due.

amount
object

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).

currency
stringrequired

Three-letter ISO 4217 currency code.

merchant_presentation_reference
string

Unique identifier of the merchant presentation reference.

Status Codes

201Presentation created successfully.
500An unexpected error occurred on the server.
Request
curl --request POST \
  --url https://pluraluat.v2.pinepg.in/ps/api/v1/public/subscriptions/%7Bsubscription_id%7D/presentations \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "subscription_id": "v1-sub-250612062122-aa-3HLXL5",
  "due_date": "2025-06-05T06:14:21Z",
  "amount": {
    "value": 1000,
    "currency": "INR"
  },
  "merchant_presentation_reference": "9caa061f-0e50-494b-aa13-8e902b0bef03"
}'

Run this request

subscription_id
201 Created
{
  "subscription_id": "v1-sub-250612062122-aa-3HLXL5",
  "presentation_id": "v1-bil-250612063111-aa-FJIBcB",
  "due_date": "2025-06-05T06:14:21.72036Z",
  "amount": {
    "value": 100,
    "currency": "INR"
  },
  "status": "CREATED",
  "merchant_presentation_reference": "9caa061f-0e50-494b-aa13-8e902b0bef03"
}