Pine LabsDOCS
Create Account

Create a Subscription 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.

View as MarkdownOpen in ChatGPTOpen in ClaudeOpen in Perplexity
Requires Bearer token. Get token →

Path Parameters

FieldDetails
subscription_id
stringrequired

Unique identifier for the subscription.

Constraints
Maximum length: 50 characters

Header Parameters

FieldDetails
Request-Timestamp
stringdate-time

ISO 8601 UTC timestamp of the request. Used for idempotency and audit.

Request-ID
string

Use a global unique identifier [GUID] for the request.

Constraints
Minimum length: 1 characterMaximum length: 50 characters

Request Bodyrequired

FieldDetails
subscription_id
string

Unique identifier for the subscription.

due_date
stringdate-time

The ISO 8601 UTC Timestamp when the payment is due.

amount
object2 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

merchant_presentation_reference
string

Unique identifier of the merchant presentation reference.

Constraints
Minimum length: 1 characterMaximum length: 50 characters

Status Codes

201Presentation created successfully.
500An unexpected error occurred on the server.
Run
Request
curl --request POST \
  --url https://pluraluat.v2.pinepg.in/ps/api/v1/public/subscriptions/v1-sub-250612062122-aa-3HLXL5/presentations \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z' \
  --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"
}'
{
  "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"
}