Get Presentation by Merchant Presentation Reference

GET/ps/api/v1/public/presentations/reference/{merchant_presentation_reference}

Retrieves a specific presentation by the merchant presentation reference.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Name	Type	Description
`merchant_presentation_reference`	`string`required	Unique identifier of the merchant presentation reference.

Response

Name	Type	Description
`subscription_id`	`string`	Unique identifier for the subscription.
`presentation_id`	`string`	Unique identifier for the presentation.
`due_date`	`string`	The ISO 8601 UTC Timestamp when the payment is due.
`amount`	`object`	Monetary amount with currency for subscription-related APIs.
`value`	`integer`required	Amount in the smallest currency unit (paisa for INR). Minimum ₹1 (100), maximum ₹10 lakh (100000000).
`currency`	`string`required	Three-letter ISO 4217 currency code.
`merchant_presentation_reference`	`string`	Unique identifier of the merchant presentation reference.
`pdn_status`	`CREATED \| INITIATED \| NOTIFIED \| FAILED \| CANCELLED \| PAUSED \| PDN_FAILED`	Pre-debit notification status. CREATED: Pine Labs received the pre-debit notification request. INITIATED: Pre-debit notification request sent to the Bank. NOTIFIED: Notification delivered successfully. FAILED: Notification delivery attempt unsuccessful. CANCELLED: Notification stopped before completion. PAUSED: Notification temporarily halted. PDN_FAILED: Pre-debit notification failed after all retry attempts. `CREATEDINITIATEDNOTIFIEDFAILEDCANCELLEDPAUSEDPDN_FAILED`
`status`	`CREATED \| PENDING \| COMPLETED \| FAILED \| CANCELLED \| PAUSED \| PARTIALLY_REFUNDED \| REFUNDED \| INITIATED`	Presentation status. CREATED: Customer Debit request received. PENDING: Debit request sent to Bank, awaiting response. COMPLETED: Debit successfully received. FAILED: Debit request unsuccessful. CANCELLED: Cancel Subscription request received. PAUSED: Pause subscription request received. PARTIALLY_REFUNDED: Partial refund successful. REFUNDED: Full refund successful. INITIATED: Debit request initiated. `CREATEDPENDINGCOMPLETEDFAILEDCANCELLEDPAUSEDPARTIALLY_REFUNDEDREFUNDEDINITIATED`
`failure_count`	`integer`	The number of times the requests to execute mandates at banks have failed.
`order_id`	`string`	Unique identifier of the order created for this presentation.

Status Codes

`200`	Presentation retrieved successfully.
`400`

Request

curl --request GET \
  --url https://pluraluat.v2.pinepg.in/ps/api/v1/public/presentations/reference/%7Bmerchant_presentation_reference%7D \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Run this request

Bearer token

Path parameters

merchant_presentation_reference

200 OK

{
  "subscription_id": "v1-sub-250911093342-aa-v9YH7S",
  "presentation_id": "v1-bil-250911093822-aa-i37gSm",
  "due_date": "2025-09-12T18:00:00Z",
  "amount": {
    "value": 1000,
    "currency": "INR"
  },
  "merchant_presentation_reference": "z1B3pu003",
  "pdn_status": "NOTIFIED",
  "status": "PENDING",
  "failure_count": 0,
  "order_id": "v1-260210121553-aa-8Y4x1I"
}